Put @node top next to @chapter, inside conditional.
[kopensolaris-gnu/glibc.git] / manual / libc.texinfo
1 \input texinfo                  @c -*- Texinfo -*-
2 @comment %**start of header (This is for running Texinfo on a region.)
3 @setfilename library.info
4 @settitle The GNU C Library
5 @setchapternewpage odd
6 @comment %**end of header (This is for running Texinfo on a region.)
7
8 @ifinfo
9 This file documents the GNU C library.
10
11 Copyright (C) 1992 Free Software Foundation, Inc.
12
13 This will be free information when it is finished, but isn't finished yet.
14 @end ifinfo
15
16 @setchapternewpage odd
17
18 @titlepage
19 @center @titlefont{The GNU C Library}
20 @sp 1
21 @center @titlefont{Reference Manual}
22 @sp 2
23 @center Sandra Loosemore
24 @center with
25 @center Roland McGrath, Andrew Oram, and Richard M. Stallman
26 @sp 3
27 @center last updated January 10, 1992
28 @sp 1
29 @center for version 0.00
30 @page
31 @vskip 0pt plus 1filll
32 Copyright @copyright{} 1992 Free Software Foundation, Inc.
33 @end titlepage
34 @page
35
36 @ifinfo
37 @node Top
38 @chapter Main Menu
39 This is the reference manual for version 0.00 of the GNU C Library.
40 @end ifinfo
41
42 @menu
43 Overview
44 * Introduction::                Purpose of the GNU C Library.
45 * Getting Started::             How this document is organized.
46 * Standards and Portability::   The functionality in the GNU C Library is
47                                  derived from various standards.
48 * Using the Library::           How to use the library facilities in
49                                  your programs.
50 * Roadmap to the Manual::       A short description of the contents of
51                                  each chapter of this manual.
52
53 Contents of the Library
54 * Error Reporting::                     How the GNU Library functions report
55                                          error conditions.
56 * Common Definitions::                  Things like @code{sizeof} and
57                                          @code{NULL}.
58 * Variable Argument Facilities::        How to process variable-length
59                                          argument lists.
60 * Memory Allocation::                   Your program can allocate memory
61                                          dynamically and manipulate it via
62                                          pointers.
63 * Character Handling::                  Character testing and conversion
64                                          functions.
65 * String and Array Utilities::          Utilities for copying and comparing
66                                          strings and arrays.
67 * Extended Characters::                 Support for extended character sets.
68 * Localization::                        The country and language can affect
69                                          the behavior of library functions.
70 * Searching and Sorting::               General searching and sorting
71                                          functions.
72 * Input/Output Overview::               Introduction to the i/o facilities.
73 * Input/Output on Streams::             High-level, portable i/o facilities.
74 * Low-Level Input/Output::              Low-level, less portable i/o.
75 * File System Interface::               Functions for manipulating files.
76 * Pipes and FIFOs::                     A simple interprocess communication
77                                          mechanism.
78 * Sockets::                             A more complicated interprocess
79                                          communication mechanism, with support
80                                          for networking.
81 * Low-Level Terminal Interface::        How to change the characteristics
82                                          of a terminal device.
83 * Diagnostics::                         A helpful debugging facility.
84 * Mathematics::                         Math functions.
85 * Date and Time::                       Functions for getting the date and
86                                          time, and conversion between formats.
87 * Non-Local Exits::                     The @code{setjmp} and @code{longjmp}
88                                          facilities.
89 * Signal Handling::                     All about signals; how to send them,
90                                          block them, and handle them.
91 * Processes::                           How to create processes and run other
92                                          programs.
93 * Job Control::                         All about process groups and sessions.
94 * System Databases::                    About the system user and group
95                                          databases.
96 * System Information::                  Getting information about the
97                                          hardware and software configuration
98                                          of the machine a program runs on.
99 * Representation Limits::               Parameters describing numeric data
100                                          type representations..
101 * System Configuration Limits::         Parameters describing operating
102                                          system limits.
103
104 Appendices
105 * Summary of Library Facilities::       A summary showing the syntax, header
106                                          file, and derivation of each library
107                                          feature.
108 * Maintenance::                         How to install and maintain the
109                                          GNU C Library.
110 * Copying::                             The GNU Library General Public License
111                                          says how you can copy and share the
112                                          GNU C Library.
113
114 Indices
115 * Concept Index::       Index of concepts and names.
116 * Type Index::          Index of types and type qualifiers.
117 * Function Index::      Index of functions and function-like macros.
118 * Variable Index::      Index of variables and variable-like macros.
119 * File Index::          Index of programs and files.
120 @end menu
121
122 @include intro.texinfo
123 @include errno.texinfo
124 @include stddef.texinfo
125 @include stdarg.texinfo
126 @include memory.texinfo
127 @include ctype.texinfo
128 @include string.texinfo
129 @include mbyte.texinfo
130 @include locale.texinfo
131 @include search.texinfo
132 @include io.texinfo
133 @include stdio.texinfo
134 @include llio.texinfo
135 @include filesys.texinfo
136 @include pipe.texinfo
137 @include socket.texinfo
138 @include terminal.texinfo
139 @include assert.texinfo
140 @include math.texinfo
141 @include time.texinfo
142 @include setjmp.texinfo
143 @include signal.texinfo
144 @include process.texinfo
145 @include job.texinfo
146 @include database.texinfo
147 @include sysinfo.texinfo
148 @include limits.texinfo
149 @include conf.texinfo
150
151
152 @include header.texinfo
153 @include maint.texinfo
154
155 @node Copying, Concept Index, Maintenance, Top
156 @include lgpl.texinfo
157
158 @node Concept Index
159 @unnumbered Concept Index
160 @printindex cp
161
162 @node Type Index
163 @unnumbered Type Index
164 @printindex tp
165
166 @node Function Index
167 @unnumbered Function and Macro Index
168 @printindex fn
169
170 @node Variable Index
171 @unnumbered Variable and Constant Macro Index
172 @printindex vr
173
174 @node File Index
175 @unnumbered Program and File Index
176 @printindex pg
177
178 @contents
179 @bye