[PATCH 0/5] migrate documentation into top-level

Mike Frysinger vapier@gentoo.org
Sat Jan 22 04:32:03 GMT 2022


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



More information about the Newlib mailing list