[BACK]Return to makewhatis.1 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/Attic/makewhatis.1 between version 1.7 and 1.13

version 1.7, 2011/06/25 13:19:25 version 1.13, 2011/07/11 21:56:06
Line 22 
Line 22 
 .Nd index UNIX manuals  .Nd index UNIX manuals
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm  .Nm
 .Op Fl v  .Op Fl ruv
 .Op Fl d Ar dir  .Op Fl d Ar dir
 .Ar  .Ar
 .Sh DESCRIPTION  .Sh DESCRIPTION
Line 42  or
Line 42  or
 .Xr man 7  .Xr man 7
 .Ux  .Ux
 manual format.  manual format.
   .It Fl r
   Remove entries.
   This will remove the index and keyword references.
   If the record is not found, it is ignored.
   .It Fl u
   Update the record.
   This will first remove the record (as in
   .Fl r )
   then re-add it.
 .It Fl v  .It Fl v
 Verbose output.  Verbose output.
 If specified once, prints the name of each indexed file.  If specified once, prints the name of each indexed file.
Line 50  If twice, prints keywords for each file.
Line 59  If twice, prints keywords for each file.
 .Pp  .Pp
 By default,  By default,
 .Nm  .Nm
 constructs the  constructs a new
 .Sx Index Database  .Sx Index Database
 and  and
 .Sx Keyword Database  .Sx Keyword Database
 in the current working directory.  in the current working directory.
   Existing databases are truncated.
 .Pp  .Pp
 If fatal parse errors are encountered, the offending file is printed to  If fatal parse errors are encountered, the offending file is printed to
 stderr, omitted from the index, and the parse continues with the next  stderr, omitted from the index, and the parse continues with the next
Line 118  Free-form descriptive text as given in the NAME sectio
Line 128  Free-form descriptive text as given in the NAME sectio
 Cross-links between manuals.  Cross-links between manuals.
 Listed as the link name, then a period, then the link section.  Listed as the link name, then a period, then the link section.
 If the link has no section, the period terminates the string.  If the link has no section, the period terminates the string.
   .It Li 0x400
   Path reference as given in the FILES section.
   .It Li 0x800
   Environment variable as given in the ENVIRONMENT section.
   .It Li 0x1000
   Error codes as given in the ERRORS section.
 .El  .El
 .Pp  .Pp
 The last four bytes are a host-ordered record number within the  The last four bytes are a host-ordered record number within the
Line 127  The
Line 143  The
 .Nm  .Nm
 utility is  utility is
 .Ud  .Ud
   .Sh IMPLEMENTATION NOTES
   The time to construct a new database pair grows linearly with the
   number of keywords in the input.
   However, removing or updating entries with
   .Fl r
   or
   .Fl u ,
   respectively, grows as a multiple of the index length and input size.
 .Sh FILES  .Sh FILES
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Pa mandoc.db  .It Pa mandoc.db
Line 134  A
Line 158  A
 .Xr btree 3  .Xr btree 3
 keyword database mapping keywords to a type and file reference in  keyword database mapping keywords to a type and file reference in
 .Pa mandoc.index .  .Pa mandoc.index .
 .It Pa mandoc.db~  
 Working copy of  
 .Pa mandoc.db .  
 .It Pa mandoc.index  .It Pa mandoc.index
 A  A
 .Xr recno 3  .Xr recno 3
 database of indexed file-names.  database of indexed file-names.
 .It Pa mandoc.index~  
 Working copy of  
 .Pa mandoc.index .  
 .El  .El
 .Sh EXIT STATUS  .Sh EXIT STATUS
 .Ex -std  The
   .Nm
   utility exits with one of the following values:
   .Pp
   .Bl -tag -width Ds -compact
   .It 0
   No errors occurred.
   .It 5
   Invalid command line arguments were specified.
   No input files have been read.
   .It 6
   An operating system error occurred, for example memory exhaustion or an
   error accessing input files.
   Such errors cause
   .Nm
   to exit at once, possibly in the middle of parsing or formatting a file.
   The output databases are corrupt and should be removed .
   .El
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr mandoc 1  .Xr mandoc 1
 .Sh AUTHORS  .Sh AUTHORS
Legend:
Removed from v.1.7  
changed lines
  Added in v.1.13
CVSweb