]> git.donarmstrong.com Git - perltidy.git/commitdiff
update docs
authorSteve Hancock <perltidy@users.sourceforge.net>
Thu, 20 Jul 2023 22:38:27 +0000 (15:38 -0700)
committerSteve Hancock <perltidy@users.sourceforge.net>
Thu, 20 Jul 2023 22:38:27 +0000 (15:38 -0700)
bin/perltidy

index 8c58b20639ebde7872aee38061324a0dafbbf3f9..ddb9af41faa710c8bb5f5d9c3dde8b26caf67754 100755 (executable)
@@ -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