manpage: use separate paragraphs for command syntax

manpage: use separate paragraphs for command syntax

[Jan Engelhardt]

commit c70cc8d8004b9571e85c2b33e85262f8238b3df3
Author: Jan Engelhardt <jengelh@medozas.de>
Date:   Tue Oct 28 14:07:10 2008 -0400

manpage: use separate paragraphs for command syntax

This makes it (IMO) easier to follow when the terminal is small and the
command line specifications begin to wrap.

Signed-off-by: Jan Engelhardt <jengelh@medozas.de>
---
 iptables.8.in |   18 +++++++++---------
 1 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/iptables.8.in b/iptables.8.in
index 9decfe7..1d2ffec 100644
--- a/iptables.8.in
+++ b/iptables.8.in
@@ -26,23 +26,23 @@
 iptables \- administration tool for IPv4 packet filtering and NAT
 .SH SYNOPSIS
 \fBiptables\fP [\fB-t\fP \fItable\fP] {\fB-A\fP|\fB-D\fP} \fIchain rule-specification\fP [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-I\fP [\fIrulenum\fP] \fIrule-specification\fP [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-R\fP \fIrulenum rule-specification\fP [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-D\fP \fIchain rulenum\fP [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-S\fP [\fIchain\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] {\fB-F\fP|\fB-L\fP|\fB-Z\fP} [\fIchain\fP] [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-N\fP \fIchain\fP
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-X\fP [\fIchain\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-P\fP \fIchain target\fP [\fIoptions...\fP]
-.br
+.PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-E\fP \fIold-chain-name new-chain-name\fP
 .SH DESCRIPTION
 \fBIptables\fP is used to set up, maintain, and inspect the

manpage: explain what rule-specification is

[Jan Engelhardt]

commit 7ce5d4839ec877440b2d1b58c2fcfa378fcc4cc7
Author: Jan Engelhardt <jengelh@medozas.de>
Date:   Tue Oct 28 14:59:19 2008 -0400

manpage: explain what rule-specification is

Signed-off-by: Jan Engelhardt <jengelh@medozas.de>
---
 iptables.8.in |   16 +++++++++++-----
 1 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/iptables.8.in b/iptables.8.in
index 1d2ffec..9947da4 100644
--- a/iptables.8.in
+++ b/iptables.8.in
@@ -25,13 +25,13 @@
 .SH NAME
 iptables \- administration tool for IPv4 packet filtering and NAT
 .SH SYNOPSIS
-\fBiptables\fP [\fB-t\fP \fItable\fP] {\fB-A\fP|\fB-D\fP} \fIchain rule-specification\fP [\fIoptions...\fP]
+\fBiptables\fP [\fB-t\fP \fItable\fP] {\fB-A\fP|\fB-D\fP} \fIchain\fP \fIrule-specification\fP
 .PP
-\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-I\fP [\fIrulenum\fP] \fIrule-specification\fP [\fIoptions...\fP]
+\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-I\fP [\fIrulenum\fP] \fIrule-specification\fP
 .PP
-\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-R\fP \fIrulenum rule-specification\fP [\fIoptions...\fP]
+\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-R\fP \fIrulenum rule-specification\fP
 .PP
-\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-D\fP \fIchain rulenum\fP [\fIoptions...\fP]
+\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-D\fP \fIchain rulenum\fP
 .PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-S\fP [\fIchain\fP]
 .PP
@@ -41,9 +41,15 @@ iptables \- administration tool for IPv4 packet filtering and NAT
 .PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-X\fP [\fIchain\fP]
 .PP
-\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-P\fP \fIchain target\fP [\fIoptions...\fP]
+\fBiptables\fP [\fB-t\fP \fItable\fP] \fB-P\fP \fIchain target\fP
 .PP
 \fBiptables\fP [\fB-t\fP \fItable\fP] \fB-E\fP \fIold-chain-name new-chain-name\fP
+.PP
+rule-specification = [\fImatches...\fP] [\fItarget\fP]
+.PP
+match = \fB-m\fP \fImatchname\fP [\fIper-match-options\fP]
+.PP
+target = \fB-j\fP \fItargetname\fP [\fIper-target-options\fP]
 .SH DESCRIPTION
 \fBIptables\fP is used to set up, maintain, and inspect the
 tables of IPv4 packet

Re: manpage: use separate paragraphs for command syntax

[Patrick McHardy]

Jan Engelhardt wrote:
> commit c70cc8d8004b9571e85c2b33e85262f8238b3df3
> Author: Jan Engelhardt <jengelh@medozas.de>
> Date:   Tue Oct 28 14:07:10 2008 -0400
> 
> manpage: use separate paragraphs for command syntax
> 
> This makes it (IMO) easier to follow when the terminal is small and the
> command line specifications begin to wrap.

Applied, thanks.

Re: manpage: explain what rule-specification is

[Patrick McHardy]

Jan Engelhardt wrote:
> commit 7ce5d4839ec877440b2d1b58c2fcfa378fcc4cc7
> Author: Jan Engelhardt <jengelh@medozas.de>
> Date:   Tue Oct 28 14:59:19 2008 -0400
> 
> manpage: explain what rule-specification is

Applied, thanks.