aboutsummaryrefslogtreecommitdiffstats
path: root/man7/man-pages.7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2013-02-24 15:16:29 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2013-02-24 15:16:29 +0100
commit159f0403b454bf677403d99d889eb4a65da26b61 (patch)
tree136fa269c61dd985dafad173a7b6f338b8159711 /man7/man-pages.7
parentc634028ab5768a042196fd71a38088499b21de12 (diff)
downloadman-pages-159f0403b454bf677403d99d889eb4a65da26b61.tar.gz
man-pages.7: Describe rules for capitalization in .SS headings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man7/man-pages.7')
-rw-r--r--man7/man-pages.77
1 files changed, 6 insertions, 1 deletions
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index e279014ec5..390986810c 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -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.