.bp
.NH 1
Other Notesfile User Utilities
.XS
\*(SN Other Notesfile Utilities
.XE
.PP
The notesfile distribution includes utility programs to
provide hard copy output,
additional interfaces to user programs, and statistics.
They are described below.
.NH 2
Hard Copy Output
.XS
\*(SN Hard Copy Output
.XE
.PP
The program "nfprint" sends to standard output a nicely formatted listing of
the notesfile in its command line.  Its format is:
.DS
nfprint [\-lnn] [\-p] topic [ note# ] [ note#\-note# ] [ ... ]
.DE
The
.B \-l
option specifies an alternate page size (the default is 66).
The optional note number list specifies that only certain notes of the notesfile
are to be printed.  The list can specify individual notes and ranges.
The notes are printed in the order specified.
.NH 2
Insertion of Notes (from another program)
.XS
\*(SN Insertion of Notes
.XE
.PP
The inews program allows text from the standard input to be sent
to a notesfile:
.DS
/usr/lib/notes/inotes [\-n topic] [\-t title] [ \-d ] [ \-a ]
.DE
The
.B \-n
option allows specification of a notesgroup.
The
.B \-t
option allows specification of a title.  The
.B \-d
and
.B \-a
options specify the director and anonymous flags respectively (if available).
.PP
It is expected that inotes will be called by a front end program
which provides a friendlier user interface.
.NH 2
Checking for new notes
.XS
\*(SN Checking for new notes
.XE
.PP
The checknotes program checks if there are new notes.
The exit code is arranged to make the program useful in shell scripts:
0 (TRUE) is there are new notes, 1 (FALSE) otherwise.
.PP
Use the
.B \-q
option to receive a message
.DS
There are new notes
.DE
if one or more of the notesfiles have notes/responses written since
the user's last entry time into that notesfile.
.PP
The
.B \-n
option is similar to the
.B \-q
option, with the exception
that it yields output when there are no new notes. The output
of checknotes with the
.B \-n
option is:
.DS
There are no new notes
.DE
.PP
Use
.B \-v
to print the name of each notesfile with new 
notes/responses. The
.B \-s
option is suited for use conditional
expressions in shell scripts; no output is generated by this option.
