man-pages.7: Describe rules for capitalization in .SS headings

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-02-24 15:16:29 +01:00
parent c634028ab5
commit 159f0403b4
1 changed files with 6 additions and 1 deletions

View File

@ -25,7 +25,7 @@
.\" 2007-05-30 created by mtk, using text from old man.7 plus
.\" rewrites and additional text.
.\"
.TH MAN-PAGES 7 2013-02-18 "Linux" "Linux Programmer's Manual"
.TH MAN-PAGES 7 2013-02-24 "Linux" "Linux Programmer's Manual"
.SH NAME
man-pages \- conventions for writing Linux man pages
.SH SYNOPSIS
@ -502,6 +502,11 @@ Starting with release 2.59,
.I man-pages
follows American spelling conventions;
please write all new pages and patches according to these conventions.
.SS Capitalization
In subsection ("SS") headings
capitalize the first word in heading, but otherwise use lower case,
except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.
.SS Example programs and shell sessions
Manual pages can include example programs demonstrating how to
use a system call or library function.