Many pages: Add '\" t' comment where necessary

[thirdparty/man-pages.git] / man3 / insque.3

diff --git a/man3/insque.3 b/man3/insque.3
index 005ad8cc19de99270337a2e14d27e46649f17d5c..7ab47bcebd01dd94d81db526165254bb78f6b6e1 100644 (file)
--- a/man3/insque.3
+++ b/man3/insque.3
@@ -1,28 +1,9 @@
+'\" t
 .\" peter memishian -- meem@gnu.ai.mit.edu
 .\" $Id: insque.3,v 1.2 1996/10/30 21:03:39 meem Exp meem $
 .\" and Copyright (c) 2010, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date.  The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein.  The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\" References consulted:
 .\"   Linux libc source code (5.4.7)
@@ -33,39 +14,39 @@
 .\" mtk, 2010-09-09: Noted glibc 2.4 bug, added info on circular
 .\"    lists, added example program
 .\"
-.TH INSQUE 3  2020-06-09 "" "Linux Programmer's Manual"
+.TH insque 3 (date) "Linux man-pages (unreleased)"
 .SH NAME
 insque, remque \- insert/remove an item from a queue
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
 .SH SYNOPSIS
 .nf
 .B #include <search.h>
 .PP
 .BI "void insque(void *" elem ", void *" prev );
-.PP
 .BI "void remque(void *" elem );
 .fi
 .PP
-.in -4n
+.RS -4
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
-.in
+.RE
 .PP
-.ad l
 .BR insque (),
 .BR remque ():
-.RS 4
-_XOPEN_SOURCE\ >=\ 500
-.\"    || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
-    || /* Glibc since 2.19: */ _DEFAULT_SOURCE
-    || /* Glibc versions <= 2.19: */ _SVID_SOURCE
-.RE
-.ad
+.nf
+    _XOPEN_SOURCE >= 500
+.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
+        || /* Glibc >= 2.19: */ _DEFAULT_SOURCE
+        || /* Glibc <= 2.19: */ _SVID_SOURCE
+.fi
 .SH DESCRIPTION
 The
 .BR insque ()
 and
 .BR remque ()
-functions manipulate doubly-linked lists.
+functions manipulate doubly linked lists.
 Each element in the list is a structure of
 which the first two elements are a forward and a
 backward pointer.
@@ -97,13 +78,15 @@ call should also point to the element.
 The
 .BR remque ()
 function removes the element pointed to by \fIelem\fP from the
-doubly-linked list.
+doubly linked list.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
+.ad l
+.nh
 .TS
 allbox;
-lb lb lb
+lbx lb lb
 l l l.
 Interface      Attribute       Value
 T{
@@ -111,8 +94,10 @@ T{
 .BR remque ()
 T}     Thread safety   MT-Safe
 .TE
+.hy
+.ad
 .sp 1
-.SH CONFORMING TO
+.SH STANDARDS
 POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
 On ancient systems,
@@ -165,11 +150,12 @@ That was a circular list
 .in
 .SS Program source
 \&
+.\" SRC BEGIN (insque.c)
 .EX
+#include <search.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <unistd.h>
-#include <search.h>
 
 struct element {
     struct element *forward;
@@ -198,13 +184,13 @@ main(int argc, char *argv[])
     int circular, opt, errfnd;
 
     /* The "\-c" command\-line option can be used to specify that the
-       list is circular */
+       list is circular. */
 
     errfnd = 0;
     circular = 0;
     while ((opt = getopt(argc, argv, "c")) != \-1) {
         switch (opt) {
-        case 'c':
+        case \(aqc\(aq:
             circular = 1;
             break;
         default:
@@ -218,7 +204,7 @@ main(int argc, char *argv[])
         exit(EXIT_FAILURE);
     }
 
-    /* Create first element and place it in the linked list */
+    /* Create first element and place it in the linked list. */
 
     elem = new_element();
     first = elem;
@@ -233,7 +219,7 @@ main(int argc, char *argv[])
         insque(elem, NULL);
     }
 
-    /* Add remaining command\-line arguments as list elements */
+    /* Add remaining command\-line arguments as list elements. */
 
     while (++optind < argc) {
         prev = elem;
@@ -243,7 +229,7 @@ main(int argc, char *argv[])
         insque(elem, prev);
     }
 
-    /* Traverse the list from the start, printing element names */
+    /* Traverse the list from the start, printing element names. */
 
     printf("Traversing completed list:\en");
     elem = first;
@@ -258,5 +244,6 @@ main(int argc, char *argv[])
     exit(EXIT_SUCCESS);
 }
 .EE
+.\" SRC END
 .SH SEE ALSO
-.BR queue (3)
+.BR queue (7)