BSD 4_4 release
[unix-history] / usr / src / lib / libcompat / 4.3 / insque.3
index 0e82200..0c2ff7e 100644 (file)
@@ -1,45 +1,80 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\"
-.\"    @(#)insque.3    5.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
 .\"
 .\"
-.TH INSQUE 3 "18 July 1983"
-.UC 5
-.SH NAME
-insque, remque \- insert/remove element from a queue
-.SH SYNOPSIS
-.nf
-.DT
-.ft B
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)insque.3   8.1 (Berkeley) 6/4/93
+.\"
+.Dd June 4, 1993
+.Dt INSQUE 3
+.Os BSD 4.2
+.Sh NAME
+.Nm insque ,
+.Nm remque
+.Nd insert/remove element from a queue
+.Sh SYNOPSIS
+.Bd -literal
 struct qelem {
        struct  qelem *q_forw;
        struct  qelem *q_back;
        char    q_data[];
 };
 struct qelem {
        struct  qelem *q_forw;
        struct  qelem *q_back;
        char    q_data[];
 };
-.PP
-.ft B
-insque(elem, pred)
-struct qelem *elem, *pred;
-.PP
-.ft B
-remque(elem)
-struct qelem *elem;
-.ft R
-.SH DESCRIPTION
-.I Insque
+.Ed
+
+.Fn insque "(caddr_t) struct qelem *elem" "(caddr_t) struct qelem *pred"
+.Fn remque "(caddr_t) struct qelem *elem"
+.Sh DESCRIPTION
+The
+.Fn insque
 and 
 and 
-.I remque
+.Fn remque
+functions
 manipulate queues built from doubly linked lists.  Each
 manipulate queues built from doubly linked lists.  Each
-element in the queue must in the form of ``struct qelem''.
-.I Insque
+element in the queue must in the form of
+.Dq Li struct qelem .
+The function
+.Fn insque
 inserts 
 inserts 
-.I elem
-in a queue imediately after 
-.IR pred ;
-.I remque
+.Fa elem
+in a queue immediately after 
+.Fa pred ;
+.Fn remque
 removes an entry
 removes an entry
-.I elem 
+.Fa elem
 from a queue.
 from a queue.
-.SH "SEE ALSO
-``VAX Architecture Handbook'', pp. 228-235.
+.Sh SEE ALSO
+.%T "VAX Architecture Handbook" ,
+pp. 228-235.
+.Sh HISTORY
+The
+.Fn insque
+and
+.Fn remque
+functions appeared in 
+.Bx 4.2 .