Imported from /srv/lorry/lorry-area/autogen/autogen-5.16.2.tar.gz.HEADautogen-5.16.2master

1 files changed, 45 insertions, 0 deletions

diff --git a/autoopts/optionLoadLine.3 b/autoopts/optionLoadLine.3
new file mode 100644
index 0000000..83556a7
--- /dev/null
+++ b/autoopts/optionLoadLine.3
@@ -0,0 +1,45 @@
+.TH optionLoadLine 3 2012-08-11 "" "Programmer's Manual"
+.\"  DO NOT EDIT THIS FILE   (optionLoadLine.3)
+.\"  
+.\"  It has been AutoGen-ed  August 11, 2012 at 09:44:56 AM by AutoGen 5.16.2
+.\"  From the definitions    ./funcs.def
+.\"  and the template file   agman3.tpl
+.SH NAME
+optionLoadLine - process a string for an option name and value
+.sp 1
+.SH SYNOPSIS
+
+#include <\fIyour-opts.h\fP>
+.br
+cc [...] -o outfile infile.c -l\fBopts\fP [...]
+.sp 1
+void \fBoptionLoadLine\fP(tOptions* \fIopts\fP, char const* \fIline\fP);
+.sp 1
+.SH DESCRIPTION
+This is a client program callable routine for setting options from, for
+example, the contents of a file that they read in.  Only one option may
+appear in the text.  It will be treated as a normal (non-preset) option.
+
+When passed a pointer to the option struct and a string, it will find
+the option named by the first token on the string and set the option
+argument to the remainder of the string.  The caller must NUL terminate
+the string.  The caller need not skip over any introductory hyphens.
+Any embedded new lines will be included in the option
+argument.  If the input looks like one or more quoted strings, then the
+input will be "cooked".  The "cooking" is identical to the string
+formation used in AutoGen definition files (@pxref{basic expression}),
+except that you may not use backquotes.
+.TP
+.IR opts
+program options descriptor
+.TP
+.IR line
+NUL-terminated text
+.sp 1
+.SH ERRORS
+Invalid options are silently ignored.  Invalid option arguments
+will cause a warning to print, but the function should return.
+.SH SEE ALSO
+The \fIinfo\fP documentation for the -l\fIopts\fP library.
+.br
+ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), optionFindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3), optionNextValue(3), optionOnlyUsage(3), optionProcess(3), optionRestore(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3), optionVersion(3), pathfind(3), strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),