public inbox for newlib@sourceware.org
 help / color / mirror / Atom feed
* [PATCH 0/5] migrate documentation into top-level
@ 2022-01-22  4:32 Mike Frysinger
  2022-01-22  4:32 ` [PATCH 1/5] newlib: libm: move manual into top-level build Mike Frysinger
                   ` (6 more replies)
  0 siblings, 7 replies; 25+ messages in thread
From: Mike Frysinger @ 2022-01-22  4:32 UTC (permalink / raw)
  To: newlib

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


^ permalink raw reply	[flat|nested] 25+ messages in thread

end of thread, other threads:[~2022-02-07 10:30 UTC | newest]

Thread overview: 25+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-22  4:32 [PATCH 0/5] migrate documentation into top-level Mike Frysinger
2022-01-22  4:32 ` [PATCH 1/5] newlib: libm: move manual into top-level build Mike Frysinger
2022-01-22  4:32 ` [PATCH 2/5] newlib: libc: include all chapters all the time in the manual Mike Frysinger
2022-01-22  4:32 ` [PATCH 3/5] newlib: libc: move manual into top-level build Mike Frysinger
2022-01-24 14:30   ` Corinna Vinschen
2022-01-22  4:32 ` [PATCH 4/5] newlib: move man page generation " Mike Frysinger
2022-01-22  4:32 ` [PATCH 5/5] newlib: drop shared documentation rules Mike Frysinger
2022-01-28  7:58 ` [PATCH 1/5 v2] newlib: libm: move manual into top-level build Mike Frysinger
2022-01-28  7:58   ` [PATCH 2/5 v2] newlib: libc: include all chapters all the time in the manual Mike Frysinger
2022-01-28  7:58   ` [PATCH 3/5 v2] newlib: libc: move manual into top-level build Mike Frysinger
2022-01-28  7:58   ` [PATCH 4/5 v2] newlib: move man page generation " Mike Frysinger
2022-01-28  7:58   ` [PATCH 5/5 v2] newlib: drop shared documentation rules Mike Frysinger
2022-01-31 14:58   ` [PATCH 1/5 v2] newlib: libm: move manual into top-level build Jon Turney
2022-02-01  3:40     ` Mike Frysinger
2022-02-01 14:37       ` Jon Turney
2022-02-01  6:21 ` [PATCH 1/5 v3] " Mike Frysinger
2022-02-01  6:21   ` [PATCH 2/5 v3] newlib: libc: include all chapters all the time in the manual Mike Frysinger
2022-02-01  6:21   ` [PATCH 3/5 v3] newlib: libc: move manual into top-level build Mike Frysinger
2022-02-01  6:21   ` [PATCH 4/5 v3] newlib: move man page generation " Mike Frysinger
2022-02-01 14:37     ` Jon Turney
2022-02-01 23:12       ` Mike Frysinger
2022-02-01  6:21   ` [PATCH 5/5 v3] newlib: drop shared documentation rules Mike Frysinger
2022-02-05 12:13   ` [PATCH 1/5 v3] newlib: libm: move manual into top-level build Corinna Vinschen
2022-02-05 18:04     ` Mike Frysinger
2022-02-07 10:30       ` Corinna Vinschen

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).