diff options
-rwxr-xr-x | docs/cmdline-opts/gen.pl | 22 | ||||
-rw-r--r-- | docs/cmdline-opts/use-ascii.d | 2 |
2 files changed, 20 insertions, 4 deletions
diff --git a/docs/cmdline-opts/gen.pl b/docs/cmdline-opts/gen.pl index c8b129360..89a5df845 100755 --- a/docs/cmdline-opts/gen.pl +++ b/docs/cmdline-opts/gen.pl @@ -1,5 +1,21 @@ #!/usr/bin/perl +=begin comment + +This script generates the manpage. + +Example: gen.pl mainpage > curl.1 + +Dev notes: + +We open *input* files in :crlf translation (a no-op on many platforms) in +case we have CRLF line endings in Windows but a perl that defaults to LF. +Unfortunately it seems some perls like msysgit can't handle a global input-only +:crlf so it has to be specified on each file open for text input. + +=end comment +=cut + my $some_dir="."; opendir(my $dh, $some_dir) || die "Can't opendir $some_dir: $!"; @@ -85,7 +101,7 @@ sub added { sub single { my ($f, $standalone)=@_; - open(F, "<$f") || + open(F, "<:crlf", "$f") || return 1; my $short; my $long; @@ -219,7 +235,7 @@ sub single { sub getshortlong { my ($f)=@_; - open(F, "<$f"); + open(F, "<:crlf", "$f"); my $short; my $long; my $help; @@ -265,7 +281,7 @@ sub indexoptions { sub header { my ($f)=@_; - open(F, "<$f"); + open(F, "<:crlf", "$f"); my @d; while(<F>) { push @d, $_; diff --git a/docs/cmdline-opts/use-ascii.d b/docs/cmdline-opts/use-ascii.d index da307dc4d..d59fad922 100644 --- a/docs/cmdline-opts/use-ascii.d +++ b/docs/cmdline-opts/use-ascii.d @@ -3,6 +3,6 @@ Long: use-ascii Help: Use ASCII/text transfer Protocols: FTP LDAP --- -Enable ASCII transfer. For FTP, this can also be enforced by using an URL that +Enable ASCII transfer. For FTP, this can also be enforced by using a URL that ends with ";type=A". This option causes data sent to stdout to be in text mode for win32 systems. |