Add doc comment on use of forany.
[users/jgh/exim.git] / doc / doc-docbook / OS-Fixups
1 #!/usr/bin/perl -w
2
3 use strict;
4
5 # Script to hack around xsl:import paths; ideally, the system catalogs are used.
6 # Let every OS define its own manipulations.
7 # Uses the Perl $^O values to identify the current OS.
8 #
9 # Define filter_$^O to do substitutions, will be called for every line of
10 # every .xsl file.
11
12 sub filter_freebsd
13 {
14 s{"http://docbook.sourceforge.net/release/xsl/current/}
15  {"/usr/local/share/xsl/docbook/};
16 s{"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"}
17  {"/usr/local/share/xml/docbook/4.2/docbookx.dtd"};
18 }
19
20 sub filter_linux
21 {
22 # SUSE 10 with extra pkgs
23 s{"http://docbook.sourceforge.net/release/xsl/current/}
24  {"/usr/share/xml/docbook/stylesheet/nwalsh/1.71.1/};
25 s{"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"}
26  {"/usr/share/xml/docbook/schema/dtd/4.2/docbookx.dtd"};
27 }
28
29 sub filter_darwin
30 {
31 # NB - this uses the Mac Ports installations
32 s{"http://docbook.sourceforge.net/release/xsl/current/}
33  {"/opt/local/share/xsl/docbook-xsl/};
34 s{"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"}
35  {"/opt/local/share/xml/docbook/4.2/docbookx.dtd"};
36 }
37
38
39 # Define OS filters above.
40
41 my $os_filter;
42 $os_filter = $main::{"filter_$^O"} if exists $main::{"filter_$^O"};
43
44 unless (defined $os_filter)
45   {
46   print "No changes defined for your OS ($^O).\n";
47   exit 0;
48   }
49
50 for my $fn (<*.xsl>, <*.xml>)
51   {
52   my $orig = "$fn.orig";
53   rename($fn, $orig) or die "Failed to rename($fn, $orig): $!\n";
54   # Most portable is two-argument form, and none of our filenames are
55   # untrusted or contain whitespace.
56   open(OLD, "< $orig") or die "Failed to read-open($orig): $!\n";
57   open(NEW, "> $fn") or die "Failed to write-open($fn): $!\n";
58   while (<OLD>)
59     {
60     $os_filter->();
61     print NEW $_ or die "Write to \"$fn\" failed: $!\n";
62     }
63   close(NEW) or die "Failed to close($fn) after writing: $!\n";
64   close(OLD);
65   }