VECARGS(3)

NAME
vecargs - command argument vector insertion routines

SYNOPSIS

DESCRIPTION
loads a string vector from lines in may be modified upon return. Each line in is treated as a new vector element. Lines with as the first character are comments. \newline joins consecutive lines. A string vector pointer is returned, 0 on error.

constructs a string vector by calling on the contents of the file named by The string vector pointer is returned, 0 on error.

constructs a string vector by calling on a copy of The string vector pointer is returned, 0 on error.

frees a string vector allocated by or

inserts the string vector (as returned by or between and sliding over. NULL and empty string args in are not copied. is called before the return. is returned if the insertion failed.

EXAMPLES
is commonly used to modify command from fixed files. For example, make(1) checks for the files and to modify its arguments on startup. Its a handy way to override default options on a directory by directory basis without modify the standard control files (Makefile in this case.)

CAVEATS
This paradigm is not recommended for all commands; only a few exceptions make sense.