smtp: use the upload buffer size for scratch buffer malloc
[platform/upstream/curl.git] / docs / Makefile.am
index 75323ec..1cad062 100644 (file)
@@ -1,32 +1,86 @@
+#***************************************************************************
+#                                  _   _ ____  _
+#  Project                     ___| | | |  _ \| |
+#                             / __| | | | |_) | |
+#                            | (__| |_| |  _ <| |___
+#                             \___|\___/|_| \_\_____|
 #
-# $Id$
+# Copyright (C) 1998 - 2018, 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.haxx.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.
+#
+###########################################################################
 
 AUTOMAKE_OPTIONS = foreign no-dependencies
 
-man_MANS = \
-       curl.1 \
-       curl-config.1
+# EXTRA_DIST breaks with $(abs_builddir) so build it using this variable
+# but distribute it (using the relative file name) in the next variable
+man_MANS = $(abs_builddir)/curl.1
+noinst_man_MANS = curl.1 mk-ca-bundle.1
+dist_man_MANS = curl-config.1
+GENHTMLPAGES = curl.html curl-config.html mk-ca-bundle.html
+PDFPAGES = curl.pdf curl-config.pdf mk-ca-bundle.pdf
+MANDISTPAGES = curl.1.dist curl-config.1.dist
+
+HTMLPAGES = $(GENHTMLPAGES) index.html
+
+# Build targets in this file (.) before cmdline-opts to ensure that
+# the curl.1 rule below runs first
+SUBDIRS = . cmdline-opts
+DIST_SUBDIRS = $(SUBDIRS) examples libcurl
 
-HTMLPAGES = \
-       curl.html \
-       curl-config.html
+CLEANFILES = $(GENHTMLPAGES) $(PDFPAGES) $(MANDISTPAGES) curl.1
 
-SUBDIRS = examples libcurl
+EXTRA_DIST = MANUAL BUGS CONTRIBUTE.md FAQ FEATURES INTERNALS.md SSLCERTS.md    \
+ README.win32 RESOURCES TODO TheArtOfHttpScripting THANKS VERSIONS KNOWN_BUGS   \
+ BINDINGS.md HISTORY.md INSTALL INSTALL.md LICENSE-MIXING.md     \
+ README.netware MAIL-ETIQUETTE HTTP-COOKIES.md SECURITY-PROCESS.md RELEASE-PROCEDURE    \
+ SSL-PROBLEMS.md HTTP2.md ROADMAP.md CODE_OF_CONDUCT.md CODE_STYLE.md           \
+ CHECKSRC.md CMakeLists.txt README.md CIPHERS.md INSTALL.cmake README.cmake     \
+ $(noinst_man_MANS) HELP-US.md
 
-EXTRA_DIST = MANUAL BUGS CONTRIBUTE FAQ FEATURES INTERNALS             \
-            README.win32 RESOURCES TODO TheArtOfHttpScripting THANKS   \
-            VERSIONS $(man_MANS) $(HTMLPAGES)
+MAN2HTML= roffit $< >$@
 
-MAN2HTML= gnroff -man $< | man2html >$@
+SUFFIXES = .1 .html .pdf
 
-SUFFIXES = .1 .3 .html
+# $(abs_builddir) is to disable VPATH when searching for this file, which
+# would otherwise find the copy in $(srcdir) which breaks the $(HUGE)
+# rule in src/Makefile.am in out-of-tree builds that references the file in the
+# build directory.
+#
+# First, seed the used copy of curl.1 with the prebuilt copy (in an out-of-tree
+# build), then run make recursively to rebuild it only if its dependencies
+# have changed.
+$(abs_builddir)/curl.1:
+       if test "$(top_builddir)x" != "$(top_srcdir)x" -a -e "$(srcdir)/curl.1"; then \
+               cp -fp "$(srcdir)/curl.1" $@; fi
+       cd cmdline-opts && $(MAKE)
 
 html: $(HTMLPAGES)
-       cd libcurl; make html
+       cd libcurl && $(MAKE) html
 
-.3.html:
-       $(MAN2HTML)
+pdf: $(PDFPAGES)
+       cd libcurl && $(MAKE) pdf
 
 .1.html:
        $(MAN2HTML)
+
+.1.pdf:
+       @(foo=`echo $@ | sed -e 's/\.[0-9]$$//g'`; \
+       groff -Tps -man $< >$$foo.ps; \
+       ps2pdf $$foo.ps $@; \
+       rm $$foo.ps; \
+       echo "converted $< to $@")
+
+distclean:
+       rm -f $(CLEANFILES)
+