diff options
| -rw-r--r-- | ChangeLog | 20 | ||||
| -rw-r--r-- | manual/arith.texi | 8 | ||||
| -rw-r--r-- | manual/filesys.texi | 39 | ||||
| -rw-r--r-- | manual/llio.texi | 34 | ||||
| -rw-r--r-- | manual/memory.texi | 8 | ||||
| -rw-r--r-- | manual/nss.texi | 4 | ||||
| -rw-r--r-- | manual/process.texi | 8 | ||||
| -rw-r--r-- | manual/resource.texi | 26 | ||||
| -rw-r--r-- | manual/search.texi | 4 | ||||
| -rw-r--r-- | manual/signal.texi | 21 | ||||
| -rw-r--r-- | manual/socket.texi | 17 | ||||
| -rw-r--r-- | manual/stdio.texi | 7 | ||||
| -rw-r--r-- | manual/sysinfo.texi | 8 | ||||
| -rw-r--r-- | manual/syslog.texi | 4 | ||||
| -rw-r--r-- | manual/terminal.texi | 23 | ||||
| -rw-r--r-- | manual/time.texi | 4 | ||||
| -rw-r--r-- | manual/users.texi | 27 |
17 files changed, 90 insertions, 172 deletions
@@ -1,3 +1,23 @@ +2016-12-21 Rical Jasan <ricaljasan@pacific.net> + + * manual/nss.texi: Change incorrect @vtable to @table. + * manual/arith.texi: Convert @tables of variables to @vtables + and remove unnecessary indexing. + * manual/filesys.texi: Likewise. + * manual/llio.texi: Likewise. + * manual/memory.texi: Likewise. + * manual/process.texi: Likewise. + * manual/resource.texi: Likewise. + * manual/search.texi: Likewise. + * manual/signal.texi: Likewise. + * manual/socket.texi: Likewise. + * manual/stdio.texi: Likewise. + * manual/sysinfo.texi: Likewise. + * manual/syslog.texi: Likewise. + * manual/terminal.texi: Likewise. + * manual/time.texi: Likewise. + * manual/users.texi: Likewise. + 2016-12-21 Joseph Myers <joseph@codesourcery.com> * math/bits/mathcalls.h [__GLIBC_USE (IEC_60559_BFP_EXT)] diff --git a/manual/arith.texi b/manual/arith.texi index b0464e101e..7577445b44 100644 --- a/manual/arith.texi +++ b/manual/arith.texi @@ -1015,31 +1015,27 @@ down. various rounding modes. Each one will be defined if and only if the FPU supports the corresponding rounding mode. -@table @code +@vtable @code @comment fenv.h @comment ISO -@vindex FE_TONEAREST @item FE_TONEAREST Round to nearest. @comment fenv.h @comment ISO -@vindex FE_UPWARD @item FE_UPWARD Round toward @math{+@infinity{}}. @comment fenv.h @comment ISO -@vindex FE_DOWNWARD @item FE_DOWNWARD Round toward @math{-@infinity{}}. @comment fenv.h @comment ISO -@vindex FE_TOWARDZERO @item FE_TOWARDZERO Round toward zero. -@end table +@end vtable Underflow is an unusual case. Normally, @w{IEEE 754} floating point numbers are always normalized (@pxref{Floating Point Concepts}). diff --git a/manual/filesys.texi b/manual/filesys.texi index 26758e626e..edc7c64d22 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -928,12 +928,10 @@ parameter to the function is a pointer to a variable of type int (*) (const char *, const struct stat *, int, struct FTW *) @end smallexample -@vindex FTW_DP -@vindex FTW_SLN The first three arguments are the same as for the @code{__ftw_func_t} type. However for the third argument some additional values are defined to allow finer differentiation: -@table @code +@vtable @code @item FTW_DP The current item is a directory and all subdirectories have already been visited and reported. This flag is returned instead of @code{FTW_D} if @@ -941,7 +939,7 @@ the @code{FTW_DEPTH} flag is passed to @code{nftw} (see below). @item FTW_SLN The current item is a stale symbolic link. The file it points to does not exist. -@end table +@end vtable The last parameter of the callback function is a pointer to a structure with some extra information as described below. @@ -2209,49 +2207,42 @@ This is a bit mask used to extract the file type code from a mode value. These are the symbolic names for the different file type codes: -@table @code +@vtable @code @comment sys/stat.h @comment BSD @item S_IFDIR -@vindex S_IFDIR This is the file type constant of a directory file. @comment sys/stat.h @comment BSD @item S_IFCHR -@vindex S_IFCHR This is the file type constant of a character-oriented device file. @comment sys/stat.h @comment BSD @item S_IFBLK -@vindex S_IFBLK This is the file type constant of a block-oriented device file. @comment sys/stat.h @comment BSD @item S_IFREG -@vindex S_IFREG This is the file type constant of a regular file. @comment sys/stat.h @comment BSD @item S_IFLNK -@vindex S_IFLNK This is the file type constant of a symbolic link. @comment sys/stat.h @comment BSD @item S_IFSOCK -@vindex S_IFSOCK This is the file type constant of a socket. @comment sys/stat.h @comment BSD @item S_IFIFO -@vindex S_IFIFO This is the file type constant of a FIFO or pipe. -@end table +@end vtable The POSIX.1b standard introduced a few more objects which possibly can be implemented as objects in the filesystem. These are message queues, @@ -2404,15 +2395,13 @@ All of the symbols listed in this section are defined in the header file These symbolic constants are defined for the file mode bits that control access permission for the file: -@table @code +@vtable @code @comment sys/stat.h @comment POSIX.1 @item S_IRUSR -@vindex S_IRUSR @comment sys/stat.h @comment BSD @itemx S_IREAD -@vindex S_IREAD Read permission bit for the owner of the file. On many systems this bit is 0400. @code{S_IREAD} is an obsolete synonym provided for BSD compatibility. @@ -2420,22 +2409,18 @@ compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IWUSR -@vindex S_IWUSR @comment sys/stat.h @comment BSD @itemx S_IWRITE -@vindex S_IWRITE Write permission bit for the owner of the file. Usually 0200. @w{@code{S_IWRITE}} is an obsolete synonym provided for BSD compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IXUSR -@vindex S_IXUSR @comment sys/stat.h @comment BSD @itemx S_IEXEC -@vindex S_IEXEC Execute (for ordinary files) or search (for directories) permission bit for the owner of the file. Usually 0100. @code{S_IEXEC} is an obsolete synonym provided for BSD compatibility. @@ -2443,69 +2428,58 @@ synonym provided for BSD compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IRWXU -@vindex S_IRWXU This is equivalent to @samp{(S_IRUSR | S_IWUSR | S_IXUSR)}. @comment sys/stat.h @comment POSIX.1 @item S_IRGRP -@vindex S_IRGRP Read permission bit for the group owner of the file. Usually 040. @comment sys/stat.h @comment POSIX.1 @item S_IWGRP -@vindex S_IWGRP Write permission bit for the group owner of the file. Usually 020. @comment sys/stat.h @comment POSIX.1 @item S_IXGRP -@vindex S_IXGRP Execute or search permission bit for the group owner of the file. Usually 010. @comment sys/stat.h @comment POSIX.1 @item S_IRWXG -@vindex S_IRWXG This is equivalent to @samp{(S_IRGRP | S_IWGRP | S_IXGRP)}. @comment sys/stat.h @comment POSIX.1 @item S_IROTH -@vindex S_IROTH Read permission bit for other users. Usually 04. @comment sys/stat.h @comment POSIX.1 @item S_IWOTH -@vindex S_IWOTH Write permission bit for other users. Usually 02. @comment sys/stat.h @comment POSIX.1 @item S_IXOTH -@vindex S_IXOTH Execute or search permission bit for other users. Usually 01. @comment sys/stat.h @comment POSIX.1 @item S_IRWXO -@vindex S_IRWXO This is equivalent to @samp{(S_IROTH | S_IWOTH | S_IXOTH)}. @comment sys/stat.h @comment POSIX @item S_ISUID -@vindex S_ISUID This is the set-user-ID on execute bit, usually 04000. @xref{How Change Persona}. @comment sys/stat.h @comment POSIX @item S_ISGID -@vindex S_ISGID This is the set-group-ID on execute bit, usually 02000. @xref{How Change Persona}. @@ -2513,7 +2487,6 @@ This is the set-group-ID on execute bit, usually 02000. @comment sys/stat.h @comment BSD @item S_ISVTX -@vindex S_ISVTX This is the @dfn{sticky} bit, usually 01000. For a directory it gives permission to delete a file in that directory @@ -2558,7 +2531,7 @@ This bit is only available on BSD systems (and those derived from them). Therefore one has to use the @code{_GNU_SOURCE} feature select macro, or not define any feature test macros, to get the definition (@pxref{Feature Test Macros}). -@end table +@end vtable The actual bit values of the symbols are listed in the table above so you can decode file mode values when debugging your programs. diff --git a/manual/llio.texi b/manual/llio.texi index e2697aa090..9643bcb44b 100644 --- a/manual/llio.texi +++ b/manual/llio.texi @@ -690,7 +690,7 @@ interpreted, in the same way as for the @code{fseek} function, and it must be one of the symbolic constants @code{SEEK_SET}, @code{SEEK_CUR}, or @code{SEEK_END}. -@table @code +@vtable @code @item SEEK_SET Specifies that @var{offset} is a count of characters from the beginning of the file. @@ -706,7 +706,7 @@ extent of the file; a positive count specifies a position past the current end. If you set the position past the current end, and actually write data, you will extend the file with zeros up to that position. -@end table +@end vtable The return value from @code{lseek} is normally the resulting file position, measured in bytes from the beginning of the file. @@ -858,7 +858,7 @@ These aliases for the @samp{SEEK_@dots{}} constants exist for the sake of compatibility with older BSD systems. They are defined in two different header files: @file{fcntl.h} and @file{sys/file.h}. -@table @code +@vtable @code @item L_SET An alias for @code{SEEK_SET}. @@ -867,7 +867,7 @@ An alias for @code{SEEK_CUR}. @item L_XTND An alias for @code{SEEK_END}. -@end table +@end vtable @node Descriptors and Streams @section Descriptors and Streams @@ -938,11 +938,10 @@ file descriptors belonging to the standard streams @code{stdin}, @code{stdout}, and @code{stderr}; see @ref{Standard Streams}. @pindex unistd.h +@vtable @code @comment unistd.h @comment POSIX.1 -@table @code @item STDIN_FILENO -@vindex STDIN_FILENO This macro has value @code{0}, which is the file descriptor for standard input. @cindex standard input file descriptor @@ -950,7 +949,6 @@ standard input. @comment unistd.h @comment POSIX.1 @item STDOUT_FILENO -@vindex STDOUT_FILENO This macro has value @code{1}, which is the file descriptor for standard output. @cindex standard output file descriptor @@ -958,10 +956,9 @@ standard output. @comment unistd.h @comment POSIX.1 @item STDERR_FILENO -@vindex STDERR_FILENO This macro has value @code{2}, which is the file descriptor for standard error output. -@end table +@end vtable @cindex standard error file descriptor @node Stream/Descriptor Precautions @@ -1492,7 +1489,7 @@ and extending @var{length} bytes. The valid BSD values for @var{advice} are: -@table @code +@vtable @code @item MADV_NORMAL The region should receive no further special treatment. @@ -1515,11 +1512,11 @@ The region is no longer needed. The kernel may free these pages, causing any changes to the pages to be lost, as well as swapped out pages to be discarded. -@end table +@end vtable The POSIX names are slightly different, but with the same meanings: -@table @code +@vtable @code @item POSIX_MADV_NORMAL This corresponds with BSD's @code{MADV_NORMAL}. @@ -1536,7 +1533,7 @@ This corresponds with BSD's @code{MADV_WILLNEED}. @item POSIX_MADV_DONTNEED This corresponds with BSD's @code{MADV_DONTNEED}. -@end table +@end vtable @code{madvise} returns @math{0} for success and @math{-1} for error. Errors include: @@ -2906,7 +2903,7 @@ descriptions of the individual commands. Briefly, here is a list of what the various commands are. -@table @code +@vtable @code @item F_DUPFD Duplicate the file descriptor (return another file descriptor pointing to the same open file). @xref{Duplicating Descriptors}. @@ -2951,7 +2948,7 @@ Get process or process group ID to receive @code{SIGIO} signals. @item F_SETOWN Set process or process group ID to receive @code{SIGIO} signals. @xref{Interrupt Input}. -@end table +@end vtable This function is a cancellation point in multi-threaded programs. This is a problem if the thread allocates some resources (like memory, file @@ -3827,25 +3824,22 @@ you know if it notices one. The following macros are defined for use as values for the @code{l_type} member of the @code{flock} structure. The values are integer constants. -@table @code +@vtable @code @comment fcntl.h @comment POSIX.1 -@vindex F_RDLCK @item F_RDLCK This macro is used to specify a read (or shared) lock. @comment fcntl.h @comment POSIX.1 -@vindex F_WRLCK @item F_WRLCK This macro is used to specify a write (or exclusive) lock. @comment fcntl.h @comment POSIX.1 -@vindex F_UNLCK @item F_UNLCK This macro is used to specify that the region is unlocked. -@end table +@end vtable As an example of a situation where file locking is useful, consider a program that can be run simultaneously by several different users, that diff --git a/manual/memory.texi b/manual/memory.texi index b66de60210..38d3c3a4bb 100644 --- a/manual/memory.texi +++ b/manual/memory.texi @@ -1090,8 +1090,8 @@ When calling @code{mallopt}, the @var{param} argument specifies the parameter to be set, and @var{value} the new value to be set. Possible choices for @var{param}, as defined in @file{malloc.h}, are: -@table @code @comment TODO: @item M_CHECK_ACTION +@vtable @code @item M_MMAP_MAX The maximum number of chunks to allocate with @code{mmap}. Setting this to zero disables all use of @code{mmap}. @@ -1177,7 +1177,7 @@ derived from the default value of M_ARENA_TEST and is computed independently. This parameter can also be set for the process at startup by setting the environment variable @env{MALLOC_ARENA_MAX} to the desired value. -@end table +@end vtable @end deftypefun @@ -3213,7 +3213,7 @@ user space kernel data, shared memory, and memory mapped files. macros. They tell @code{mlockall} which of its functions you want. All other bits must be zero. -@table @code +@vtable @code @item MCL_CURRENT Lock all pages which currently exist in the calling process' virtual @@ -3226,7 +3226,7 @@ affect future address spaces owned by the same process so exec, which replaces a process' address space, wipes out @code{MCL_FUTURE}. @xref{Executing a File}. -@end table +@end vtable When the function returns successfully, and you specified @code{MCL_CURRENT}, all of the process' pages are backed by (connected diff --git a/manual/nss.texi b/manual/nss.texi index 058b9aeaee..ee70ad309d 100644 --- a/manual/nss.texi +++ b/manual/nss.texi @@ -66,7 +66,7 @@ The databases available in the NSS are @cindex rpc @cindex services @cindex shadow -@vtable @code +@table @code @item aliases Mail aliases @comment @pxref{Mail Aliases}. @@ -93,7 +93,7 @@ Network services, @pxref{Services Database}. @item shadow Shadow user passwords, @comment @pxref{Shadow Password Database}. -@end vtable +@end table @noindent There will be some more added later (@code{automount}, @code{bootparams}, diff --git a/manual/process.texi b/manual/process.texi index 67b3237137..085fdec926 100644 --- a/manual/process.texi +++ b/manual/process.texi @@ -594,7 +594,7 @@ These symbolic constants are defined as values for the @var{pid} argument to the @code{waitpid} function. @comment Extra blank lines make it look better. -@table @code +@vtable @code @item WAIT_ANY This constant macro (whose value is @code{-1}) specifies that @@ -605,13 +605,13 @@ This constant macro (whose value is @code{-1}) specifies that This constant (with value @code{0}) specifies that @code{waitpid} should return status information about any child process in the same process group as the calling process. -@end table +@end vtable These symbolic constants are defined as flags for the @var{options} argument to the @code{waitpid} function. You can bitwise-OR the flags together to obtain a value to use as the argument. -@table @code +@vtable @code @item WNOHANG This flag specifies that @code{waitpid} should return immediately @@ -622,7 +622,7 @@ instead of waiting, if there is no child process ready to be noticed. This flag specifies that @code{waitpid} should report the status of any child processes that have been stopped as well as those that have terminated. -@end table +@end vtable @comment sys/wait.h @comment POSIX.1 diff --git a/manual/resource.texi b/manual/resource.texi index 75e3a1bf71..bf9337553c 100644 --- a/manual/resource.texi +++ b/manual/resource.texi @@ -337,11 +337,10 @@ This is analogous to @code{rlimit.rlim_max}, but with a different type. Here is a list of resources for which you can specify a limit. Memory and file sizes are measured in bytes. -@table @code +@vtable @code @comment sys/resource.h @comment BSD @item RLIMIT_CPU -@vindex RLIMIT_CPU The maximum amount of CPU time the process can use. If it runs for longer than this, it gets a signal: @code{SIGXCPU}. The value is measured in seconds. @xref{Operation Error Signals}. @@ -349,7 +348,6 @@ measured in seconds. @xref{Operation Error Signals}. @comment sys/resource.h @comment BSD @item RLIMIT_FSIZE -@vindex RLIMIT_FSIZE The maximum size of file the process can create. Trying to write a larger file causes a signal: @code{SIGXFSZ}. @xref{Operation Error Signals}. @@ -357,7 +355,6 @@ Signals}. @comment sys/resource.h @comment BSD @item RLIMIT_DATA -@vindex RLIMIT_DATA The maximum size of data memory for the process. If the process tries to allocate data memory beyond this amount, the allocation function fails. @@ -365,7 +362,6 @@ fails. @comment sys/resource.h @comment BSD @item RLIMIT_STACK -@vindex RLIMIT_STACK The maximum stack size for the process. If the process tries to extend its stack past this size, it gets a @code{SIGSEGV} signal. @xref{Program Error Signals}. @@ -373,7 +369,6 @@ its stack past this size, it gets a @code{SIGSEGV} signal. @comment sys/resource.h @comment BSD @item RLIMIT_CORE -@vindex RLIMIT_CORE The maximum size core file that this process can create. If the process terminates and would dump a core file larger than this, then no core file is created. So setting this limit to zero prevents core files from @@ -382,7 +377,6 @@ ever being created. @comment sys/resource.h @comment BSD @item RLIMIT_RSS -@vindex RLIMIT_RSS The maximum amount of physical memory that this process should get. This parameter is a guide for the system's scheduler and memory allocator; the system may give the process more memory when there is a @@ -404,9 +398,7 @@ with @code{EAGAIN}. @xref{Creating a Process}. @comment sys/resource.h @comment BSD @item RLIMIT_NOFILE -@vindex RLIMIT_NOFILE @itemx RLIMIT_OFILE -@vindex RLIMIT_OFILE The maximum number of files that the process can open. If it tries to open more files than this, its open attempt fails with @code{errno} @code{EMFILE}. @xref{Error Codes}. Not all systems support this limit; @@ -415,7 +407,6 @@ GNU does, and 4.4 BSD does. @comment sys/resource.h @comment Unix98 @item RLIMIT_AS -@vindex RLIMIT_AS The maximum size of total memory that this process should get. If the process tries to allocate more memory beyond this amount with, for example, @code{brk}, @code{malloc}, @code{mmap} or @code{sbrk}, the @@ -424,10 +415,9 @@ allocation function fails. @comment sys/resource.h @comment BSD @item RLIM_NLIMITS -@vindex RLIM_NLIMITS The number of different resource limits. Any valid @var{resource} operand must be less than @code{RLIM_NLIMITS}. -@end table +@end vtable @comment sys/resource.h @comment BSD @@ -460,7 +450,7 @@ If you are setting a limit, there is a second argument: the limit. The @var{cmd} values and the operations they specify are: -@table @code +@vtable @code @item GETFSIZE Get the current limit on the size of a file, in units of 512 bytes. @@ -469,7 +459,7 @@ Get the current limit on the size of a file, in units of 512 bytes. Set the current and maximum limit on the size of a file to @var{limit} * 512 bytes. -@end table +@end vtable There are also some other @var{cmd} values that may do things on some systems, but they are not supported. @@ -504,7 +494,7 @@ A process tried to increase a maximum limit, but is not superuser. @var{resource} identifies the resource: -@table @code +@vtable @code @item LIM_CPU Maximum CPU time. Same as @code{RLIMIT_CPU} for @code{setrlimit}. |