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

Mike Frysinger <[email protected]>
Newsgroups gmane.comp.lib.newlib
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.