[PATCH v5 3/3] manual: Replace summary.awk with summary.pl.

[Rical Jasan]

This commit returns the build to a working state.  The Summary is now
generated from @standards, and syntax-checking is performed.  If
invalid @standards syntax is detected, summary.pl will fail, reporting
all errors.  Failure and error reporting is disabled for now, however,
since much of the manual is still incomplete wrt. header and standards
annotations.

Note that the sorting order of the Summary has changed; summary.pl
respects the locale, like summary.awk did, but the use of LC_ALL=C is
introduced in the Makefile.  Other notable deviations are improved
detection of the annotated elements' names, which are used for
sorting, and improved detection of the @node used to reference into
the manual.  The most noticeable difference in the rendered Summary is
that entries may now contain multiple lines, one for each header and
standard combination.

summary.pl accepts a `--help' option, which details the expected
syntax of @standards.  If errors are reported, the user is directed to
this feature for further information.

	* manual/Makefile: Generate summary.texi with summary.pl.
	Force use of the C locale.
	* manual/header.texi: Update reference to summary.awk.
	* manual/macros.texi: Refer authors to `summary.pl --help'.
	* manual/summary.awk: Remove file.
	* manual/summary.pl: New file.  Generate summary.texi, and
	check for @standards-related syntax errors.
---
 manual/Makefile    |   7 +-
 manual/header.texi |   2 +-
 manual/macros.texi |   1 +
 manual/summary.awk | 133 ------------------
 manual/summary.pl  | 403 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 408 insertions(+), 138 deletions(-)
 delete mode 100644 manual/summary.awk
 create mode 100755 manual/summary.pl

-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0003-manual-Replace-summary.awk-with-summary.pl.patch
Type: text/x-patch
Size: 19697 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/libc-alpha/attachments/20170526/19040642/attachment.bin>