From: Steve Hancock <perltidy@users.sourceforge.net> Date: Thu, 20 Jul 2023 22:38:27 +0000 (-0700) Subject: update docs X-Git-Tag: 20230701.02~12 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=827e394d87f2c54c86ecf368d3101891dac8ffe3;p=perltidy.git update docs --- diff --git a/bin/perltidy b/bin/perltidy index 8c58b206..ddb9af41 100755 --- a/bin/perltidy +++ b/bin/perltidy @@ -2296,14 +2296,16 @@ The default is equivalent to -cse='#>>V'. =head2 Formatting a Limited Range of Lines -A command B<--line-range-tidy=n1:n2> is available to pass just a selected range -of lines to perltidy. This command is mainly of interest to interactive -code editors. When it is used, just the selected range of lines are passed -through the perltidy tokenizer and formatter, so they need to contain a -complete statement or balanced container. Otherwise, a syntax error will occur -and the code will not be tidied. There are a couple of limitations -on the use of this command: (1) it may not be applied to multiple files, and -(2) it only applies to code tidying and not, for example, html formatting. +A command B<--line-range-tidy=n1:n2> is available to process just a selected +range of lines of an input stream with perltidy. This command is mainly of +interest for programming interactive code editors. When it is used, the entire +input stream is read but just the selected range of lines of the input file are +processed by the perltidy tokenizer and formatter, and then the stream is +reassembled for output. The selected lines need to contain a complete statement +or balanced container. Otherwise, a syntax error will occur and the code will +not be tidied. There are a couple of limitations on the use of this command: +(1) it may not be applied to multiple files, and (2) it only applies to code +tidying and not, for example, html formatting. =over 4