From f9c5b8b0d550a22974e348a1129c19f7c7a240fd Mon Sep 17 00:00:00 2001 From: Tom Eastep Date: Thu, 2 Jun 2011 06:23:37 -0700 Subject: [PATCH] Improve some comments Signed-off-by: Tom Eastep --- Shorewall/Perl/Shorewall/Chains.pm | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/Shorewall/Perl/Shorewall/Chains.pm b/Shorewall/Perl/Shorewall/Chains.pm index db80d1d28..f29e8c870 100644 --- a/Shorewall/Perl/Shorewall/Chains.pm +++ b/Shorewall/Perl/Shorewall/Chains.pm @@ -2920,7 +2920,9 @@ sub record_runtime_address( $ ) { # # If the passed address is a run-time address variable for an optional interface, then -# begin a conditional rule block that tests the address for nil. +# begin a conditional rule block that tests the address for nil. Returns 1 if a conditional +# block was opened. The caller stores the result, and if the result is true the caller +# invokes conditional_rule_end() when the conditional block is complete. # sub conditional_rule( $$ ) { my ( $chainref, $address ) = @_; @@ -2941,7 +2943,8 @@ sub conditional_rule( $$ ) { } # -# If end a conditional in a chain +# End a conditional in a chain begun by conditional_rule(). Should only be called +# if conditional_rule() returned true. # sub conditional_rule_end( $ ) {