mirror of
git://sourceware.org/git/glibc.git
synced 2024-12-21 04:31:04 +08:00
d08a7e4cbe
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. Update Perl dependency comment. * 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/argp.texi: Convert header and standards @comments to @standards. * manual/arith.texi: Likewise. * manual/charset.texi: Likewise. * manual/conf.texi: Likewise. * manual/creature.texi: Likewise. * manual/crypt.texi: Likewise. * manual/ctype.texi: Likewise. * manual/debug.texi: Likewise. * manual/errno.texi: Likewise. * manual/filesys.texi: Likewise. * manual/getopt.texi: Likewise. * manual/job.texi: Likewise. * manual/lang.texi: Likewise. * manual/llio.texi: Likewise. * manual/locale.texi: Likewise. * manual/math.texi: Likewise. * manual/memory.texi: Likewise. * manual/message.texi: Likewise. * manual/pattern.texi: Likewise. * manual/pipe.texi: Likewise. * manual/process.texi: Likewise. * manual/resource.texi: Likewise. * manual/search.texi: Likewise. * manual/setjmp.texi: Likewise. * manual/signal.texi: Likewise. * manual/socket.texi: Likewise. * manual/startup.texi: Likewise. * manual/stdio.texi: Likewise. * manual/string.texi: Likewise. * manual/sysinfo.texi: Likewise. * manual/syslog.texi: Likewise. * manual/terminal.texi: Likewise. * manual/threads.texi: Likewise. * manual/time.texi: Likewise. * manual/users.texi: Likewise.
23 lines
755 B
Plaintext
23 lines
755 B
Plaintext
@node Library Summary, Installation, Language Features, Top
|
|
@c %MENU% A summary showing the syntax, header file, and derivation of each library feature
|
|
@appendix Summary of Library Facilities
|
|
|
|
This appendix is a complete list of the facilities declared within the
|
|
header files supplied with @theglibc{}. Each entry also lists the
|
|
standard or other source from which each facility is derived, and tells
|
|
you where in the manual you can find more information about how to use
|
|
it.
|
|
|
|
@c This table runs wide. Shrink fonts.
|
|
@iftex
|
|
@smallfonts @rm
|
|
@end iftex
|
|
@table @code
|
|
@comment summary.texi is generated from the other Texinfo files.
|
|
@comment See the Makefile and summary.pl for the details.
|
|
@include summary.texi
|
|
@end table
|
|
@iftex
|
|
@textfonts @rm
|
|
@end iftex
|