docs: ascii version of manpage without nroff

Create ASCII version of manpage without nroff

 - build src/tool_hugegelp.c from the ascii manpage
 - move the the manpage and the ascii version build to docs/cmdline-opts
 - remove all use of nroff from the build process
 - should make the build entirely reproducible (by avoiding nroff)

 - partly reverts 2620aa9 to build libcurl option man pages one by one
   in cmake because the appveyor builds got all crazy until I did

The ASCII version of the manpage

 - is built with gen.pl, just like the manpage is
 - has a right-justified column making the appearance similar to the previous
   version
 - uses a 4-space indent per level (instead of the old version's 7)
 - does not do hyphenation of words (which nroff does)

History

  We first made the curl build use nroff for building the hugehelp file in
  December 1998, for curl 5.2.

Closes #13047
This commit is contained in:
Daniel Stenberg 2024-03-04 17:22:17 +01:00
parent 9978d40ddb
commit f03c85635f
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
22 changed files with 280 additions and 257 deletions

View file

@ -77,3 +77,6 @@ if USE_FISH_COMPLETION
fi
endif
endif
distclean:
rm -f $(CLEANFILES)

View file

@ -113,7 +113,7 @@ sub single {
if(defined($f)) {
if(!open($fh, "<:crlf", "$f")) {
print STDERR "Failed to open $f : $!\n";
print STDERR "cd2nroff failed to open '$f' for reading: $!\n";
return 1;
}
}