about summary refs log tree commit diff
path: root/manual/signal.texi
diff options
context:
space:
mode:
authorRical Jasan <ricaljasan@pacific.net>2016-12-21 01:36:58 -0800
committerRical Jasan <ricaljasan@pacific.net>2016-12-21 01:36:58 -0800
commit2fe82ca6dc5a2d2ffc91b7df9d136de7bf10bd9a (patch)
tree9bc8f8d16e9de019dc03e46ab994f9f94005b5ca /manual/signal.texi
parent41c67149b94676347b0068a902058f130e3e88e6 (diff)
downloadglibc-2fe82ca6dc5a2d2ffc91b7df9d136de7bf10bd9a.tar.gz
glibc-2fe82ca6dc5a2d2ffc91b7df9d136de7bf10bd9a.tar.xz
glibc-2fe82ca6dc5a2d2ffc91b7df9d136de7bf10bd9a.zip
manual: Convert @tables of variables to @vtables.
Texinfo @vindex commands add entries to the Variable and Constant
Macro Index.  Similarly, @items in @vtables are automatically indexed.
A number of @tables exist where all @items are @vindexed or all @items
are variables, but not indexed, suggesting an optimization by
converting such @tables to @vtables and dropping the @vindex.

Using a @vtable provides a context for processing @items whereby it
can be known the @items should have header and standards annotations.
This commit converts @tables of such @items to @vtables in order to
establish a framework for automated processing.

A pleasant consequence of these changes is that @items previously
lacking a @vindex are present in the Variable and Constant Macro Index
now.  @vindex entries previously detected by summary.awk will still be
detected as @items with appropriate annotations.

The @vtable of the NSS databases is converted to a @table because 1)
those @items are not variables (and will no longer appear in the
Variable and Constant Macro Index) and 2) they do not need header and
standards annotations, so the incorrect context is fixed.

	* 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.
Diffstat (limited to 'manual/signal.texi')
-rw-r--r--manual/signal.texi21
1 files changed, 4 insertions, 17 deletions
diff --git a/manual/signal.texi b/manual/signal.texi
index 79e190dc15..d6a1bfe94a 100644
--- a/manual/signal.texi
+++ b/manual/signal.texi
@@ -311,63 +311,53 @@ establish the handler.  @Theglibc{} does provide this extra
 argument, but the value is meaningful only on operating systems that
 provide the information (BSD systems and @gnusystems{}).
 
-@table @code
+@vtable @code
 @comment signal.h
 @comment BSD
 @item FPE_INTOVF_TRAP
-@vindex FPE_INTOVF_TRAP
 Integer overflow (impossible in a C program unless you enable overflow
 trapping in a hardware-specific fashion).
 @comment signal.h
 @comment BSD
 @item FPE_INTDIV_TRAP
-@vindex FPE_INTDIV_TRAP
 Integer division by zero.
 @comment signal.h
 @comment BSD
 @item FPE_SUBRNG_TRAP
-@vindex FPE_SUBRNG_TRAP
 Subscript-range (something that C programs never check for).
 @comment signal.h
 @comment BSD
 @item FPE_FLTOVF_TRAP
-@vindex FPE_FLTOVF_TRAP
 Floating overflow trap.
 @comment signal.h
 @comment BSD
 @item FPE_FLTDIV_TRAP
-@vindex FPE_FLTDIV_TRAP
 Floating/decimal division by zero.
 @comment signal.h
 @comment BSD
 @item FPE_FLTUND_TRAP
-@vindex FPE_FLTUND_TRAP
 Floating underflow trap.  (Trapping on floating underflow is not
 normally enabled.)
 @comment signal.h
 @comment BSD
 @item FPE_DECOVF_TRAP
-@vindex FPE_DECOVF_TRAP
 Decimal overflow trap.  (Only a few machines have decimal arithmetic and
 C never uses it.)
 @ignore @c These seem redundant
 @comment signal.h
 @comment BSD
 @item FPE_FLTOVF_FAULT
-@vindex FPE_FLTOVF_FAULT
 Floating overflow fault.
 @comment signal.h
 @comment BSD
 @item FPE_FLTDIV_FAULT
-@vindex FPE_FLTDIV_FAULT
 Floating divide by zero fault.
 @comment signal.h
 @comment BSD
 @item FPE_FLTUND_FAULT
-@vindex FPE_FLTUND_FAULT
 Floating underflow fault.
 @end ignore
-@end table
+@end vtable
 
 @comment signal.h
 @comment ISO
@@ -2633,10 +2623,9 @@ The @code{sigprocmask} function is used to examine or change the calling
 process's signal mask.  The @var{how} argument determines how the signal
 mask is changed, and must be one of the following values:
 
-@table @code
+@vtable @code
 @comment signal.h
 @comment POSIX.1
-@vindex SIG_BLOCK
 @item SIG_BLOCK
 Block the signals in @code{set}---add them to the existing mask.  In
 other words, the new mask is the union of the existing mask and
@@ -2644,16 +2633,14 @@ other words, the new mask is the union of the existing mask and
 
 @comment signal.h
 @comment POSIX.1
-@vindex SIG_UNBLOCK
 @item SIG_UNBLOCK
 Unblock the signals in @var{set}---remove them from the existing mask.
 
 @comment signal.h
 @comment POSIX.1
-@vindex SIG_SETMASK
 @item SIG_SETMASK
 Use @var{set} for the mask; ignore the previous value of the mask.
-@end table
+@end vtable
 
 The last argument, @var{oldset}, is used to return information about the
 old process signal mask.  If you just want to change the mask without