Update README

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

diff --git a/original/man3/argz_add.3 b/original/man3/argz_add.3
index 8bd4430..88b03aa 100644 (file)
--- a/original/man3/argz_add.3
+++ b/original/man3/argz_add.3
@@ -7,7 +7,7 @@
 .\" based on the description in glibc source and infopages
 .\"
 .\" Corrections and additions, aeb
 .\" based on the description in glibc source and infopages
 .\"
 .\" Corrections and additions, aeb

-.TH ARGZ_ADD 3 2007-05-18  "" "Linux Programmer's Manual"
+.TH ARGZ_ADD 3 2014-05-28  "" "Linux Programmer's Manual"

 .SH NAME
 argz_add, argz_add_sep, argz_append, argz_count, argz_create,
 argz_create_sep, argz_delete, argz_extract, argz_insert,
 .SH NAME
 argz_add, argz_add_sep, argz_append, argz_count, argz_create,
 argz_create_sep, argz_delete, argz_extract, argz_insert,


@@ -20,37 +20,31 @@ argz_next, argz_replace, argz_stringify \- functions to handle an argz list
 ", const char *" str );
 .sp
 .BI "error_t argz_add_sep(char **" argz ", size_t *" argz_len ,
 ", const char *" str );
 .sp
 .BI "error_t argz_add_sep(char **" argz ", size_t *" argz_len ,

-.ti 20n
-.BI "const char *" str ", int " delim );
+.BI "                     const char *" str ", int " delim );

 .sp
 .BI "error_t argz_append(char **" argz ", size_t *" argz_len ,
 .sp
 .BI "error_t argz_append(char **" argz ", size_t *" argz_len ,

-.ti 20n
-.BI "const char *" buf ", size_t " buf_len );
+.BI "                     const char *" buf ", size_t " buf_len );

 .sp
 .BI "size_t argz_count(const char *" argz ", size_t " argz_len );
 .sp
 .BI "error_t argz_create(char * const " argv "[], char **" argz ,
 .sp
 .BI "size_t argz_count(const char *" argz ", size_t " argz_len );
 .sp
 .BI "error_t argz_create(char * const " argv "[], char **" argz ,

-.ti 20n
-.BI "size_t *" argz_len );
+.BI "                     size_t *" argz_len );

 .sp
 .BI "error_t argz_create_sep(const char *" str ", int " sep ", char **" argz ,
 .sp
 .BI "error_t argz_create_sep(const char *" str ", int " sep ", char **" argz ,

-.ti 20n
-.BI "size_t *" argz_len );
+.BI "                     size_t *" argz_len );

 .sp
 .sp

-.BI "error_t argz_delete(char **" argz ", size_t *" argz_len ", char *" entry );
+.BI "void argz_delete(char **" argz ", size_t *" argz_len ", char *" entry );

 .sp
 .sp

-.BI "void argz_extract(char *" argz ", size_t " argz_len ", char  **" argv );
+.BI "void argz_extract(const char *" argz ", size_t " argz_len ", char  **" argv );

 .sp
 .BI "error_t argz_insert(char **" argz ", size_t *" argz_len ", char *" before ,
 .sp
 .BI "error_t argz_insert(char **" argz ", size_t *" argz_len ", char *" before ,

-.ti 20n
-.BI "const char *" entry );
+.BI "                     const char *" entry );

 .sp
 .sp

-.BI "char *argz_next(char *" argz ", size_t " argz_len ", const char *" entry );
+.BI "char *argz_next(const char *" argz ", size_t " argz_len ", const char *" entry );

 .sp
 .BI "error_t argz_replace(char **" argz ", size_t *" argz_len \
 ", const char *" str ,
 .sp
 .BI "error_t argz_replace(char **" argz ", size_t *" argz_len \
 ", const char *" str ,

-.ti 20n
-.BI "const char *" with ", unsigned int *" replace_count );
+.BI "                     const char *" with ", unsigned int *" replace_count );

 .sp
 .BI "void argz_stringify(char *" argz ", size_t " len ", int " sep );
 .fi
 .sp
 .BI "void argz_stringify(char *" argz ", size_t " len ", int " sep );
 .fi


@@ -64,7 +58,7 @@ If the length is nonzero, the last byte of the buffer must be a null byte.
 .LP
 These functions are for handling argz vectors.
 The pair (NULL,0) is an argz vector, and, conversely,
 .LP
 These functions are for handling argz vectors.
 The pair (NULL,0) is an argz vector, and, conversely,

-argz vectors of length 0 must have NULL pointer.
+argz vectors of length 0 must have null pointer.

 Allocation of nonempty argz vectors is done using
 .BR malloc (3),
 so that
 Allocation of nonempty argz vectors is done using
 .BR malloc (3),
 so that


@@ -112,7 +106,7 @@ the number of null bytes (\(aq\\0\(aq), in
 converts a UNIX-style argument vector
 .IR argv ,
 terminated by
 converts a UNIX-style argument vector
 .IR argv ,
 terminated by

-.IR "(char *) 0" ,
+.IR "(char\ *)\ 0" ,

 into an argz vector
 .RI ( *argz ,\  *argz_len ).
 .LP
 into an argz vector
 .RI ( *argz ,\  *argz_len ).
 .LP


@@ -146,7 +140,7 @@ making a UNIX-style argv vector.
 The array
 .I argv
 must have room for
 The array
 .I argv
 must have room for

-.IR argz_count ( argz , argz_len ") + 1"
+.IR argz_count ( argz ", " argz_len ") + 1"

 pointers.
 .LP
 .BR argz_insert ()
 pointers.
 .LP
 .BR argz_insert ()


@@ -197,7 +191,9 @@ all null bytes (\(aq\\0\(aq) except the last by
 .IR sep .
 .SH RETURN VALUE
 All argz functions that do memory allocation have a return type of
 .IR sep .
 .SH RETURN VALUE
 All argz functions that do memory allocation have a return type of

-\fIerror_t\fP, and return 0 for success, and \fBENOMEM\fP
+.IR error_t ,
+and return 0 for success, and
+.B ENOMEM

 if an allocation error occurs.
 .SH CONFORMING TO
 These functions are a GNU extension.
 if an allocation error occurs.
 .SH CONFORMING TO
 These functions are a GNU extension.


@@ -207,3 +203,12 @@ Argz vectors without a terminating null byte may lead to
 Segmentation Faults.
 .SH SEE ALSO
 .BR envz_add (3)
 Segmentation Faults.
 .SH SEE ALSO
 .BR envz_add (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/.