extern/shorewall_code
1
0
Fork 1
mirror of https://gitlab.com/shorewall/code.git synced 2025-06-20 01:37:59 +02:00
Code Issues Packages Projects Releases Wiki Activity

Clarify line continuation WRT params and .conf

Browse Source 
Signed-off-by: Tom Eastep <teastep@shorewall.net>
This commit is contained in:
Tom Eastep 2017-03-17 19:13:29 -07:00
parent bdcf93f92c
commit ccf9d73c72
No known key found for this signature in database
GPG Key ID: 96E6B3F2423A4D10
1 changed files with 24 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/configuration_file_basics.xml
View File

@ -446,16 +446,13 @@ br0 - routeback</programlisting></para>
backslash (<quote>\</quote>) followed immediately by a new line character backslash (<quote>\</quote>) followed immediately by a new line character
(Enter key).</para> (Enter key).</para>
<example id="continuation">
<title>Line Continuation</title>
<programlisting>ACCEPT net $FW tcp \↵ <programlisting>ACCEPT net $FW tcp \↵
smtp,www,pop3,imap #Services running on the firewall</programlisting> smtp,www,pop3,imap #Services running on the firewall</programlisting>
<para>In certain cases, leading white space is ignored in continuation <para>In certain cases, leading white space is ignored in continuation
lines:</para> lines:</para>
<itemizedlist> <orderedlist>
<listitem> <listitem>
<para>The continued line ends with a colon (":")</para> <para>The continued line ends with a colon (":")</para>
</listitem> </listitem>
@ -463,7 +460,13 @@ smtp,www,pop3,imap #Services running on the firewall</programlisting>
<listitem> <listitem>
<para>The continued line ends with a comma (",")</para> <para>The continued line ends with a comma (",")</para>
</listitem> </listitem>
</itemizedlist> </orderedlist>
<important>
<para>What follows does NOT apply to <ulink
url="manpages/shorewall-params.html">shorewall-params(5)</ulink> and
<ulink url="shorewall.conf.html">shorewall.conf(5)</ulink>.</para>
</important>
<para>Example (<filename>/etc/shorewall/rules</filename>):</para> <para>Example (<filename>/etc/shorewall/rules</filename>):</para>
@ -479,7 +482,6 @@ ACCEPT net:\
"net:206.124.146.177,206.124.147.178,206.124.146.180". Because the third "net:206.124.146.177,206.124.147.178,206.124.146.180". Because the third
continuation line does not end with a comma or colon, the leading white continuation line does not end with a comma or colon, the leading white
space in the last line is not ignored.</para> space in the last line is not ignored.</para>
</example>
<important> <important>
<para>A trailing backslash is not ignored in a comment. So the continued <para>A trailing backslash is not ignored in a comment. So the continued