Reporting man-pages bugs

The way to report a bug depends on the type of bug:

• Simple one-line or two-line errors (typos, spelling, grammar, etc.), or HTML rendering problems in the online pages, can be reported by sending an email message to

  mtk.manpages-AT-gmail.com

  Please do not report such bugs to the mailing list, or via the bugzilla. Doing so creates unnecessary noise on the list and unnecessary bugzilla administrative overhead.
  
  
• For a more complex problem or error, if you know how to fix it, then, ideally, send a patch.
  
  
• If you believe there is a problem with a page, but don't know how to fix it, then there are two ways to report the bug:
  
  
  • Send a message to mtk.manpages-AT-gmail.com and CC linux-man-AT-vger.kernel.org.
    
    
  • Raise a bug report under the man-pages component of the kernel.org bugzilla. Doing this is especially preferred for difficult problems.

    You will need to create an account on this bugzilla if you don't already have one. This bugzilla is oriented towards Linux kernel bugs, so includes template text that is not relevant for most man-pages bug reports. Don't worry about reporting the Tree, Alias, or Kernel Version (just specify "n/a"), and you can ignore the template text under Description.

  
  When making a bug report please:
  
  
  • Mention the version of man-pages that you are using. (How do I find what man-pages version I have?)
    
    
  • Note the name and release of the distribution that you are using. This information is useful because some distributions apply patches to the man-pages package, and it may be that your bug report relates to text that is part of a downstream change.
    
    
  • Report logically separate bugs (even for the same page) as separate reports. This makes it possible to respond to the bugs in separate pieces.

Want to report a bug for a man page that belongs to a package other than man-pages? Look here.