.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
Statistics
.XS
\*(SN Statistics
.XE
.PP
The notesfile system keeps statistics on where notes and responses
originate, the number of network accesses, duplications and orphaned 
responses.
Combined with the use of the log maintained by the notesfile
networking software, monitoring notesfile traffic is quite easy.
.PP
The
.B \-s
option specifies that only a summary is to be produced,
skipping the individual reports.
Wildcard constructs with '*', '?', '[', and ']' are
recognized by nfstats.
Invoke the statistics program with:
.DS
nfstats [ \-s ] topic1 [ ... ]
.DE
Typical output is:
.DS
             net.unix on hpisla at  10:22 am Jun 10, 1986
.TS
center, expand;
l l l l.
	NOTES	RESPS	TOTALS
Local Reads	422	279	701
Local Written	30	0	30
Networked in	408	318	726
Networked out	0	0	0
Network Dropped	153	112	265
.TE
Network Transmissions: 0  Network Receptions: 1714
Orphaned Responses Received: 30    Entries into notefile: 3577
Total time in notefile:   331.42 minutes
Average Time/entry:   0.09 minutes
Created at 11:34 am  Mar 7, 1986, Used on 92 days
.DE
A combined set of statistics is produced at the end of listings
of more than one notesfile.
The statistics are largely self explanatory.
.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.
