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 c131623eb7a2c8ad9e3f01046ddfbeaa6b1dc0db..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.
@@ -19,6 +20,7 @@
 .\"
 .\" 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,35 +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
-.B #define _XOPEN_SOURCE
+.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
 .BR swab ()
-function copies \fIn\fP bytes from the array pointed
-to by \fIfrom\fP to the array pointed to by \fIto\fP, exchanging
+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\-1\fP 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"
+(In other words,
+.I n
+should be even.)
+.SH RETURN VALUE
 The
 .BR swab ()
 function returns no value.
-.SH "CONFORMING TO"
-SVr4, 4.3BSD, POSIX.1-2001.
-.SH "SEE ALSO"
-.BR bstring (3),
-.BR feature_test_macros (7)
+.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)