des_crypt.3: Minor wording fix in VERSIONS

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

diff --git a/man3/swab.3 b/man3/swab.3
index c3a7020a636dd3a491183f9823a54291b6cd032b..f73c168d24fad46ab11e0cf1ddd2e64d2b884a0d 100644 (file)
--- a/man3/swab.3
+++ b/man3/swab.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%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.
@@ -8,7 +9,7 @@
 .\" 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
@@ -16,9 +17,10 @@
 .\" 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
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -26,28 +28,60 @@
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 17:52:15 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified 2001-12-15, aeb
-.TH SWAB 3  2001-12-15 "" "Linux Programmer's Manual"
+.TH SWAB 3  2015-08-08 "" "Linux Programmer's Manual"
 .SH NAME
 swab \- swap adjacent bytes
 .SH SYNOPSIS
 .nf
+.BR "#define _XOPEN_SOURCE" "       /* See feature_test_macros(7) */"
 .B #include <unistd.h>
-.sp
+.PP
 .BI "void swab(const void *" from ", void *" to ", ssize_t " n );
 .fi
 .SH DESCRIPTION
-The \fBswab()\fP function copies \fIn\fP bytes from the array pointed
-to by \fIfrom\fP to the array pointed to by \fIto\fP, exchanging
-adjacent even and odd bytes.  This function is used to exchange data
+The
+.BR swab ()
+function copies
+.I n
+bytes from the array pointed
+to by
+.I from
+to the array pointed to by
+.IR to ,
+exchanging
+adjacent even and odd bytes.
+This function is used to exchange data
 between machines that have different low/high byte ordering.
-.LP
-This function does nothing when \fIn\fP is negative.
-When \fIn\fP is positive and odd, it handles \fIn\fP-1 bytes
+.PP
+This function does nothing when
+.I n
+is negative.
+When
+.I n
+is positive and odd, it handles
+.I n\-1
+bytes
 as above, and does something unspecified with the last byte.
-(In other words, \fIn\fP should be even.)
-.SH "RETURN VALUE"
-The \fBswab()\fP function returns no value.
-.SH "CONFORMING TO"
-SVID 3, 4.3BSD, POSIX 1003.1-2001
-.SH "SEE ALSO"
+(In other words,
+.I n
+should be even.)
+.SH RETURN VALUE
+The
+.BR swab ()
+function returns no value.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR swab ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
+.SH SEE ALSO
 .BR bstring (3)