LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / swab.3

diff --git a/original/man3/swab.3 b/original/man3/swab.3
index c131623..e2cd629 100644 (file)
--- a/original/man3/swab.3
+++ b/original/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,12 +28,12 @@
 .\"     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  2014-02-25 "" "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
 .BI "void swab(const void *" from ", void *" to ", ssize_t " n );
@@ -39,22 +41,49 @@ swab \- swap adjacent bytes
 .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
+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"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR swab ()
+function is thread-safe.
+.SH CONFORMING TO
 SVr4, 4.3BSD, POSIX.1-2001.
-.SH "SEE ALSO"
-.BR bstring (3),
-.BR feature_test_macros (7)
+.SH SEE ALSO
+.BR bstring (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.