From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from localhost (fantadrom.bsd.lv [local]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTPA id 16dbf836 for ; Sat, 9 Mar 2019 10:55:31 -0500 (EST) Date: Sat, 9 Mar 2019 10:55:31 -0500 (EST) X-Mailinglist: mandoc-source Reply-To: source@mandoc.bsd.lv MIME-Version: 1.0 From: schwarze@mandoc.bsd.lv To: source@mandoc.bsd.lv Subject: mandoc: Mention mandoc.db(5), makewhatis(8), and weekly(8). X-Mailer: activitymail 1.26, http://search.cpan.org/dist/activitymail/ Content-Type: text/plain; charset=utf-8 Message-ID: Log Message: ----------- Mention mandoc.db(5), makewhatis(8), and weekly(8). Omission noticed by espie@ long ago, and wording tweaked by jmc@. Modified Files: -------------- mandoc: man.1 Revision Data ------------- Index: man.1 =================================================================== RCS file: /home/cvs/mandoc/mandoc/man.1,v retrieving revision 1.34 retrieving revision 1.35 diff -Lman.1 -Lman.1 -u -p -r1.34 -r1.35 --- man.1 +++ man.1 @@ -218,12 +218,24 @@ Guidelines for writing man pages can be found in .Xr mdoc 7 . .Pp +The +.Xr mandoc.db 5 +database is used for looking up manual page entries. +In cases where the database is absent, outdated, or corrupt, +.Nm +falls back to looking for files called +.Ar name . Ns Ar section . If both a formatted and an unformatted version of the same manual page, for example .Pa cat1/foo.0 and .Pa man1/foo.1 , exist in the same directory, only the unformatted version is used. +The database is kept up to date with +.Xr makewhatis 8 , +which is run by the +.Xr weekly 8 +maintenance script. .Sh ENVIRONMENT .Bl -tag -width MANPATHX .It Ev MACHINE -- To unsubscribe send an email to source+unsubscribe@mandoc.bsd.lv