[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[SCM] Debian package checker branch, master, updated. 2.3.3-76-ga3e4f5c



The following commit has been merged in the master branch:
commit 3b5f6e9075eeab206f73e3e197a54c530af66b08
Author: Jari Aalto <jari.aalto@cante.net>
Date:   Thu Mar 11 09:52:13 2010 +0200

    Explain more about TH NAME problems
    
    Signed-off-by: Jari Aalto <jari.aalto@cante.net>

diff --git a/checks/manpages.desc b/checks/manpages.desc
index 2a3de77..28bacfb 100644
--- a/checks/manpages.desc
+++ b/checks/manpages.desc
@@ -103,9 +103,11 @@ Tag: manpage-has-bad-whatis-entry
 Severity: normal
 Certainty: certain
 Info: Each manual page should start with a "NAME" section, which lists the
- name and a brief description of the page separated by "\-". These sections
- are parsed by "mandb" and stored in a database for the use of "apropos" and
- "whatis", so they must be in a certain format. This manual page apparently
+ name and a brief description of the page separated by "\-". A common mistake
+ is that in sections TH or NAME the entry is expressed with a space in form
+ "PROGRAM NAME", not "PROGRAM_NAME" or "PROGRAM-NAME". The TH and NAME sections
+ are parsed by mandb(8) and stored in a database for the use of apropos(1) and
+ whatis(1), so they must be in a certain format. This manual page apparently
  uses the wrong format and cannot be parsed by "mandb".
 Ref: lexgrog(1), groff_man(7), groff_mdoc(7)
 

-- 
Debian package checker


Reply to: