summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen/vis.3
diff options
context:
space:
mode:
authorwollman <wollman@FreeBSD.org>1996-07-25 18:31:08 +0000
committerwollman <wollman@FreeBSD.org>1996-07-25 18:31:08 +0000
commit712b493c142cbbf4ea8b44378395cdd408d556a0 (patch)
treefc1e84bd0be70da6eb5b7d977bb283f9e0047019 /lib/libc/gen/vis.3
parentce6b6b7927e8ac98af960ca87faaf06fb7132dff (diff)
downloadFreeBSD-src-712b493c142cbbf4ea8b44378395cdd408d556a0.zip
FreeBSD-src-712b493c142cbbf4ea8b44378395cdd408d556a0.tar.gz
Refer to the ASCII character 000 by its proper name, `NUL', and not
`NULL' (which should only be used in reference to null pointers). Also fix a cross-reference.
Diffstat (limited to 'lib/libc/gen/vis.3')
-rw-r--r--lib/libc/gen/vis.323
1 files changed, 12 insertions, 11 deletions
diff --git a/lib/libc/gen/vis.3 b/lib/libc/gen/vis.3
index ee77b72..c10d432 100644
--- a/lib/libc/gen/vis.3
+++ b/lib/libc/gen/vis.3
@@ -29,9 +29,10 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)vis.3 8.1 (Berkeley) 6/9/93
+.\" From: @(#)vis.3 8.1 (Berkeley) 6/9/93
+.\" $Id$
.\"
-.Dd June 9, 1993
+.Dd July 25, 1996
.Dt VIS 3
.Os
.Sh NAME
@@ -59,11 +60,11 @@ needs no encoding, it is copied in unaltered. The string is
null terminated, and a pointer to the end of the string is
returned. The maximum length of any encoding is four
characters (not including the trailing
-.Dv NULL ) ;
+.Dv NUL ) ;
thus, when
encoding a set of characters into a buffer, the size of the buffer should
be four times the number of characters encoded, plus one for the trailing
-.Dv NULL .
+.Dv NUL .
The flag parameter is used for altering the default range of
characters considered for encoding and for altering the visual
representation.
@@ -88,7 +89,7 @@ function encodes characters from
.Fa src
up to the
first
-.Dv NULL .
+.Dv NUL .
The
.Fn strvisx
function encodes exactly
@@ -97,9 +98,9 @@ characters from
.Fa src
(this
is useful for encoding a block of data that may contain
-.Dv NULL Ns 's).
+.Dv NUL Ns 's).
Both forms
-.Dv NULL
+.Dv NUL
terminate
.Fa dst .
The size of
@@ -108,11 +109,11 @@ must be four times the number
of characters encoded from
.Fa src
(plus one for the
-.Dv NULL ) .
+.Dv NUL ) .
Both
forms return the number of characters in dst (not including
the trailing
-.Dv NULL ) .
+.Dv NUL ) .
.Pp
The encoding is a unique, invertible representation comprised entirely of
graphic characters; it can be decoded back into the original form using
@@ -226,7 +227,7 @@ The following sequences are used to represent the indicated characters:
.Pp
When using this format, the nextc parameter is looked at to determine
if a
-.Dv NULL
+.Dv NUL
character can be encoded as
.Ql \e0
instead of
@@ -256,8 +257,8 @@ With this flag set, the encoding is
ambiguous and non-invertible.
.Sh SEE ALSO
.Xr unvis 1 ,
+.Xr strunvis 3 ,
.Xr unvis 3
-.Xr strunvis 3
.Sh HISTORY
These functions first appeared in 4.4BSD.
OpenPOWER on IntegriCloud