d0p1/ack
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

some improvements to manual page and interface

Browse source
This commit is contained in:
ceriel 1988-09-22 16:09:18 +00:00
parent 9435c895bf
commit b533b53690
2 changed files with 7 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
modules/src/input/inp_pkg.body
View file

@ -306,7 +306,7 @@ InsertFile(filnam, table, result)
} }
#endif INP_READ_IN_ONE #endif INP_READ_IN_ONE
bh->bh_fd = fd; /* this is a file */ bh->bh_fd = fd; /* this is a file */
*result = filnam; if (result) *result = filnam;
return 1; return 1;
} }
return 0; return 0;

7
modules/src/input/input.3
View file

@ -106,15 +106,20 @@ The next input characters will be obtained from the specified file
\fIfilename\fR. \fIfilename\fR.
This file will be looked for in the directories, mentioned in the This file will be looked for in the directories, mentioned in the
null-terminated list \fItable\fR. null-terminated list \fItable\fR.
When \fItable\fR is 0, only the current directory is searched. When it is not,
perhaps it is wise to include "." in the table ...
When \fIfilename\fR starts with a "/", \fItable\fR is not used.
If \fIfilename\fR is a null pointer, standard input is used. In this case, If \fIfilename\fR is a null pointer, standard input is used. In this case,
the package may not have been instantiated with INP_READ_IN_ONE defined. the package may not have been instantiated with INP_READ_IN_ONE defined.
\fIInsertFile\fR returns 1 if it succeeds, 0 if it fails. \fIInsertFile\fR returns 1 if it succeeds, 0 if it fails.
When it succeeds, it stores the file name in the \fIresult\fR parameter. When it succeeds, and \fIresult\fR is not 0, it stores the file name in the \fIresult\fR parameter.
.PP .PP
The routine \fIInsertText\fR also suspends input from the current input stream. The routine \fIInsertText\fR also suspends input from the current input stream.
The next input characters will be obtained from the string \fItext\fR, The next input characters will be obtained from the string \fItext\fR,
which is \fIlength\fR characters long. which is \fIlength\fR characters long.
\fIInsertText\fR returns 1 if it succeeds, 0 if it fails. \fIInsertText\fR returns 1 if it succeeds, 0 if it fails.
The \fItext\fR string is not copied, so it should not be changed until the
corresponding \fIAtEoIT\fR isd called.
.PP .PP
The routine \fIAtEoIF\fR is called at the end of the input stream The routine \fIAtEoIF\fR is called at the end of the input stream
inserted by \fIInsertFile\fR. inserted by \fIInsertFile\fR.