remove extraneous blank lines in all three files, an
[unix-history] / usr / src / contrib / bib / man / invert.1
index bcbd7d5..7fa219e 100644 (file)
@@ -1,4 +1,6 @@
-.TH invert/lookup 1 local
+.\"    "@(#)invert.1   4.3     %G%";
+.TH INVERT 1 "28 July 1983"
+.UC 4
 .SH NAME
 invert, lookup \- create and access an inverted index
 .SH SYNOPSIS
 .SH NAME
 invert, lookup \- create and access an inverted index
 .SH SYNOPSIS
@@ -32,10 +34,9 @@ Each line of input is a retrieval request.
 All records that contain all of the keywords in the retrieval request
 are sent to
 .I stdout.
 All records that contain all of the keywords in the retrieval request
 are sent to
 .I stdout.
-If there are no matching references,
-"No references found." is sent to
+If there are no matching references, ``No references found.'' is sent to
 .I stdout.
 .I stdout.
-.I Lookup
+.I Lookup
 first searches in the user's private index (default INDEX)
 and then, if no references are found,
 in the system index (/usr/dict/papers/INDEX).
 first searches in the user's private index (default INDEX)
 and then, if no references are found,
 in the system index (/usr/dict/papers/INDEX).
@@ -53,31 +54,31 @@ Some lines of input are ignored for the purpose of collecting keywords.
 .PP
 The following options are available for
 .I invert:
 .PP
 The following options are available for
 .I invert:
-.IP "-c \fIfile\fP" 8m
+.IP "\-c \fIfile\fP" 8m
 .ns
 .ns
-.IP -c\fIfile\fP
+.IP \-c\fIfile\fP
 File contains common words, one per line.
 Common words are not used as keys.
 (Default /usr/lib/bmac/common.)
 File contains common words, one per line.
 Common words are not used as keys.
 (Default /usr/lib/bmac/common.)
-.IP "-k \fIi\fP"
+.IP "\-k \fIi\fP"
 .ns
 .ns
-.IP -k\fIi\fP
+.IP \-k\fIi\fP
 Maximum number of keys kept per record. (Default 100)
 Maximum number of keys kept per record. (Default 100)
-.IP "-l \fIi\fP"
+.IP "\-l \fIi\fP"
 .ns
 .ns
-.IP -l\fIi\fP
+.IP \-l\fIi\fP
 Maximum length of keys. (Default 6)
 Maximum length of keys. (Default 6)
-.IP "-p \fIfile\fP"
+.IP "\-p \fIfile\fP"
 .ns
 .ns
-.IP -p\fIfile\fP
+.IP \-p\fIfile\fP
 File is the name of the private index file (output of
 .IR invert ).
 (Default is INDEX.)
 The index must be stored in the current directory.
 (Be careful of the second form.
 The shell will not know to expand the file name.
 File is the name of the private index file (output of
 .IR invert ).
 (Default is INDEX.)
 The index must be stored in the current directory.
 (Be careful of the second form.
 The shell will not know to expand the file name.
-E.g. -p~/index won't work; use -p\ ~/index.)
-.IP -s
+E.g. \-p~/index won't work; use \-p\ ~/index.)
+.IP \-s
 Silent.
 Suppress statistics.
 .IP -%\fIstr\fP
 Silent.
 Suppress statistics.
 .IP -%\fIstr\fP
@@ -126,10 +127,10 @@ if no references are found.
 .LP
 .I Invert
 produces a one line message of the form,
 .LP
 .I Invert
 produces a one line message of the form,
-"%D\ documents\ \ \ %D distinct\ keys\ \ %D\ key\ occurrences".
-This can be suppressed with the -s option.
+\*(oq%D\ documents\ \ \ %D distinct\ keys\ \ %D\ key\ occurrences\*(cq.
+This can be suppressed with the \-s option.
 .LP
 .LP
-The message "locate: first key (%s) matched too many refs"
+The message \*(oqlocate: first key (%s) matched too many refs\*(cq
 indicates that the first key matched more references than could be stored
 in memory.
 The simple solution is to use a less frequently occurring key as the first
 indicates that the first key matched more references than could be stored
 in memory.
 The simple solution is to use a less frequently occurring key as the first
@@ -139,3 +140,6 @@ No attempt is made to check the compatibility between an index
 and the files indexed.
 The user must create a new index whenever
 the files that are indexed are modified.
 and the files indexed.
 The user must create a new index whenever
 the files that are indexed are modified.
+.LP
+Attempting to invert a file containing unprintable characters can
+cause chaos.