mirror of
https://github.com/curl/curl.git
synced 2026-07-12 09:47:16 +03:00
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
44 lines
1.3 KiB
Text
44 lines
1.3 KiB
Text
_ _ ____ _
|
|
___| | | | _ \| |
|
|
/ __| | | | |_) | |
|
|
| (__| |_| | _ <| |___
|
|
\___|\___/|_| \_\_____|
|
|
|
|
GIT-INFO
|
|
|
|
This file is only present in git - never in release archives. It contains
|
|
information about other files and things that the git repository keeps in its
|
|
inner sanctum.
|
|
|
|
To build in environments that support configure, after having extracted
|
|
everything from git, do this:
|
|
|
|
autoreconf -fi
|
|
./configure --with-openssl
|
|
make
|
|
|
|
Daniel uses a ./configure line similar to this for easier development:
|
|
|
|
./configure --disable-shared --enable-debug --enable-maintainer-mode
|
|
|
|
In environments that don't support configure (i.e. Microsoft), do this:
|
|
|
|
buildconf.bat
|
|
|
|
|
|
REQUIREMENTS
|
|
|
|
For autoreconf and configure (not buildconf.bat) to work, you need the
|
|
following software installed:
|
|
|
|
o autoconf 2.57 (or later)
|
|
o automake 1.7 (or later)
|
|
o libtool 1.4.2 (or later)
|
|
o GNU m4 (required by autoconf)
|
|
|
|
o perl
|
|
|
|
If you don't have perl and don't want to install it, you can rename the
|
|
source file src/tool_hugehelp.c.cvs to src/tool_hugehelp.c and avoid having
|
|
to generate this file. This will give you a stubbed version of the file
|
|
that doesn't contain actual content.
|