From ef8c5dffc0834b98641fcf91dedc098c9d28845d Mon Sep 17 00:00:00 2001 From: Steve Hancock Date: Fri, 23 Jul 2021 07:30:49 -0700 Subject: [PATCH] clarify behavior of format-skipping and code-skipping --- bin/perltidy | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/bin/perltidy b/bin/perltidy index 606f879b..866cec05 100755 --- a/bin/perltidy +++ b/bin/perltidy @@ -1994,6 +1994,13 @@ this: Additional text may appear on the special comment lines provided that it is separated from the marker by at least one space, as in the above examples. +Any number of code-skipping or format-skipping sections may appear in a file. +If an opening code-skipping or format-skipping comment is not followed by a +corresponding closing comment, then skipping continues to the end of the file. +If a closing code-skipping or format-skipping comment appears in a file but +does not follow a corresponding opening comment, then it is treated as an +ordinary comment without any special meaning. + It is recommended to use B<--code-skipping> only if you need to hide a block of an extended syntax which would produce errors if parsed by perltidy, and use B<--format-skipping> otherwise. This is because the B<--format-skipping> -- 2.39.5