mirror of
https://github.com/curl/curl.git
synced 2024-12-27 06:59:43 +08:00
f03c85635f
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
122 lines
4.4 KiB
Makefile
122 lines
4.4 KiB
Makefile
#***************************************************************************
|
|
# _ _ ____ _
|
|
# Project ___| | | | _ \| |
|
|
# / __| | | | |_) | |
|
|
# | (__| |_| | _ <| |___
|
|
# \___|\___/|_| \_\_____|
|
|
#
|
|
# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
#
|
|
# This software is licensed as described in the file COPYING, which
|
|
# you should have received as part of this distribution. The terms
|
|
# are also available at https://curl.se/docs/copyright.html.
|
|
#
|
|
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
# copies of the Software, and permit persons to whom the Software is
|
|
# furnished to do so, under the terms of the COPYING file.
|
|
#
|
|
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
# KIND, either express or implied.
|
|
#
|
|
# SPDX-License-Identifier: curl
|
|
#
|
|
###########################################################################
|
|
|
|
AUTOMAKE_OPTIONS = foreign no-dependencies
|
|
|
|
if BUILD_DOCS
|
|
# if we disable man page building, ignore these
|
|
MK_CA_DOCS = mk-ca-bundle.1
|
|
CURLCONF_DOCS = curl-config.1
|
|
endif
|
|
|
|
man_MANS = curl-config.1
|
|
CURLPAGES = curl-config.md mk-ca-bundle.md
|
|
|
|
SUBDIRS = . cmdline-opts libcurl
|
|
DIST_SUBDIRS = $(SUBDIRS) examples
|
|
|
|
if BUILD_DOCS
|
|
CLEANFILES = mk-ca-bundle.1 curl-config.1
|
|
endif
|
|
|
|
EXTRA_DIST = \
|
|
$(CURLPAGES) \
|
|
$(CURLCONF_DOCS) \
|
|
ALTSVC.md \
|
|
BINDINGS.md \
|
|
BUFREF.md \
|
|
BUG-BOUNTY.md \
|
|
BUGS.md \
|
|
CHECKSRC.md \
|
|
CIPHERS.md \
|
|
CMakeLists.txt \
|
|
CODE_OF_CONDUCT.md \
|
|
CODE_REVIEW.md \
|
|
CODE_STYLE.md \
|
|
CLIENT-READERS.md \
|
|
CLIENT-WRITERS.md \
|
|
CONNECTION-FILTERS.md \
|
|
CONTRIBUTE.md \
|
|
CURL-DISABLE.md \
|
|
CURLDOWN.md \
|
|
DEPRECATE.md \
|
|
DYNBUF.md \
|
|
EARLY-RELEASE.md \
|
|
EXPERIMENTAL.md \
|
|
FAQ \
|
|
FEATURES.md \
|
|
GOVERNANCE.md \
|
|
HELP-US.md \
|
|
HISTORY.md \
|
|
HSTS.md \
|
|
HTTP-COOKIES.md \
|
|
HTTP2.md \
|
|
HTTP3.md \
|
|
HYPER.md \
|
|
INSTALL \
|
|
INSTALL-CMAKE.md \
|
|
INSTALL.md \
|
|
INTERNALS.md \
|
|
KNOWN_BUGS \
|
|
MAIL-ETIQUETTE \
|
|
MQTT.md \
|
|
NEW-PROTOCOL.md \
|
|
options-in-versions \
|
|
PARALLEL-TRANSFERS.md \
|
|
README.md \
|
|
RELEASE-PROCEDURE.md \
|
|
RUSTLS.md \
|
|
ROADMAP.md \
|
|
SECURITY-ADVISORY.md \
|
|
SSL-PROBLEMS.md \
|
|
SSLCERTS.md \
|
|
THANKS \
|
|
TODO \
|
|
TheArtOfHttpScripting.md \
|
|
URL-SYNTAX.md \
|
|
VERSIONS.md \
|
|
VULN-DISCLOSURE-POLICY.md \
|
|
WEBSOCKET.md
|
|
|
|
CD2NROFF = $(top_srcdir)/scripts/cd2nroff $< >$@
|
|
|
|
CD2 = $(CD2_$(V))
|
|
CD2_0 = @echo " RENDER " $@;
|
|
CD2_1 =
|
|
CD2_ = $(CD2_0)
|
|
|
|
SUFFIXES = .1 .md
|
|
|
|
all: $(MK_CA_DOCS)
|
|
|
|
.md.1:
|
|
$(CD2)$(CD2NROFF)
|
|
|
|
curl-config.1: curl-config.md
|
|
|
|
mk-ca-bundle.1: mk-ca-bundle.md
|
|
|
|
distclean:
|
|
rm -f $(CLEANFILES)
|