From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) by sourceware.org (Postfix) with ESMTP id CD5E63858C60 for ; Sat, 22 Jan 2022 04:32:07 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org CD5E63858C60 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gentoo.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gentoo.org Received: by smtp.gentoo.org (Postfix, from userid 559) id 48F09343569; Sat, 22 Jan 2022 04:32:07 +0000 (UTC) From: Mike Frysinger To: newlib@sourceware.org Subject: [PATCH 0/5] migrate documentation into top-level Date: Fri, 21 Jan 2022 23:32:03 -0500 Message-Id: <20220122043208.21962-1-vapier@gentoo.org> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=4.4 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, SPF_HELO_PASS, SPF_PASS, TXREP, UNWANTED_LANGUAGE_BODY autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Level: **** X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: newlib@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Newlib mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 22 Jan 2022 04:32:12 -0000 The current documentation build rules are spread through out the tree. I don't mean the subdirs declaring their chapters & source files (that is a good thing), I mean the rules that actually transform & accumulate to produce final texi/info/pdf & docbook/man pages. This means when we build them, we have to run recursive make to build each subpiece before having a higher level try and accumulate them. The TARGETDOC rules in particular are a bit dicey as multiple subdirs write to the same file. The end result has the nice properties: * Fewer lines (final delta is like -2.5k) * Fewer recursive subdirs * Can build all the docs in parallel from the top-level * Can generate stable documentation regardless of configure settings This is one small but critical step in killing off subdirs entirely. Mike Frysinger (5): newlib: libm: move manual into top-level build newlib: libc: include all chapters all the time in the manual newlib: libc: move manual into top-level build newlib: move man page generation into top-level build newlib: drop shared documentation rules newlib/Makefile.am | 26 +- newlib/Makefile.in | 726 ++++++++++++++++-- newlib/Makefile.shared | 36 - newlib/doc/local.mk | 23 + newlib/libc/Makefile.am | 119 +-- newlib/libc/Makefile.in | 500 +----------- newlib/libc/argz/Makefile.am | 4 - newlib/libc/argz/Makefile.in | 43 +- newlib/libc/configure | 24 +- newlib/libc/configure.ac | 15 - newlib/libc/ctype/Makefile.am | 37 - newlib/libc/ctype/Makefile.in | 76 +- newlib/libc/ctype/local.mk | 36 + newlib/libc/errno/Makefile.am | 4 - newlib/libc/errno/Makefile.in | 43 +- newlib/libc/iconv/Makefile.am | 24 - newlib/libc/iconv/Makefile.in | 61 -- newlib/libc/iconv/ccs/Makefile.am | 3 - newlib/libc/iconv/ccs/Makefile.in | 42 +- newlib/libc/iconv/ccs/binary/Makefile.in | 39 - newlib/libc/iconv/ces/Makefile.am | 3 - newlib/libc/iconv/ces/Makefile.in | 42 +- newlib/libc/iconv/iconv.tex | 2 +- newlib/libc/iconv/lib/Makefile.am | 3 - newlib/libc/iconv/lib/Makefile.in | 42 +- newlib/libc/iconv/lib/local.mk | 1 + newlib/libc/iconv/local.mk | 3 + newlib/libc/libc.texi | 18 - newlib/libc/local.mk | 53 ++ newlib/libc/locale/Makefile.am | 9 - newlib/libc/locale/Makefile.in | 48 +- newlib/libc/locale/local.mk | 8 + newlib/libc/machine/Makefile.am | 4 - newlib/libc/machine/Makefile.in | 4 - newlib/libc/machine/i386/Makefile.in | 35 +- newlib/libc/misc/Makefile.am | 3 - newlib/libc/misc/Makefile.in | 42 +- newlib/libc/misc/local.mk | 6 + newlib/libc/posix/Makefile.am | 6 - newlib/libc/posix/Makefile.in | 45 +- newlib/libc/posix/local.mk | 5 + newlib/libc/reent/Makefile.am | 26 - newlib/libc/reent/Makefile.in | 65 +- newlib/libc/reent/local.mk | 25 + newlib/libc/search/Makefile.am | 7 - newlib/libc/search/Makefile.in | 46 +- newlib/libc/search/local.mk | 4 + newlib/libc/signal/Makefile.am | 4 - newlib/libc/signal/Makefile.in | 42 +- newlib/libc/signal/local.mk | 7 + newlib/libc/ssp/Makefile.am | 3 - newlib/libc/ssp/Makefile.in | 42 +- newlib/libc/ssp/local.mk | 3 + newlib/libc/stdio/Makefile.am | 464 +++++------ newlib/libc/stdio/Makefile.in | 120 +-- newlib/libc/stdio/local.mk | 80 ++ newlib/libc/stdio64/Makefile.am | 12 - newlib/libc/stdio64/Makefile.in | 51 +- newlib/libc/stdio64/local.mk | 11 + newlib/libc/stdlib/Makefile.am | 52 -- newlib/libc/stdlib/Makefile.in | 91 +-- newlib/libc/stdlib/local.mk | 51 ++ newlib/libc/string/Makefile.am | 23 - newlib/libc/string/Makefile.in | 62 +- newlib/libc/string/local.mk | 22 + newlib/libc/sys/Makefile.am | 4 - newlib/libc/sys/Makefile.in | 4 - newlib/libc/sys/linux/argp/Makefile.in | 35 +- newlib/libc/sys/linux/cmath/Makefile.in | 35 +- newlib/libc/sys/linux/dl/Makefile.in | 35 +- newlib/libc/sys/linux/iconv/Makefile.in | 35 +- newlib/libc/sys/linux/intl/Makefile.in | 35 +- .../libc/sys/linux/linuxthreads/Makefile.in | 35 +- .../linuxthreads/machine/i386/Makefile.in | 35 +- .../libc/sys/linux/machine/i386/Makefile.in | 35 +- newlib/libc/sys/linux/net/Makefile.in | 35 +- newlib/libc/syscalls/Makefile.am | 4 - newlib/libc/syscalls/Makefile.in | 43 +- newlib/libc/time/Makefile.am | 16 - newlib/libc/time/Makefile.in | 55 +- newlib/libc/time/local.mk | 15 + newlib/libc/unix/Makefile.am | 4 - newlib/libc/unix/Makefile.in | 43 +- newlib/libc/xdr/Makefile.am | 4 - newlib/libc/xdr/Makefile.in | 43 +- newlib/libm/Makefile.am | 47 -- newlib/libm/Makefile.in | 420 +--------- newlib/libm/common/Makefile.am | 10 - newlib/libm/common/Makefile.in | 44 +- newlib/libm/common/local.mk | 10 + newlib/libm/complex/Makefile.am | 8 - newlib/libm/complex/Makefile.in | 42 +- newlib/libm/complex/local.mk | 8 + newlib/libm/fenv/Makefile.am | 7 - newlib/libm/fenv/Makefile.in | 41 +- newlib/libm/fenv/local.mk | 7 + newlib/libm/local.mk | 47 ++ newlib/libm/machine/Makefile.am | 4 - newlib/libm/machine/Makefile.in | 4 - newlib/libm/machine/aarch64/Makefile.in | 35 +- newlib/libm/machine/arm/Makefile.in | 35 +- newlib/libm/machine/i386/Makefile.in | 35 +- newlib/libm/machine/mips/Makefile.in | 35 +- newlib/libm/machine/nds32/Makefile.in | 35 +- newlib/libm/machine/powerpc/Makefile.in | 35 +- newlib/libm/machine/pru/Makefile.in | 35 +- newlib/libm/machine/riscv/Makefile.in | 35 +- newlib/libm/machine/sparc/Makefile.in | 35 +- newlib/libm/machine/spu/Makefile.in | 35 +- newlib/libm/machine/x86_64/Makefile.in | 35 +- newlib/libm/math/Makefile.am | 11 - newlib/libm/math/Makefile.in | 45 +- newlib/libm/math/local.mk | 11 + newlib/libm/mathfp/Makefile.am | 31 - newlib/libm/mathfp/Makefile.in | 65 +- newlib/libm/mathfp/local.mk | 31 + 116 files changed, 1463 insertions(+), 3941 deletions(-) create mode 100644 newlib/libc/ctype/local.mk create mode 100644 newlib/libc/iconv/lib/local.mk create mode 100644 newlib/libc/iconv/local.mk create mode 100644 newlib/libc/local.mk create mode 100644 newlib/libc/locale/local.mk create mode 100644 newlib/libc/misc/local.mk create mode 100644 newlib/libc/posix/local.mk create mode 100644 newlib/libc/reent/local.mk create mode 100644 newlib/libc/search/local.mk create mode 100644 newlib/libc/signal/local.mk create mode 100644 newlib/libc/ssp/local.mk create mode 100644 newlib/libc/stdio/local.mk create mode 100644 newlib/libc/stdio64/local.mk create mode 100644 newlib/libc/stdlib/local.mk create mode 100644 newlib/libc/string/local.mk create mode 100644 newlib/libc/time/local.mk create mode 100644 newlib/libm/common/local.mk create mode 100644 newlib/libm/complex/local.mk create mode 100644 newlib/libm/fenv/local.mk create mode 100644 newlib/libm/local.mk create mode 100644 newlib/libm/math/local.mk create mode 100644 newlib/libm/mathfp/local.mk -- 2.34.1