Mercurial > hg > forks > UniversalIndentGUI
changeset 477:ce6cd144159d
Because no values are written back to the uigui ini files anymore since version 0.8.0, the section/group names are no longer reordered nor renamed. So I do not use a "%20" prepended to the section name "[header]".
git-svn-id: svn://svn.code.sf.net/p/universalindent/code/trunk@717 59b1889a-e5ac-428c-b0c7-476e01d41282
| author | thomas_-_s <thomas_-_s@59b1889a-e5ac-428c-b0c7-476e01d41282> |
|---|---|
| date | Fri, 06 Jun 2008 10:18:15 +0000 |
| parents | b5584fff7844 |
| children | 5417f9e5f6e5 |
| files | doc/iniFileFormat.html indenters/uigui_CblBeau.ini indenters/uigui_astyle.ini indenters/uigui_bcpp.ini indenters/uigui_csstidy.ini indenters/uigui_gnuindent.ini indenters/uigui_greatcode.ini indenters/uigui_hindent.ini indenters/uigui_htb.ini indenters/uigui_jsdecoder.ini indenters/uigui_perltidy.ini indenters/uigui_phpCB.ini indenters/uigui_phpStylist.ini indenters/uigui_php_Beautifier.ini indenters/uigui_shellindent.ini indenters/uigui_tidy.ini indenters/uigui_uncrustify.ini src/indenthandler.cpp |
| diffstat | 18 files changed, 178 insertions(+), 179 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/iniFileFormat.html Thu Jun 05 12:30:51 2008 +0000 +++ b/doc/iniFileFormat.html Fri Jun 06 10:18:15 2008 +0000 @@ -14,10 +14,9 @@ <br> 2. Ini file header<br> ------------------<br> -At the beginning of the ini file the header is located. It is named [%20header]. You might wonder why I use the "%20" before the header. The reason for this is, that Qt, which I use as programming framework, automatically sorts the ini file by the group names in alphabetical order. To have the header at the beginning of each ini file I use "%20", it stands for a space. So nothing important about this.<br> -Following a ini file header is shown:<br> +At the beginning of the ini file the header is located. It is named [header]. In the following a ini file header is shown:<br> <pre> -[%20header] +[header] categories=Predefined Style|Tab and Bracket|Indentation|Formatting cfgFileParameterEnding=cr configFilename=.astylerc
--- a/indenters/uigui_CblBeau.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_CblBeau.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories="Cobol Beautifier|Renumbering|Generic Reporting|Cobol Dialects|Extra Features|Copy Libraries|Parser Messages|Length and Offset|PrettyPrint Basics|PrettyPrint Indentation|Output Comments|Line Identification" cfgFileParameterEnding=" " configFilename=
--- a/indenters/uigui_astyle.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_astyle.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=Predefined Style|Tab and Bracket|Indentation|Formatting cfgFileParameterEnding=cr configFilename=.astylerc @@ -16,7 +16,7 @@ useCfgFileParameter="--options=" version=1.21 -[bracket%20style] +[bracket style] Category=1 Choices="--brackets=break|--brackets=attach|--brackets=linux" ChoicesReadable=Break brackets|Attach brackets|Break brackets Linux like @@ -26,7 +26,7 @@ Value=0 ValueDefault=0 -[brackets%3Dbreak-closing] +[brackets-break-closing] Category=1 Description=<html>Breaks closing headers from their immediately preceding closing brackets.</html> EditorType=boolean @@ -74,7 +74,7 @@ Value=0 ValueDefault=0 -[force%20indent%20tab] +[force indent tab] CallName="--force-indent=tab=" Category=1 Description="<html>Indent using tab characters. Uses tabs as indents where --indent=tab prefers to use spaces such as inside multi-line statements. </html>" @@ -85,7 +85,7 @@ Value=4 ValueDefault=4 -[indent%20blocks] +[indent blocks] Category=2 Description=<html>Add extra indentation to entire blocks.</html> EditorType=boolean @@ -93,7 +93,7 @@ Value=0 ValueDefault=0 -[indent%20brackets] +[indent brackets] Category=2 Description=<html>Add extra indentation to brackets.</html> EditorType=boolean @@ -101,7 +101,7 @@ Value=0 ValueDefault=0 -[indent%20cases] +[indent cases] Category=2 Description=<html>Indent 'case X:' blocks from the 'case X:' headers. Case statements not enclosed in blocks are NOT indented.</html> EditorType=boolean @@ -109,7 +109,7 @@ Value=0 ValueDefault=0 -[indent%20classes] +[indent classes] Category=2 Description=<html>Indent 'class' blocks so that the headers 'public:' 'protected:' and 'private:' are indented in the class block.</html> EditorType=boolean @@ -117,7 +117,7 @@ Value=0 ValueDefault=0 -[indent%20lables] +[indent lables] Category=2 Description=<html>Add extra indentation to labels so they appear 1 indent less than the current indentation rather than being flushed to the left (the default).</html> EditorType=boolean @@ -125,7 +125,7 @@ Value=0 ValueDefault=0 -[indent%20namespaces] +[indent namespaces] Category=2 Description=<html>Add extra indentation to namespaces.</html> EditorType=boolean @@ -133,7 +133,7 @@ Value=0 ValueDefault=0 -[indent%20preprocessor] +[indent preprocessor] Category=2 Description=<html>Indent multi-line preprocessor definitions. should be used with --convert-tabs for proper results. Does a pretty good job but can not perform miracles in obfuscated preprocessor definitions.</html> EditorType=boolean @@ -141,7 +141,7 @@ Value=0 ValueDefault=0 -[indent%20spaces] +[indent spaces] CallName="--indent=spaces=" Category=1 Description=<html>Indent using # spaces per indent</html> @@ -152,7 +152,7 @@ Value=4 ValueDefault=4 -[indent%20switches] +[indent switches] Category=2 Description=<html>Indent 'switch' blocks so that the 'case X:' headers are indented in the switch block.</html> EditorType=boolean @@ -160,7 +160,7 @@ Value=0 ValueDefault=0 -[indent%20tab] +[indent tab] CallName="--indent=tab=" Category=1 Description=<html>Indent using tab characters. Treat each tab as # spaces</html> @@ -250,7 +250,7 @@ Value=0 ValueDefault=0 -[predefined%20style] +[predefined style] Category=0 Choices="--style=ansi|--style=gnu|--style=java|--style=kr|--style=linux" Description=<html>Sets the general style.</html>
--- a/indenters/uigui_bcpp.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_bcpp.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=Indentation|Comments|General cfgFileParameterEnding=cr configFilename=bcpp.cfg
--- a/indenters/uigui_csstidy.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_csstidy.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=General cfgFileParameterEnding=" " configFilename= @@ -16,7 +16,7 @@ useCfgFileParameter= version=2006-05-18 -[Add%20Timestamp] +[Add Timestamp] Category=0 Description=<html>Add Timestamp.</html> EditorType=boolean @@ -24,7 +24,7 @@ Value=1 ValueDefault=0 -[Allow%20HTML%20in%20templates] +[Allow HTML in templates] Category=0 Description=<html>Allow HTML in templates.</html> EditorType=boolean @@ -32,7 +32,7 @@ Value=0 ValueDefault=1 -[Case%20for%20properties] +[Case for properties] Category=0 Choices="--case_properties=0|--case_properties=1|--case_properties=2" Description=<html><pre> 0 - None.<br> 1 - Lowercase.<br> 2 - Uppercase.</pre></html> @@ -41,7 +41,7 @@ Value=1 ValueDefault=1 -[Compress%20colors] +[Compress colors] Category=0 Description=<html>Compress colors.</html> EditorType=boolean @@ -49,7 +49,7 @@ Value=1 ValueDefault=1 -[Compress%20font-weight] +[Compress font-weight] Category=0 Description=<html>Compress font weight.</html> EditorType=boolean @@ -57,7 +57,7 @@ Value=1 ValueDefault=1 -[Lowercase%20selectors] +[Lowercase selectors] Category=0 Description=<html>Lowercase selectors names needed for XHTML.</html> EditorType=boolean @@ -65,7 +65,7 @@ Value=0 ValueDefault=0 -[Optimise%20shorthands] +[Optimise shorthands] Category=0 Choices="--optimise_shorthands=0|--optimise_shorthands=1|--optimise_shorthands=2" Description=<html><pre> 0 - Do not optimise.<br> 1 - Safe optimisations.<br> 2 - All optimisations.</pre></html> @@ -74,7 +74,7 @@ Value=1 ValueDefault=1 -[Preserve%20CSS] +[Preserve CSS] Category=0 Description="<html>Save comments, hacks, etc.<br>Most optimisations can NOT be applied if this is enabled.</html>" EditorType=boolean @@ -82,7 +82,7 @@ Value=0 ValueDefault=0 -[Regroup%20selectors] +[Regroup selectors] Category=0 Choices="--merge_selectors=0|--merge_selectors=1|--merge_selectors=2" Description="<html><pre> 0 - Do not change anything<br> 1 - Only seperate selectors (split at , )<br> 2 - Merge selectors with the same properties (fast)</pre></html>" @@ -91,7 +91,7 @@ Value=2 ValueDefault=2 -[Remove%20last%20semikolon] +[Remove last semikolon] Category=0 Description="<html>Remove last ;</html>" EditorType=boolean @@ -99,7 +99,7 @@ Value=0 ValueDefault=0 -[Remove%20unnecessary%20backslashes] +[Remove unnecessary backslashes] Category=0 Description=<html>Remove backslashes.</html> EditorType=boolean @@ -107,7 +107,7 @@ Value=1 ValueDefault=1 -[Sort%20properties] +[Sort properties] Category=0 Description=<html>Sort properties.</html> EditorType=boolean @@ -115,7 +115,7 @@ Value=0 ValueDefault=0 -[Sort%20selectors%20%28caution%29] +[Sort selectors %28caution%29] Category=0 Description=<html><strong>Attention:</strong> This may change the behavior of your CSS code!</html> EditorType=boolean
--- a/indenters/uigui_gnuindent.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_gnuindent.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=General|Blank lines|Comments|Statements|Declarations|Indentation|Breaking long lines cfgFileParameterEnding=cr configFilename=.indent.pro @@ -16,7 +16,7 @@ useCfgFileParameter=none version=2.2.9 -[ANSI%20style%20formatting] +[ANSI style formatting] Category=0 Description=<html>original Berkeley indent</html> EditorType=boolean @@ -24,7 +24,7 @@ Value=1 ValueDefault=0 -[GNU%20style%20formatting] +[GNU style formatting] Category=0 Description=<html>GNU style formatting/indenting.</html> EditorType=boolean @@ -32,7 +32,7 @@ Value=1 ValueDefault=0 -[KR%20style%20formatting] +[KR style formatting] Category=0 Description=<html>Kernighan&Ritchie style formatting/indenting.</html> EditorType=boolean
--- a/indenters/uigui_greatcode.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_greatcode.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=General|Space|Code|Statements|Pre-Processor|Comments|Miscellaneous cfgFileParameterEnding=cr configFilename=gc.cfg
--- a/indenters/uigui_hindent.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_hindent.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=Basic Options cfgFileParameterEnding=cr configFilename=
--- a/indenters/uigui_htb.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_htb.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=Basic Options cfgFileParameterEnding=cr configFilename=
--- a/indenters/uigui_jsdecoder.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_jsdecoder.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories= cfgFileParameterEnding=cr configFilename=
--- a/indenters/uigui_perltidy.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_perltidy.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=Styles|Basic Options|Code Indentation Control|Whitespace Control|Comment Controls|Skip Selected Codesections|Line Break Control|Controlling List Formatting|Retaining or Ignoring Existing Line Breaks|Blank Line Control|Other Controls cfgFileParameterEnding=cr configFilename=perltidy.cfg @@ -16,7 +16,7 @@ useCfgFileParameter="-pro=" version=2007-12-05 -[Add%20newlines] +[Add newlines] Category=6 Description="<html><dd><p>By default, perltidy will add line breaks when necessary to create continuations of long lines and to improve the script appearance. Use <strong>-nanl</strong> or <strong>--noadd-newlines</strong> to prevent any new line breaks.</p></dd><dd><p>This flag does not prevent perltidy from eliminating existing line breaks; see <strong>--freeze-newlines</strong> to completely prevent changes to line break points.</p></dd></html>" EditorType=boolean @@ -24,7 +24,7 @@ Value=0 ValueDefault=0 -[Add%20semicolons] +[Add semicolons] Category=3 Description="<html><dd><p>Setting <strong>-asc</strong> allows perltidy to add any missing optional semicolon at the end of a line which is followed by a closing curly brace on the next line. This is the default, and may be deactivated with <strong>-nasc</strong> or <strong>--noadd-semicolons</strong>.</p></dd></html>" EditorType=boolean @@ -32,7 +32,7 @@ Value=0 ValueDefault=0 -[Add%20whitespace] +[Add whitespace] Category=3 Description="<html><dd><p>Setting this option allows perltidy to add certain whitespace improve code readability. This is the default. If you do not want any whitespace added, but are willing to have some whitespace deleted, use <strong>-naws</strong>. (Use <strong>-fws</strong> to leave whitespace completely unchanged).</p></dd></html>" EditorType=boolean @@ -40,7 +40,7 @@ Value=0 ValueDefault=0 -[Block%20brace%20tightness] +[Block brace tightness] CallName="--block-brace-tightness=" Category=3 Description="<html><p>And finally, curly braces which contain blocks of code are controlled by the parameter <strong>-bbt=n</strong> or <strong>--block-brace-tightness=n</strong> as illustrated in the example below.</p></dd><dd><pre>\n %bf = map { $_ => -M $_ } grep { /deb$/ } dirents '.'; # -bbt=0 (default)\n %bf = map { $_ => -M $_ } grep {/deb$/} dirents '.'; # -bbt=1\n %bf = map {$_ => -M $_} grep {/deb$/} dirents '.'; # -bbt=2</pre></dd></html>" @@ -51,7 +51,7 @@ Value=1 ValueDefault=1 -[Block%20brace%20vertical%20tightness] +[Block brace vertical tightness] CallName="--block-brace-vertical-tightness=" Category=6 Description="<html><dd><p>The <strong>-bbvt=n</strong> flag is just like the <strong>-vt=n</strong> flag but applies to opening code block braces.</p></dd><dd><pre>\n -bbvt=0 break after opening block brace (default). \n -bbvt=1 do not break unless this would produce more than one \n step in indentation in a line.\n -bbvt=2 do not break after opening block brace.</pre></dd><dd><p>It is necessary to also use either <strong>-bl</strong> or <strong>-bli</strong> for this to work, because, as with other vertical tightness controls, it is implemented by simply overwriting a line ending with an opening block brace with the subsequent line. For example:</p></dd><dd><pre>\n # perltidy -bli -bbvt=0\n if ( open( FILE, "< $File" ) )\n {\n while ( $File = <FILE> )\n {\n $In .= $File;\n $count++;\n }\n close(FILE);\n }</pre></dd><dd><pre>\n # perltidy -bli -bbvt=1\n if ( open( FILE, "< $File" ) )\n { while ( $File = <FILE> )\n { $In .= $File;\n $count++;\n }\n close(FILE);\n }</pre></dd><dd><p>By default this applies to blocks associated with keywords <strong>if</strong>, <strong>elsif</strong>, <strong>else</strong>, <strong>unless</strong>, <strong>for</strong>, <strong>foreach</strong>, <strong>sub</strong>, <strong>while</strong>, <strong>until</strong>, and also with a preceding label. This can be changed with the parameter <strong>-bbvtl=string</strong>, or <strong>--block-brace-vertical-tightness-list=string</strong>, where <strong>string</strong> is a space-separated list of block types. For more information on the possible values of this string, see <a href=#specifying_block_types>Specifying Block Types</a></p></dd><dd><p>For example, if we want to just apply this style to <code>if</code>, <code>elsif</code>, and <code>else</code> blocks, we could use <code>perltidy -bli -bbvt=1 -bbvtl='if elsif else'</code>.</p></dd><dd><p>There is no vertical tightness control for closing block braces; with the exception of one-line blocks, they will normally remain on a separate line.</p></dd></html>" @@ -62,7 +62,7 @@ Value=0 ValueDefault=0 -[Brace%20left%20and%20indent] +[Brace left and indent] Category=6 Description="<html><dd><p>The flag <strong>-bli</strong> is the same as <strong>-bl</strong> but in addition it causes one unit of continuation indentation ( see <strong>-ci</strong> ) to be placed before an opening and closing block braces.</p></dd><dd><p>For example,</p></dd><dd><pre>\n if ( $input_file eq '-' ) # -bli\n {\n important_function();\n }</pre></dd><dd><p>By default, this extra indentation occurs for blocks of type:<strong>if</strong>, <strong>elsif</strong>, <strong>else</strong>, <strong>unless</strong>, <strong>for</strong>, <strong>foreach</strong>, <strong>sub</strong>, <strong>while</strong>, <strong>until</strong>, and also with a preceding label. The next item shows how to change this.</p></dd></html>" EditorType=boolean @@ -70,7 +70,7 @@ Value=0 ValueDefault=0 -[Brace%20left%20and%20indent%20list] +[Brace left and indent list] CallName="--brace-left-and-indent-list=" Category=6 Description="<html><dd><p>Use this parameter to change the types of block braces for which the <strong>-bli</strong> flag applies; see <a href=#specifying_block_types>Specifying Block Types</a>. For example, <strong>-blil='if elsif else'</strong> would apply it to only <code>if/elsif/else</code> blocks.</p></dd></html>" @@ -79,7 +79,7 @@ Value= ValueDefault= -[Brace%20tightness] +[Brace tightness] CallName="--brace-tightness=" Category=3 Description="<html><p>Curly braces which do not contain code blocks are controlled by the parameter <strong>-bt=n</strong> or <strong>--brace-tightness=n</strong>.</p></dd><dd><pre>\n $obj->{ $parsed_sql->{ 'table' }[0] }; # -bt=0\n $obj->{ $parsed_sql->{'table'}[0] }; # -bt=1 (default)\n $obj->{$parsed_sql->{'table'}[0]}; # -bt=2</pre></dd></html>" @@ -90,7 +90,7 @@ Value=1 ValueDefault=1 -[Brace%20vertical%20tightness] +[Brace vertical tightness] CallName="--brace-vertical-tightness=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -101,7 +101,7 @@ Value=0 ValueDefault=0 -[Brace%20vertical%20tightness%20closing] +[Brace vertical tightness closing] CallName="--brace-vertical-tightness-closing=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -112,7 +112,7 @@ Value=0 ValueDefault=0 -[Break%20after%20all%20operators] +[Break after all operators] Category=6 Description="<html><dd><p>The -baao sets the default to be to break after all of the following operators:</p></dd><dd><pre>\n % + - * / x != == >= <= =~ !~ < > | & \n = **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=\n . : ? && || and or err xor</pre></dd><dd><p>and the <strong>-bbao</strong> flag sets the default to break before all of these operators. These can be used to define an initial break preference which can be fine-tuned with the <strong>-wba</strong> and <strong>-wbb</strong> flags. For example, to break before all operators except an <strong>=</strong> one could use --bbao -wba='=' rather than listing every single perl operator except <strong>=</strong> on a -wbb flag.</p></dd></html>" EditorType=boolean @@ -120,7 +120,7 @@ Value=0 ValueDefault=0 -[Break%20before%20all%20operators] +[Break before all operators] Category=6 Description="<html><dd><p>The -baao sets the default to be to break after all of the following operators:</p></dd><dd><pre>\n % + - * / x != == >= <= =~ !~ < > | & \n = **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=\n . : ? && || and or err xor</pre></dd><dd><p>and the <strong>-bbao</strong> flag sets the default to break before all of these operators. These can be used to define an initial break preference which can be fine-tuned with the <strong>-wba</strong> and <strong>-wbb</strong> flags. For example, to break before all operators except an <strong>=</strong> one could use --bbao -wba='=' rather than listing every single perl operator except <strong>=</strong> on a -wbb flag.</p></dd></html>" EditorType=boolean @@ -128,7 +128,7 @@ Value=0 ValueDefault=0 -[Check%20syntax] +[Check syntax] Category=1 Description="<html>This flag causes perltidy to run <code>perl -c -T</code> to check syntax of input and output. (To change the flags passed to perl, see the next item, <strong>-pscf</strong>). The results are written to the <em>.LOG</em> file, which will be saved if an error is detected in the output script. The output script is not checked if the input script has a syntax error. Perltidy does its own checking, but this option employs perl to get a ``second opinion''.</p></dd><dd><p>If perl reports errors in the input file, they will not be reported in the error output unless the <strong>--warning-output</strong> flag is given.</p></dd><dd><p>The default is <strong>not</strong> to do this type of syntax checking (although perltidy will still do as much self-checking as possible). The reason is that it causes all code in BEGIN blocks to be executed, for all modules being used, and this opens the door to security issues and infinite loops when running perltidy.</html>" EditorType=boolean @@ -137,7 +137,7 @@ Value=0 ValueDefault=0 -[Closing%20Side%20Comment%20Else%20Flag] +[Closing Side Comment Else Flag] CallName="--closing-side-comment-else-flag=" Category=4 Description="<html><dd><p>The default, <strong>n=0</strong>, places the text of the opening <code>if</code> statement after any terminal <code>else</code>.</p></dd><dd><p>If <strong>n=2</strong> is used, then each <code>elsif</code> is also given the text of the opening <code>if</code> statement. Also, an <code>else</code> will include the text of a preceding <code>elsif</code> statement. Note that this may result some long closing side comments.</p></dd><dd><p>If <strong>n=1</strong> is used, the results will be the same as <strong>n=2</strong> whenever the resulting line length is less than the maximum allowed.</p></dd></html>" @@ -148,7 +148,7 @@ Value=0 ValueDefault=0 -[Closing%20Side%20Comment%20Interval] +[Closing Side Comment Interval] CallName="--closing-side-comment-interval=" Category=4 Description="<html><dd><p>where <code>n</code> is the minimum number of lines that a block must have in order for a closing side comment to be added. The default value is <code>n=6</code>. To illustrate:</p></dd><dd><pre>\n # perltidy -csci=2 -csc\n sub message {\n if ( !defined( $_[0] ) ) {\n print("Hello, World\n");\n } ## end if ( !defined( $_[0] ))\n else {\n print( $_[0], "\n" );\n } ## end else [ if ( !defined( $_[0] ))\n } ## end sub message</pre></dd><dd><p>Now the <code>if</code> and <code>else</code> blocks are commented. However, now this has become very cluttered.</p></dd></html>" @@ -159,7 +159,7 @@ Value=6 ValueDefault=6 -[Closing%20Side%20Comment%20List] +[Closing Side Comment List] CallName="--closing-side-comment-list=" Category=4 Description="<html><dd><p>where <code>string</code> is a list of block types to be tagged with closing side comments. By default, all code block types preceded by a keyword or label (such as <code>if</code>, <code>sub</code>, and so on) will be tagged. The <strong>-cscl</strong> command changes the default list to be any selected block types; see <a href=#specifying_block_types>Specifying Block Types</a>. For example, the following command requests that only <code>sub</code>'s, labels, <code>BEGIN</code>, and <code>END</code> blocks be affected by any <strong>-csc</strong> or <strong>-dcsc</strong> operation:</p></dd><dd><pre>\n -cscl="sub : BEGIN END"</pre></dd></html>" @@ -168,7 +168,7 @@ Value= ValueDefault= -[Closing%20Side%20Comment%20Maximum%20Text] +[Closing Side Comment Maximum Text] CallName="--closing-side-comment-maximum-text=" Category=4 Description="<html><dd><p>The text appended to certain block types, such as an <code>if</code> block, is whatever lies between the keyword introducing the block, such as <code>if</code>, and the opening brace. Since this might be too much text for a side comment, there needs to be a limit, and that is the purpose of this parameter. The default value is <code>n=20</code>, meaning that no additional tokens will be appended to this text after its length reaches 20 characters. Omitted text is indicated with <code>...</code>. (Tokens, including sub names, are never truncated, however, so actual lengths may exceed this). To illustrate, in the above example, the appended text of the first block is <code> ( !defined( $_[0] )...</code>. The existing limit of <code>n=20</code> caused this text to be truncated, as indicated by the <code>...</code>.</p></dd></html>" @@ -179,7 +179,7 @@ Value=20 ValueDefault=20 -[Closing%20Side%20Comment%20Prefix] +[Closing Side Comment Prefix] CallName="--closing-side-comment-prefix=" Category=4 Description="<html><dd><p>where string is the prefix used before the name of the block type. The default prefix, shown above, is <code>## end</code>. This string will be added to closing side comments, and it will also be used to recognize them in order to update, delete, and format them. Any comment identified as a closing side comment will be placed just a single space to the right of its closing brace.</p></dd></html>" @@ -188,7 +188,7 @@ Value=## end ValueDefault=## end -[Closing%20Side%20Comment%20Warnings] +[Closing Side Comment Warnings] Category=4 Description="<html><dd><p>This parameter is intended to help make the initial transition to the use of closing side comments. It causes two things to happen if a closing side comment replaces an existing, different closing side comment: first, an error message will be issued, and second, the original side comment will be placed alone on a new specially marked comment line for later attention.</p></dd><dd><p>The intent is to avoid clobbering existing hand-written side comments which happen to match the pattern of closing side comments. This flag should only be needed on the first run with <strong>-csc</strong>.</p></dd></html>" EditorType=boolean @@ -196,7 +196,7 @@ Value=0 ValueDefault=0 -[Closing%20Side%20Comments] +[Closing Side Comments] Category=4 Choices=-csc|-dcsc ChoicesReadable=Add Closing Side Comments|Delete Closing Side Comments @@ -206,7 +206,7 @@ Value=0 ValueDefault=0 -[Closing%20token%20indentation] +[Closing token indentation] CallName="--closing-token-indentation=" Category=2 Description="<html>The <strong>-cti=n</strong> flag controls the indentation of a line beginning with a <code>)</code>, <code>]</code>, or a non-block <code>}</code>. Such a line receives:</p></dd><dd><pre>\n -cti = 0 no extra indentation (default)\n -cti = 1 extra indentation such that the closing token\n aligns with its opening token.\n -cti = 2 one extra indentation level if the line looks like:\n ); or ]; or };\n -cti = 3 one extra indentation level always</pre></dd><dd><p>The flags <strong>-cti=1</strong> and <strong>-cti=2</strong> work well with the <strong>-lp</strong> flag (previous section).</p></dd><dd><pre>\n # perltidy -lp -cti=1\n @month_of_year = (\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',\n 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'\n );</pre></dd><dd><pre>\n # perltidy -lp -cti=2\n @month_of_year = (\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',\n 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'\n );</pre></dd><dd><p>These flags are merely hints to the formatter and they may not always be followed. In particular, if -lp is not being used, the indentation for<strong>cti=1</strong> is constrained to be no more than one indentation level.</p></dd><dd><p>If desired, this control can be applied independently to each of theclosing container token types. In fact, <strong>-cti=n</strong> is merely anabbreviation for <strong>-cpi=n -csbi=n -cbi=n</strong>, where: <strong>-cpi</strong> or <strong>--closing-paren-indentation</strong> controls <strong>)</strong>'s,<strong>-csbi</strong> or <strong>--closing-square-bracket-indentation</strong> controls <strong>]</strong>'s, <strong>-cbi</strong> or <strong>--closing-brace-indentation</strong> controls non-block <strong>}</strong>'s.</html>" @@ -217,7 +217,7 @@ Value=0 ValueDefault=0 -[Continuation%20indentation] +[Continuation indentation] CallName="--continuation-indentation=" Category=2 Description="<html>Continuation indentation is extra indentation spaces applied whena long line is broken. The default is n=2, illustrated here:</p></dd><dd><pre> my $level = # -ci=2 ( $max_index_to_go >= 0 ) ? $levels_to_go[0] : $last_output_level;</pre></dd><dd><p>The same example, with n=0, is a little harder to read:</p></dd><dd><pre> my $level = # -ci=0 ( $max_index_to_go >= 0 ) ? $levels_to_go[0] : $last_output_level;</pre></dd><dd><p>The value given to <strong>-ci</strong> is also used by some commands when a small space is required. Examples are commands for outdenting labels, <strong>-ola</strong>, and control keywords, <strong>-okw</strong>.</p></dd><dd><p>When default values are not used, it is suggested that the value <strong>n</strong> given with <strong>-ci=n</strong> be no more than about one-half of the number of spaces assigned to a full indentation level on the <strong>-i=n</strong> command.</html>" @@ -228,7 +228,7 @@ Value=2 ValueDefault=2 -[Cuddled%20else] +[Cuddled else] Category=6 Description="<html><dd><p>Enable the ``cuddled else'' style, in which <code>else</code> and <code>elsif</code> are follow immediately after the curly brace closing the previous block. The default is not to use cuddled elses, and is indicated with the flag <strong>-nce</strong> or <strong>--nocuddled-else</strong>. Here is a comparison of the alternatives:</p></dd><dd><pre>\n if ($task) {\n yyy();\n } else { # -ce\n zzz();\n }</pre></dd><dd><pre>\n if ($task) {\n yyy();\n }\n else { # -nce (default)\n zzz();\n }</pre></dd></html>" EditorType=boolean @@ -236,7 +236,7 @@ Value=0 ValueDefault=0 -[Delete%20old%20newlines] +[Delete old newlines] Category=6 Description="<html><dd><p>By default, perltidy first deletes all old line break locations, and then it looks for good break points to match the desired line length. Use <strong>-ndnl</strong> or <strong>--nodelete-old-newlines</strong> to force perltidy to retain all old line break points.</p></dd></html>" EditorType=boolean @@ -244,7 +244,7 @@ Value=0 ValueDefault=0 -[Delete%20old%20whitespace] +[Delete old whitespace] Category=3 Description="<html><dd><p>Setting this option allows perltidy to remove some old whitespace between characters, if necessary. This is the default. If you do not want any old whitespace removed, use <strong>-ndws</strong> or <strong>--nodelete-old-whitespace</strong>.</p></dd></html>" EditorType=boolean @@ -252,7 +252,7 @@ Value=0 ValueDefault=0 -[Delete%20semicolons] +[Delete semicolons] Category=3 Description="<html><dd><p>Setting <strong>-dsm</strong> allows perltidy to delete extra semicolons which are simply empty statements. This is the default, and may be deactivated with <strong>-ndsm</strong> or <strong>--nodelete-semicolons</strong>. (Such semicolons are not deleted, however, if they would promote a side comment to a block comment).</p></dd></html>" EditorType=boolean @@ -260,7 +260,7 @@ Value=0 ValueDefault=0 -[Entab%20leading%20whitespace] +[Entab leading whitespace] CallName="--entab-leading-whitespace=" Category=1 Description="This flag causes each <strong>n</strong> initial space characters to be replaced by one tab character. Note that the integer <strong>n</strong> is completely independent of the integer specified for indentation parameter, <strong>-i=n</strong>.</html>" @@ -271,7 +271,7 @@ Value=4 ValueDefault=4 -[Feeze%20newlines] +[Feeze newlines] Category=6 Description="<html><dd><p>If you do not want any changes to the line breaks in your script, set <strong>-fnl</strong>, and they will remain fixed, and the rest of the commands in this section and sections <a href=#controlling_list_formatting>Controlling List Formatting</a>, <a href=#retaining_or_ignoring_existing_line_breaks>Retaining or Ignoring Existing Line Breaks</a>, and <a href=#blank_line_control>Blank Line Control</a> will be ignored. You may want to use <strong>-noll</strong> with this.</p></dd></html>" EditorType=boolean @@ -279,7 +279,7 @@ Value=0 ValueDefault=0 -[Fixed%20position%20side%20comment] +[Fixed position side comment] CallName="--fixed-position-side-comment=" Category=4 Description="<html><dd><p>This parameter tells perltidy to line up side comments in column number <strong>n</strong> whenever possible. The default, n=0, is not do do this.</p></dd></html>" @@ -290,7 +290,7 @@ Value=0 ValueDefault=0 -[Format%20skipping] +[Format skipping] Category=5 Description="<html><p>Selected lines of code may be passed verbatim to the output without any formatting. This feature is enabled by default but can be disabled with the <strong>--noformat-skipping</strong> or <strong>-nfs</strong> flag. It should be used sparingly to avoid littering code with markers, but it might be helpful for working around occasional problems. For example it might be useful for keeping the indentation of old commented code unchanged, keeping indentation of long blocks of aligned comments unchanged, keeping certain list formatting unchanged, or working around a glitch in perltidy.</p><dl><dt><strong><a name=item__2dfs_2c__2d_2dformat_2dskipping><strong>-fs</strong>, <strong>--format-skipping</strong></a></strong><dd><p>This flag, which is enabled by default, causes any code between special beginning and ending comment markers to be passed to the output without formatting. The default beginning marker is #<<< and the default ending marker is #>>> but they may be changed (see next items below). Additional text may appear on these special comment lines provided that it is separated from the marker by at least one space. For example</p></dd><dd><pre>\n #<<< do not let perltidy touch this\n my @list = (1,\n 1, 1,\n 1, 2, 1,\n 1, 3, 3, 1,\n 1, 4, 6, 4, 1,);\n #>>></pre></dd><dd><p>The comment markers may be placed at any location that a block comment may appear. If they do not appear to be working, use the -log flag and examine the <em>.LOG</em> file. Use <strong>-nfs</strong> to disable this feature.</p></dd></html>" EditorType=boolean @@ -298,7 +298,7 @@ Value=1 ValueDefault=1 -[Format%20skipping%20begin] +[Format skipping begin] CallName="--format-skipping-begin=" Category=5 Description="<html><dd><p>The <strong>-fsb=string</strong> parameter may be used to change the beginning marker for format skipping. The default is equivalent to -fsb='#<<<'. The string that you enter must begin with a # and should be in quotes as necessary to get past the command shell of your system. It is actually the leading text of a pattern that is constructed by appending a '', so you must also include backslashes for characters to be taken literally rather than as patterns.</p></dd><dd><p>Some examples show how example strings become patterns:</p></dd><dd><pre>\n -fsb='#' becomes /^#/ which matches #{{{ but not #{{{{\n -fsb='#' becomes /^#/ which matches #** but not #***\n -fsb='#{2,}' becomes /^#{2,}/ which matches #** and #*****</pre></dd></html>" @@ -307,7 +307,7 @@ Value=#<<< ValueDefault=#<<< -[Format%20skipping%20end] +[Format skipping end] CallName="--format-skipping-end=" Category=5 Description="<html><dd><p>The <strong>-fsb=string</strong> is the corresponding parameter used to change the ending marker for format skipping. The default is equivalent to -fse='#<<<'.</p></dd></html>" @@ -316,7 +316,7 @@ Value=#<<< ValueDefault=#<<< -[Freeze%20whitespace] +[Freeze whitespace] Category=3 Description="<html>This flag causes your original whitespace to remain unchanged, and causes the rest of the whitespace commands in this section, the Code Indentation section, and the Comment Control section to be ignored.</html>" EditorType=boolean @@ -324,7 +324,7 @@ Value=0 ValueDefault=0 -[Gnu%20style] +[Gnu style] Category=0 Description="<html><dd><p><strong>-gnu</strong> gives an approximation to the GNU Coding Standards (which do not apply to perl) as they are sometimes implemented. At present, this style overrides the default style with the following parameters:</p></dd><dd><pre>\n -lp -bl -noll -pt=2 -bt=2 -sbt=2 -icp</pre></dd></html>" EditorType=boolean @@ -333,7 +333,7 @@ Value=0 ValueDefault=0 -[Hanging%20side%20comments] +[Hanging side comments] Category=4 Description="<html><dd><p>By default, perltidy tries to identify and align ``hanging side comments'', which are something like this:</p></dd><dd><pre>\n my $IGNORE = 0; # This is a side comment\n # This is a hanging side comment\n # And so is this</pre></dd><dd><p>A comment is considered to be a hanging side comment if (1) it immediately follows a line with a side comment, or another hanging side comment, and (2) there is some leading whitespace on the line. To deactivate this feature, use <strong>-nhsc</strong> or <strong>--nohanging-side-comments</strong>. If block comments are preceded by a blank line, or have no leading whitespace, they will not be mistaken as hanging side comments.</p></dd></html>" EditorType=boolean @@ -341,7 +341,7 @@ Value=0 ValueDefault=0 -[Indent%20block%20comments] +[Indent block comments] Category=4 Description="<html><p>Block comments normally look best when they are indented to the same level as the code which follows them. This is the default behavior, but you may use <strong>-nibc</strong> to keep block comments left-justified. Here is an example:</p></dd><dd><pre>\n # this comment is indented (-ibc, default)\n if ($task) { yyy(); }</pre></dd><dd><p>The alternative is <strong>-nibc</strong>:</p></dd><dd><pre>\n # this comment is not indented (-nibc)\n if ($task) { yyy(); }</pre></dd><dd><p>See also the next item, <strong>-isbc</strong>, as well as <strong>-sbc</strong>, for other ways to have some indented and some outdented block comments.</p></dd></html>" EditorType=boolean @@ -349,7 +349,7 @@ Value=1 ValueDefault=1 -[Indent%20closing%20brace] +[Indent closing brace] Category=2 Description="<html>The <strong>-icb</strong> option gives one extra level of indentation to a brace which terminates a code block . For example,</p></dd><dd><pre>\n if ($task) {\n yyy();\n } # -icb\n else {\n zzz();\n }</pre></dd><dd><p>The default is not to do this, indicated by <strong>-nicb</strong>.</html>" EditorType=boolean @@ -357,7 +357,7 @@ Value=0 ValueDefault=0 -[Indent%20closing%20paren] +[Indent closing paren] Category=2 Description="<html>The <strong>-icp</strong> flag is equivalent to<strong>-cti=2</strong>, described in the previous section. The <strong>-nicp</strong> flag is equivalent <strong>-cti=0</strong>. They are included for backwards compatability.</html>" EditorType=boolean @@ -365,7 +365,7 @@ Value=0 ValueDefault=0 -[Indent%20columns] +[Indent columns] CallName="--indent-columns=" Category=1 Description="<html>Use n columns per indentation level (default n=4).</html>" @@ -376,7 +376,7 @@ Value=4 ValueDefault=4 -[Indent%20only] +[Indent only] Category=1 Description="<html>This flag is used to deactivate all formatting and line break changes. When it is in effect, the only change to the script will be indentation. And any flags controlling whitespace and newlines will be ignored. You might want to use this if you are perfectly happy with your whitespace and line breaks, and merely want perltidy to handle the indentation. (This also speeds up perltidy by well over a factor of two, so it might be useful when perltidy is merely being used to help find a brace error in a large script).</p></dd><dd><p>Setting this flag is equivalent to setting <strong>--freeze-newlines</strong> and<strong>--freeze-whitespace</strong>.</html>" EditorType=boolean @@ -385,7 +385,7 @@ Value=0 ValueDefault=0 -[Indent%20spaced%20block%20comments] +[Indent spaced block comments] Category=4 Description="<html><dd><p>If there is no leading space on the line, then the comment will not be indented, and otherwise it may be.</p></dd><dd><p>If both <strong>-ibc</strong> and <strong>-isbc</strong> are set, then <strong>-isbc</strong> takes priority.</p></dd></html>" EditorType=boolean @@ -393,7 +393,7 @@ Value=0 ValueDefault=0 -[List%20indentation] +[List indentation] Category=2 Description="<html>By default, perltidy indents lists with 4 spaces, or whatever value is specified with <strong>-i=n</strong>. Here is a small list formatted in this way:</p></dd><dd><pre>\n # perltidy (default)\n @month_of_year = (\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',\n 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'\n );</pre></dd><dd><p>Use the <strong>-lp</strong> flag to add extra indentation to cause the data to begin past the opening parentheses of a sub call or list, or opening square bracket of an anonymous array, or opening curly brace of an anonymous hash. With this option, the above list would become:</p></dd><dd><pre>\n # perltidy -lp\n @month_of_year = (\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',\n 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'\n );</pre></dd><dd><p>If the available line length (see <strong>-l=n</strong> ) does not permit this much space, perltidy will use less. For alternate placement of the closing paren, see the next section.</p></dd><dd><p>This option has no effect on code BLOCKS, such as if/then/else blocks, which always use whatever is specified with <strong>-i=n</strong>. Also, the existence of line breaks and/or block comments between the opening and closing parens may cause perltidy to temporarily revert to its default method.</p></dd><dd><p>Note: The <strong>-lp</strong> option may not be used together with the <strong>-t</strong> tabs option. It may, however, be used with the <strong>-et=n</strong> tab method.</p></dd><dd><p>In addition, any parameter which significantly restricts the ability of perltidy to choose newlines will conflict with <strong>-lp</strong> and will cause <strong>-lp</strong> to be deactivated. These include <strong>-io</strong>, <strong>-fnl</strong>, <strong>-nanl</strong>, and <strong>-ndnl</strong>. The reason is that the <strong>-lp</strong> indentation style can require the careful coordination of an arbitrary number of break points in hierarchical lists, and these flags may prevent that.</html>" EditorType=boolean @@ -401,7 +401,7 @@ Value=0 ValueDefault=0 -[Maximum%20line%20length] +[Maximum line length] CallName="--maximum-line-length=" Category=1 Description="<html>The default maximum line length is n=80 characters. Perltidy will try to find line break points to keep lines below this length. However, long quotes and side comments may cause lines to exceed this length. Setting <strong>-l=0</strong> is equivalent to setting <strong>-l=(a large number)</strong>.</html>" @@ -412,7 +412,7 @@ Value=80 ValueDefault=80 -[Minimum%20space%20to%20comment] +[Minimum space to comment] CallName="--minimum-space-to-comment=" Category=4 Description="<html><dd><p>Side comments look best when lined up several spaces to the right of code. Perltidy will try to keep comments at least n spaces to the right. The default is n=4 spaces.</p></dd></html>" @@ -423,7 +423,7 @@ Value=4 ValueDefault=4 -[Nospace%20after%20keyword] +[Nospace after keyword] CallName="--nospace-after-keyword=" Category=3 Description="<html><dd><p>When an opening paren follows a Perl keyword, no space is introduced after the keyword, unless it is (by default) one of these:</p></dd><dd><pre>\n my local our and or eq ne if else elsif until unless \n while for foreach return switch case given when</pre></dd><dd><p>These defaults can be modified with two commands:</p></dd><dd><p><strong>-sak=s</strong> or <strong>--space-after-keyword=s</strong> adds keywords.</p></dd><dd><p><strong>-nsak=s</strong> or <strong>--nospace-after-keyword=s</strong> removes keywords.</p></dd><dd><p>where <strong>s</strong> is a list of keywords (in quotes if necessary). For example,</p></dd><dd><pre>\n my ( $a, $b, $c ) = @_; # default\n my( $a, $b, $c ) = @_; # -nsak="my local our"</pre></dd></html>" @@ -432,7 +432,7 @@ Value= ValueDefault= -[Nowant%20left%20space] +[Nowant left space] CallName="--nowant-left-space=" Category=3 Description="<html><dd><p>For those who want more detailed control over the whitespace around tokens, there are four parameters which can directly modify the default whitespace rules built into perltidy for any token. They are:</p></dd><dd><p><strong>-wls=s</strong> or <strong>--want-left-space=s</strong>,</p></dd><dd><p><strong>-nwls=s</strong> or <strong>--nowant-left-space=s</strong>,</p></dd><dd><p><strong>-wrs=s</strong> or <strong>--want-right-space=s</strong>,</p></dd><dd><p><strong>-nwrs=s</strong> or <strong>--nowant-right-space=s</strong>.</p></dd><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types. No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>To illustrate how these are used, suppose it is desired that there be no space on either side of the token types <strong>= + - / *</strong>. The following two parameters would specify this desire:</p></dd><dd><pre>\n -nwls="= + - / *" -nwrs="= + - / *"</pre></dd><dd><p>(Note that the token types are in quotes, and that they are separated by spaces). With these modified whitespace rules, the following line of math:</p></dd><dd><pre>\n $root = -$b + sqrt( $b * $b - 4. * $a * $c ) / ( 2. * $a );</pre></dd><dd><p>becomes this:</p></dd><dd><pre>\n $root=-$b+sqrt( $b*$b-4.*$a*$c )/( 2.*$a );</pre></dd><dd><p>These parameters should be considered to be hints to perltidy rather than fixed rules, because perltidy must try to resolve conflicts that arise between them and all of the other rules that it uses. One conflict that can arise is if, between two tokens, the left token wants a space and the right one doesn't. In this case, the token not wanting a space takes priority.</p></dd><dd><p>It is necessary to have a list of all token types in order to create this type of input. Such a list can be obtained by the command <strong>--dump-token-types</strong>. Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization.</p></dd><dd><p><strong>WARNING</strong> Be sure to put these tokens in quotes to avoid having them misinterpreted by your command shell.</p></dd></html>" @@ -441,7 +441,7 @@ Value= ValueDefault= -[Nowant%20right%20space] +[Nowant right space] CallName="--nowant-right-space=" Category=3 Description="<html><dd><p>For those who want more detailed control over the whitespace around tokens, there are four parameters which can directly modify the default whitespace rules built into perltidy for any token. They are:</p></dd><dd><p><strong>-wls=s</strong> or <strong>--want-left-space=s</strong>,</p></dd><dd><p><strong>-nwls=s</strong> or <strong>--nowant-left-space=s</strong>,</p></dd><dd><p><strong>-wrs=s</strong> or <strong>--want-right-space=s</strong>,</p></dd><dd><p><strong>-nwrs=s</strong> or <strong>--nowant-right-space=s</strong>.</p></dd><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types. No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>To illustrate how these are used, suppose it is desired that there be no space on either side of the token types <strong>= + - / *</strong>. The following two parameters would specify this desire:</p></dd><dd><pre>\n -nwls="= + - / *" -nwrs="= + - / *"</pre></dd><dd><p>(Note that the token types are in quotes, and that they are separated by spaces). With these modified whitespace rules, the following line of math:</p></dd><dd><pre>\n $root = -$b + sqrt( $b * $b - 4. * $a * $c ) / ( 2. * $a );</pre></dd><dd><p>becomes this:</p></dd><dd><pre>\n $root=-$b+sqrt( $b*$b-4.*$a*$c )/( 2.*$a );</pre></dd><dd><p>These parameters should be considered to be hints to perltidy rather than fixed rules, because perltidy must try to resolve conflicts that arise between them and all of the other rules that it uses. One conflict that can arise is if, between two tokens, the left token wants a space and the right one doesn't. In this case, the token not wanting a space takes priority.</p></dd><dd><p>It is necessary to have a list of all token types in order to create this type of input. Such a list can be obtained by the command <strong>--dump-token-types</strong>. Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization.</p></dd><dd><p><strong>WARNING</strong> Be sure to put these tokens in quotes to avoid having them misinterpreted by your command shell.</p></dd></html>" @@ -450,7 +450,7 @@ Value= ValueDefault= -[Opening%20brace%20always%20on%20right] +[Opening brace always on right] Category=6 Description="<html><dd><p>The default style, <strong>-nbl</strong> places the opening code block brace on a new line if it does not fit on the same line as the opening keyword, like this:</p></dd><dd><pre>\n if ( $bigwasteofspace1 && $bigwasteofspace2\n || $bigwasteofspace3 && $bigwasteofspace4 )\n {\n big_waste_of_time();\n }</pre></dd><dd><p>To force the opening brace to always be on the right, use the <strong>-bar</strong> flag. In this case, the above example becomes</p></dd><dd><pre>\n if ( $bigwasteofspace1 && $bigwasteofspace2\n || $bigwasteofspace3 && $bigwasteofspace4 ) {\n big_waste_of_time();\n }</pre></dd><dd><p>A conflict occurs if both <strong>-bl</strong> and <strong>-bar</strong> are specified.</p></dd></html>" EditorType=boolean @@ -458,7 +458,7 @@ Value=0 ValueDefault=0 -[Opening%20brace%20on%20new%20line] +[Opening brace on new line] Category=6 Description="<html><dd><p>Use the flag <strong>-bl</strong> to place the opening brace on a new line:</p></dd><dd><pre>\n if ( $input_file eq '-' ) # -bl \n { \n important_function();\n }</pre></dd><dd><p>This flag applies to all structural blocks, including sub's (unless the <strong>-sbl</strong> flag is set -- see next item).</p></dd><dd><p>The default style, <strong>-nbl</strong>, places an opening brace on the same line as the keyword introducing it. For example,</p></dd><dd><pre>\n if ( $input_file eq '-' ) { # -nbl (default)</pre></dd></html>" EditorType=boolean @@ -466,7 +466,7 @@ Value=0 ValueDefault=0 -[Opening%20hash%20brace%20right] +[Opening hash brace right] Category=6 Description="<html><dd><p>The <strong>-otr</strong> flag is a hint that perltidy should not place a break between a comma and an opening token. For example:</p></dd><dd><pre>\n # default formatting\n push @{ $self->{$module}{$key} },\n {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><pre>\n # perltidy -otr\n push @{ $self->{$module}{$key} }, {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><p>The flag <strong>-otr</strong> is actually a synonym for three other flags which can be used to control parens, hash braces, and square brackets separately if desired:</p></dd><dd><pre>\n -opr or --opening-paren-right\n -ohbr or --opening-hash-brace-right\n -osbr or --opening-square-bracket-right</pre></dd></html>" EditorType=boolean @@ -474,7 +474,7 @@ Value=0 ValueDefault=0 -[Opening%20paren%20right] +[Opening paren right] Category=6 Description="<html><dd><p>The <strong>-otr</strong> flag is a hint that perltidy should not place a break between a comma and an opening token. For example:</p></dd><dd><pre>\n # default formatting\n push @{ $self->{$module}{$key} },\n {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><pre>\n # perltidy -otr\n push @{ $self->{$module}{$key} }, {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><p>The flag <strong>-otr</strong> is actually a synonym for three other flags which can be used to control parens, hash braces, and square brackets separately if desired:</p></dd><dd><pre>\n -opr or --opening-paren-right\n -ohbr or --opening-hash-brace-right\n -osbr or --opening-square-bracket-right</pre></dd></html>" EditorType=boolean @@ -482,7 +482,7 @@ Value=0 ValueDefault=0 -[Opening%20square%20bracket%20right] +[Opening square bracket right] Category=6 Description="<html><dd><p>The <strong>-otr</strong> flag is a hint that perltidy should not place a break between a comma and an opening token. For example:</p></dd><dd><pre>\n # default formatting\n push @{ $self->{$module}{$key} },\n {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><pre>\n # perltidy -otr\n push @{ $self->{$module}{$key} }, {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><p>The flag <strong>-otr</strong> is actually a synonym for three other flags which can be used to control parens, hash braces, and square brackets separately if desired:</p></dd><dd><pre>\n -opr or --opening-paren-right\n -ohbr or --opening-hash-brace-right\n -osbr or --opening-square-bracket-right</pre></dd></html>" EditorType=boolean @@ -490,7 +490,7 @@ Value=0 ValueDefault=0 -[Opening%20sub%20brace%20on%20new%20line] +[Opening sub brace on new line] Category=6 Description="<html><dd><p>The flag <strong>-sbl</strong> can be used to override the value of <strong>-bl</strong> for opening sub braces. For example,</p></dd><dd><pre>\n perltidy -sbl</pre></dd><dd><p>produces this result:</p></dd><dd><pre>\n sub message\n {\n if (!defined($_[0])) {\n print("Hello, World\n");\n }\n else {\n print($_[0], "\n");\n }\n }</pre></dd><dd><p>This flag is negated with <strong>-nsbl</strong>. If <strong>-sbl</strong> is not specified, the value of <strong>-bl</strong> is used.</p></dd></html>" EditorType=boolean @@ -498,7 +498,7 @@ Value=0 ValueDefault=0 -[Opening%20token%20right] +[Opening token right] Category=6 Description="<html><dd><p>The <strong>-otr</strong> flag is a hint that perltidy should not place a break between a comma and an opening token. For example:</p></dd><dd><pre>\n # default formatting\n push @{ $self->{$module}{$key} },\n {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><pre>\n # perltidy -otr\n push @{ $self->{$module}{$key} }, {\n accno => $ref->{accno},\n description => $ref->{description}\n };</pre></dd><dd><p>The flag <strong>-otr</strong> is actually a synonym for three other flags which can be used to control parens, hash braces, and square brackets separately if desired:</p></dd><dd><pre>\n -opr or --opening-paren-right\n -ohbr or --opening-hash-brace-right\n -osbr or --opening-square-bracket-right</pre></dd></html>" EditorType=boolean @@ -506,7 +506,7 @@ Value=0 ValueDefault=0 -[Outdent%20keyword%20list] +[Outdent keyword list] CallName="--outdent-keyword-list=" Category=2 Description="<html>This command can be used to change the keywords which are outdented with the <strong>-okw</strong> command. The parameter <strong>string</strong> is a required list of perl keywords, which should be placed in quotes if there are more than one. By itself, it does not cause any outdenting to occur, so the <strong>-okw</strong> command is still required.</p></dd><dd><p>For example, the commands <code>-okwl="next last redo goto" -okw</code> will cause those four keywords to be outdented. It is probably simplest to place any <strong>-okwl</strong> command in a <em>.perltidyrc</em> file.</html>" @@ -515,7 +515,7 @@ Value= ValueDefault= -[Outdent%20long%20comments] +[Outdent long comments] Category=4 Description="<html><dd><p>When <strong>-olc</strong> is set, lines which are full-line (block) comments longer than the value <strong>maximum-line-length</strong> will have their indentation removed. This is the default; use <strong>-nolc</strong> to prevent outdenting.</p></dd></html>" EditorType=boolean @@ -523,7 +523,7 @@ Value=1 ValueDefault=1 -[Outdent%20long%20lines] +[Outdent long lines] Category=2 Description="<html>This command is equivalent to <strong>--outdent-long-quotes</strong> and <strong>--outdent-long-comments</strong>, and it is included for compatibility with previous versions of perltidy. The negation of this also works, <strong>-noll</strong> or <strong>--nooutdent-long-lines</strong>, and is equivalent to setting <strong>-nolq</strong> and <strong>-nolc</strong>.</html>" EditorType=boolean @@ -531,7 +531,7 @@ Value=0 ValueDefault=0 -[Outdent%20long%20quotes] +[Outdent long quotes] Category=2 Description="<html>When <strong>-olq</strong> is set, lines which is a quoted string longer than the value <strong>maximum-line-length</strong> will have their indentation removed to make them more readable. This is the default. To prevent such out-denting, use <strong>-nolq</strong> or <strong>--nooutdent-long-lines</strong>.</html>" EditorType=boolean @@ -539,7 +539,7 @@ Value=0 ValueDefault=0 -[Outdenting%20Keywords] +[Outdenting Keywords] Category=2 Description="<html>The command <strong>-okw</strong> will will cause certain leading control keywords to be outdented by 2 spaces (or whatever <strong>-ci</strong> has been set to), if possible. By default, these keywords are <code>redo</code>, <code>next</code>, <code>last</code>, <code>goto</code>, and <code>return</code>. The intention is to make these control keywords easier to see. To change this list of keywords being outdented, see the next section.</p></dd><dd><p>For example, using <code>perltidy -okw</code> on the previous example gives:</p></dd><dd><pre>\n my $i;\n LOOP: while ( $i = <FOTOS> ) {\n chomp($i);\n next unless $i;\n fixit($i);\n }</pre></dd><dd><p>The default is not to do this.</html>" EditorType=boolean @@ -547,7 +547,7 @@ Value=0 ValueDefault=0 -[Outdenting%20Labels] +[Outdenting Labels] Category=2 Description="<html>This command will cause labels to be outdented by 2 spaces (or whatever <strong>-ci</strong> has been set to), if possible. This is the default. For example:</p></dd><dd><pre>\n my $i;\n LOOP: while ( $i = <FOTOS> ) {\n chomp($i);\n next unless $i;\n fixit($i);\n }</pre></dd><dd><p>Use <strong>-nola</strong> to not outdent labels.</html>" EditorType=boolean @@ -555,7 +555,7 @@ Value=0 ValueDefault=0 -[Output%20line%20ending] +[Output line ending] Category=1 Choices="--output-line-ending=win|--output-line-ending=dos|--output-line-ending=unix|--output-line-ending=mac" ChoicesReadable=Output line ending Windows|Output line ending Dos|Output line ending Unix|Output line ending Mac @@ -565,7 +565,7 @@ Value=1 ValueDefault=1 -[Paren%20tightness] +[Paren tightness] CallName="--paren-tightness=" Category=3 Description="<html><p>The <strong>-pt=n</strong> or <strong>--paren-tightness=n</strong> parameter controls the space within parens. The example below shows the effect of the three possible values, 0, 1, and 2:</p></dd><dd><pre>\n if ( ( my $len_tab = length( $tabstr ) ) > 0 ) { # -pt=0\n if ( ( my $len_tab = length($tabstr) ) > 0 ) { # -pt=1 (default)\n if ((my $len_tab = length($tabstr)) > 0) { # -pt=2</pre></dd><dd><p>When n is 0, there is always a space to the right of a '(' and to the left of a ')'. For n=2 there is never a space. For n=1, the default, there is a space unless the quantity within the parens is a single token, such as an identifier or quoted string.</html>" @@ -576,7 +576,7 @@ Value=1 ValueDefault=1 -[Paren%20vertical%20tightness] +[Paren vertical tightness] CallName="--paren-vertical-tightness=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -587,7 +587,7 @@ Value=0 ValueDefault=0 -[Paren%20vertical%20tightness%20closing] +[Paren vertical tightness closing] CallName="--paren-vertical-tightness-closing=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -598,7 +598,7 @@ Value=0 ValueDefault=0 -[Perl%20best%20practices] +[Perl best practices] Category=0 Description="<html><dd><p><strong>-pbp</strong> is an abbreviation for the parameters in the book <strong>Perl Best Practices</strong> by Damian Conway:</p></dd><dd><pre>\n -l=78 -i=4 -ci=4 -st -se -vt=2 -cti=0 -pt=1 -bt=1 -sbt=1 -bbt=1 -nsfs -nolq\n -wbb="% + - * / x != == >= <= =~ !~ < > | & = \n **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x="</pre></dd><dd><p>Note that the -st and -se flags make perltidy act as a filter on one file only. These can be overridden with -nst and -nse if necessary.</p></dd></html>" EditorType=boolean @@ -607,7 +607,7 @@ Value=0 ValueDefault=0 -[Perl%20syntax%20check%20flags] +[Perl syntax check flags] CallName="--perl-syntax-check-flags=" Category=1 Description="<html>When perl is invoked to check syntax, the normal flags are <code>-c -T</code>. In addition, if the <strong>-x</strong> flag is given to perltidy, then perl will also be passed a <strong>-x</strong> flag. It should not normally be necessary to change these flags, but it can be done with the <strong>-pscf=s</strong> flag. For example, if the taint flag, <code>-T</code>, is not wanted, the flag could be set to be just <strong>-pscf=-c</strong>.</p></dd><dd><p>Perltidy will pass your string to perl with the exception that it willadd a <strong>-c</strong> and <strong>-x</strong> if appropriate. The <em>.LOG</em> file will show exactly what flags were passed to perl.</html>" @@ -616,7 +616,7 @@ Value= ValueDefault= -[Preserve%20line%20endings] +[Preserve line endings] Category=1 Description="<html>This flag tells perltidy to write its output files with the same line endings as the input file, if possible. It should work for <strong>dos</strong>, <strong>unix</strong>, and <strong>mac</strong> line endings. It will only work if perltidy input comes from a filename (rather than stdin, for example). If perltidy has trouble determining the input file line ending, it will revert to the default behavior of using the line ending of the host system.</html>" EditorType=boolean @@ -625,7 +625,7 @@ Value=0 ValueDefault=0 -[Space%20after%20keyword] +[Space after keyword] CallName="--space-after-keyword=" Category=3 Description="<html><dd><p>When an opening paren follows a Perl keyword, no space is introduced after the keyword, unless it is (by default) one of these:</p></dd><dd><pre>\n my local our and or eq ne if else elsif until unless \n while for foreach return switch case given when</pre></dd><dd><p>These defaults can be modified with two commands:</p></dd><dd><p><strong>-sak=s</strong> or <strong>--space-after-keyword=s</strong> adds keywords.</p></dd><dd><p><strong>-nsak=s</strong> or <strong>--nospace-after-keyword=s</strong> removes keywords.</p></dd><dd><p>where <strong>s</strong> is a list of keywords (in quotes if necessary). For example,</p></dd><dd><pre>\n my ( $a, $b, $c ) = @_; # default\n my( $a, $b, $c ) = @_; # -nsak="my local our"</pre></dd></html>" @@ -634,7 +634,7 @@ Value= ValueDefault= -[Space%20for%20semicolon] +[Space for semicolon] Category=3 Description="<html><dd><p>Semicolons within <strong>for</strong> loops may sometimes be hard to see, particularly when commas are also present. This option places spaces on both sides of these special semicolons, and is the default. Use <strong>-nsfs</strong> or <strong>--nospace-for-semicolon</strong> to deactivate it.</p></dd><dd><pre>\n for ( @a = @$ap, $u = shift @a ; @a ; $u = $v ) { # -sfs (default)\n for ( @a = @$ap, $u = shift @a; @a; $u = $v ) { # -nsfs</pre></dd></html>" EditorType=boolean @@ -642,7 +642,7 @@ Value=0 ValueDefault=0 -[Space%20function%20paren] +[Space function paren] Category=3 Description="<html><dd><p>When an opening paren follows a function the default is not to introduce a space. To cause a space to be introduced use:</p></dd><dd><p><strong>-sfp</strong> or <strong>--space-function-paren</strong></p></dd><dd><pre>\n myfunc( $a, $b, $c ); # default \n myfunc ( $a, $b, $c ); # -sfp</pre></dd><dd><p>You will probably also want to use the flag <strong>-skp</strong> (previous item) too.</p></dd></html>" EditorType=boolean @@ -650,7 +650,7 @@ Value=0 ValueDefault=0 -[Space%20keyword%20paren] +[Space keyword paren] Category=3 Description="<html><dd><p>When an opening paren follows a function or keyword, no space is introduced after the keyword except for the keywords noted in the previous item. To always put a space between a function or keyword and its opening paren, use the command:</p></dd><dd><p><strong>-skp</strong> or <strong>--space-keyword-paren</strong></p></dd><dd><p>You will probably also want to use the flag <strong>-sfp</strong> (next item) too.</p></dd></html>" EditorType=boolean @@ -658,7 +658,7 @@ Value=0 ValueDefault=0 -[Space%20terminal%20semicolon] +[Space terminal semicolon] Category=3 Description="<html><p>Some programmers prefer a space before all terminal semicolons. The default is for no such space, and is indicated with <strong>-nsts</strong> or <strong>--nospace-terminal-semicolon</strong>.</p></dd><dd><pre>\n $i = 1 ; # -sts\n $i = 1; # -nsts (default)</pre></dd></html>" EditorType=boolean @@ -666,7 +666,7 @@ Value=0 ValueDefault=0 -[Square%20bracket%20tightness] +[Square bracket tightness] CallName="--square-bracket-tightness=" Category=3 Description="<html><p>Likewise, the parameter <strong>-sbt=n</strong> or <strong>--square-bracket-tightness=n</strong> controls the space within square brackets, as illustrated below.</p></dd><dd><pre>\n $width = $col[ $j + $k ] - $col[ $j ]; # -sbt=0\n $width = $col[ $j + $k ] - $col[$j]; # -sbt=1 (default)\n $width = $col[$j + $k] - $col[$j]; # -sbt=2</pre></dd></html>" @@ -677,7 +677,7 @@ Value=1 ValueDefault=1 -[Square%20bracket%20vertical%20tightness] +[Square bracket vertical tightness] CallName="--square-bracket-vertical-tightness=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -688,7 +688,7 @@ Value=0 ValueDefault=0 -[Square%20bracket%20vertical%20tightness%20closing] +[Square bracket vertical tightness closing] CallName="--square-bracket-vertical-tightness-closing=" Category=6 Description="<html><p>The <strong>-vt=n</strong> and <strong>-vtc=n</strong> parameters apply to each type of container token. If desired, vertical tightness controls can be applied independently to each of the closing container token types.</p><p>In fact, the parameter <strong>-vt=n</strong> is actually just an abbreviation for <strong>-pvt=n -bvt=n sbvt=n</strong>, and likewise <strong>-vtc=n</strong> is an abbreviation for <strong>-pvtc=n -bvtc=n sbvtc=n</strong>.</p></html>" @@ -699,7 +699,7 @@ Value=0 ValueDefault=0 -[Stack%20closing%20hash%20brace] +[Stack closing hash brace] Category=6 Description="<html><dd><p>The <strong>-sct</strong> flag tells perltidy to ``stack'' closing tokens when possible to avoid lines with isolated closing tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sct\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n } );</pre></dd><dd><p>The <strong>-sct</strong> flag is somewhat similar to the <strong>-vtc</strong> flags, and in some cases it can give a similar result. The difference is that the <strong>-vtc</strong> flags try to avoid lines with leading opening tokens by ``hiding'' them at the end of a previous line, whereas the <strong>-sct</strong> flag merely tries to reduce the number of lines with isolated closing tokens by stacking them but does not try to hide them. For example:</p></dd><dd><pre>\n # -vtc=2\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1, } );</pre></dd><dd><p>The flag <strong>-sct</strong> is a synonym for <strong>-scp -schb -scsb</strong>.</p></dd></html>" EditorType=boolean @@ -707,7 +707,7 @@ Value=0 ValueDefault=0 -[Stack%20closing%20paren] +[Stack closing paren] Category=6 Description="<html><dd><p>The <strong>-sct</strong> flag tells perltidy to ``stack'' closing tokens when possible to avoid lines with isolated closing tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sct\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n } );</pre></dd><dd><p>The <strong>-sct</strong> flag is somewhat similar to the <strong>-vtc</strong> flags, and in some cases it can give a similar result. The difference is that the <strong>-vtc</strong> flags try to avoid lines with leading opening tokens by ``hiding'' them at the end of a previous line, whereas the <strong>-sct</strong> flag merely tries to reduce the number of lines with isolated closing tokens by stacking them but does not try to hide them. For example:</p></dd><dd><pre>\n # -vtc=2\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1, } );</pre></dd><dd><p>The flag <strong>-sct</strong> is a synonym for <strong>-scp -schb -scsb</strong>.</p></dd></html>" EditorType=boolean @@ -715,7 +715,7 @@ Value=0 ValueDefault=0 -[Stack%20closing%20square%20bracket] +[Stack closing square bracket] Category=6 Description="<html><dd><p>The <strong>-sct</strong> flag tells perltidy to ``stack'' closing tokens when possible to avoid lines with isolated closing tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sct\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n } );</pre></dd><dd><p>The <strong>-sct</strong> flag is somewhat similar to the <strong>-vtc</strong> flags, and in some cases it can give a similar result. The difference is that the <strong>-vtc</strong> flags try to avoid lines with leading opening tokens by ``hiding'' them at the end of a previous line, whereas the <strong>-sct</strong> flag merely tries to reduce the number of lines with isolated closing tokens by stacking them but does not try to hide them. For example:</p></dd><dd><pre>\n # -vtc=2\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1, } );</pre></dd><dd><p>The flag <strong>-sct</strong> is a synonym for <strong>-scp -schb -scsb</strong>.</p></dd></html>" EditorType=boolean @@ -723,7 +723,7 @@ Value=0 ValueDefault=0 -[Stack%20closing%20tokens] +[Stack closing tokens] Category=6 Description="<html><dd><p>The <strong>-sct</strong> flag tells perltidy to ``stack'' closing tokens when possible to avoid lines with isolated closing tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sct\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n } );</pre></dd><dd><p>The <strong>-sct</strong> flag is somewhat similar to the <strong>-vtc</strong> flags, and in some cases it can give a similar result. The difference is that the <strong>-vtc</strong> flags try to avoid lines with leading opening tokens by ``hiding'' them at the end of a previous line, whereas the <strong>-sct</strong> flag merely tries to reduce the number of lines with isolated closing tokens by stacking them but does not try to hide them. For example:</p></dd><dd><pre>\n # -vtc=2\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1, } );</pre></dd><dd><p>For detailed control of the stacking of individual closing tokens the following controls can be used:</p></dd><dd><pre>\n -scp or --stack-closing-paren\n -schb or --stack-closing-hash-brace\n -scsb or --stack-closing-square-bracket</pre></dd><dd><p>The flag <strong>-sct</strong> is a synonym for <strong>-scp -schb -scsb</strong>.</p></dd></html>" EditorType=boolean @@ -731,7 +731,7 @@ Value=0 ValueDefault=0 -[Stack%20opening%20hash%20brace] +[Stack opening hash brace] Category=6 Description="<html><dd><p>The <strong>-sot</strong> flag tells perltidy to ``stack'' opening tokens when possible to avoid lines with isolated opening tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sot\n $opt_c = Text::CSV_XS->new( {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><p>For detailed control of individual closing tokens the following controls can be used:</p></dd><dd><pre>\n -sop or --stack-opening-paren\n -sohb or --stack-opening-hash-brace\n -sosb or --stack-opening-square-bracket</pre></dd><dd><p>The flag <strong>-sot</strong> is a synonym for <strong>-sop -sohb -sosb</strong>.</p></dd></html>" EditorType=boolean @@ -739,7 +739,7 @@ Value=0 ValueDefault=0 -[Stack%20opening%20paren] +[Stack opening paren] Category=6 Description="<html><dd><p>The <strong>-sot</strong> flag tells perltidy to ``stack'' opening tokens when possible to avoid lines with isolated opening tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sot\n $opt_c = Text::CSV_XS->new( {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><p>The flag <strong>-sot</strong> is a synonym for <strong>-sop -sohb -sosb</strong>.</p></dd></html>" EditorType=boolean @@ -747,7 +747,7 @@ Value=0 ValueDefault=0 -[Stack%20opening%20square%20bracket] +[Stack opening square bracket] Category=6 Description="<html><dd><p>The <strong>-sot</strong> flag tells perltidy to ``stack'' opening tokens when possible to avoid lines with isolated opening tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sot\n $opt_c = Text::CSV_XS->new( {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><p>For detailed control of individual closing tokens the following controls can be used:</p></dd><dd><pre>\n -sop or --stack-opening-paren\n -sohb or --stack-opening-hash-brace\n -sosb or --stack-opening-square-bracket</pre></dd><dd><p>The flag <strong>-sot</strong> is a synonym for <strong>-sop -sohb -sosb</strong>.</p></dd></html>" EditorType=boolean @@ -755,7 +755,7 @@ Value=0 ValueDefault=0 -[Stack%20opening%20tokens] +[Stack opening tokens] Category=6 Description="<html><dd><p>The <strong>-sot</strong> flag tells perltidy to ``stack'' opening tokens when possible to avoid lines with isolated opening tokens.</p></dd><dd><p>For example:</p></dd><dd><pre>\n # default\n $opt_c = Text::CSV_XS->new(\n {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><pre>\n # -sot\n $opt_c = Text::CSV_XS->new( {\n binary => 1,\n sep_char => $opt_c,\n always_quote => 1,\n }\n );</pre></dd><dd><p>For detailed control of individual closing tokens the following controls can be used:</p></dd><dd><pre>\n -sop or --stack-opening-paren\n -sohb or --stack-opening-hash-brace\n -sosb or --stack-opening-square-bracket</pre></dd><dd><p>The flag <strong>-sot</strong> is a synonym for <strong>-sop -sohb -sosb</strong>.</p></dd></html>" EditorType=boolean @@ -763,7 +763,7 @@ Value=0 ValueDefault=0 -[Starting%20indentation%20level] +[Starting indentation level] CallName="--starting-indentation-level=" Category=2 Description="<html>By default, perltidy examines the input file and tries to determine the starting indentation level. While it is often zero, it may not be zero for a code snippet being sent from an editing session. If the default method does not work correctly, or you want to change the starting level, use <strong>-sil=n</strong>, to force the starting level to be n.</html>" @@ -774,7 +774,7 @@ Value=0 ValueDefault=0 -[Static%20Block%20Comment%20Outdent] +[Static Block Comment Outdent] Category=4 Description="<html><dd><p>The command <strong>-osbc</strong> will will cause static block comments to be outdented by 2 spaces (or whatever <strong>-ci=n</strong> has been set to), if possible.</p></dd></html>" EditorType=boolean @@ -782,7 +782,7 @@ Value=0 ValueDefault=0 -[Static%20Block%20Comment%20Prefix] +[Static Block Comment Prefix] CallName="--static-block-comment-prefix=" Category=4 Description="<html><dd><p>This parameter defines the prefix used to identify static block comments when the <strong>-sbc</strong> parameter is set. The default prefix is <code>##</code>, corresponding to <code>-sbcp=##</code>. The prefix is actually part of a perl pattern used to match lines and it must either begin with <code>#</code> or <code>^#</code>. In the first case a prefix ^* will be added to match any leading whitespace, while in the second case the pattern will match only comments with no leading whitespace. For example, to identify all comments as static block comments, one would use <code>-sbcp=#</code>. To identify all left-adjusted comments as static block comments, use <code>-sbcp='^#'</code>.</p></dd><dd><p>Please note that <strong>-sbcp</strong> merely defines the pattern used to identify static block comments; it will not be used unless the switch <strong>-sbc</strong> is set. Also, please be aware that since this string is used in a perl regular expression which identifies these comments, it must enable a valid regular expression to be formed.</p></dd><dd><p>A pattern which can be useful is:</p></dd><dd><pre>\n -sbcp=^#{2,}[^#]</pre></dd><dd><p>This pattern requires a static block comment to have at least one character which is neither a # nor a space. It allows a line containing only '#' characters to be rejected as a static block comment. Such lines are often used at the start and end of header information in subroutines and should not be separated from the intervening comments, which typically begin with just a single '#'.</p></dd></html>" @@ -791,7 +791,7 @@ Value=## ValueDefault=## -[Static%20Block%20Comments] +[Static Block Comments] Category=4 Description="<html><dd><p>Static block comments are block comments with a special leading pattern, <code>##</code> by default, which will be treated slightly differently from other block comments. They effectively behave as if they had glue along their left and top edges, because they stick to the left edge and previous line when there is no blank spaces in those places. This option is particularly useful for controlling how commented code is displayed.</p></dd><dl><dt><strong><a name=item__2dsbc_2c__2d_2dstatic_2dblock_2dcomments><strong>-sbc</strong>, <strong>--static-block-comments</strong></a></strong><dd><p>When <strong>-sbc</strong> is used, a block comment with a special leading pattern, <code>##</code> by default, will be treated specially.</p></dd><dd><p>Comments so identified are treated as follows:</p></dd><ul><li><p>If there is no leading space on the line, then the comment will not be indented, and otherwise it may be,</p></li><li><p>no new blank line will be inserted before such a comment, and</p></li><li><p>such a comment will never become a hanging side comment.</p></li></ul><p>For example, assuming <code>@month_of_year</code> is left-adjusted:</p><pre>\n @month_of_year = ( # -sbc (default)\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct',\n ## 'Dec', 'Nov'\n 'Nov', 'Dec');</pre><p>Without this convention, the above code would become</p><pre>\n @month_of_year = ( # -nsbc\n 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct',\n \n ## 'Dec', 'Nov'\n 'Nov', 'Dec'\n );</pre> <p>which is not as clear. The default is to use <strong>-sbc</strong>. This may be deactivated with <strong>-nsbc</strong>.</p></html>" EditorType=boolean @@ -799,7 +799,7 @@ Value=1 ValueDefault=1 -[Static%20Side%20Comment%20Prefix] +[Static Side Comment Prefix] CallName="--static-side-comment-prefix=" Category=4 Description="<html><dd><p>This parameter defines the prefix used to identify static side comments when the <strong>-ssc</strong> parameter is set. The default prefix is <code>##</code>, corresponding to <code>-sscp=##</code>.</p></dd><dd><p>Please note that <strong>-sscp</strong> merely defines the pattern used to identify static side comments; it will not be used unless the switch <strong>-ssc</strong> is set. Also, note that this string is used in a perl regular expression which identifies these comments, so it must enable a valid regular expression to be formed.</p></dd></html>" @@ -808,7 +808,7 @@ Value=## ValueDefault=## -[Static%20Side%20Comments] +[Static Side Comments] Category=4 Description="<html><dd><p>Static side comments are side comments with a special leading pattern. This option can be useful for controlling how commented code is displayed when it is a side comment.</p></dd><dl><dt><strong><a name=item__2dssc_2c__2d_2dstatic_2dside_2dcomments><strong>-ssc</strong>, <strong>--static-side-comments</strong></a></strong><dd><p>When <strong>-ssc</strong> is used, a side comment with a static leading pattern, which is <code>##</code> by default, will be be spaced only a single space from previous character, and it will not be vertically aligned with other side comments.</p></dd><dd><p>The default is <strong>-nssc</strong>.</p></dd></html>" EditorType=boolean @@ -824,7 +824,7 @@ Value=0 ValueDefault=0 -[Trimming%20whitespace%20around%20qw%20quotes] +[Trimming whitespace around qw quotes] Category=3 Choices=--trim-qw|--notrim-qw ChoicesReadable=Trim whitespace|Do not trim whitespace @@ -834,7 +834,7 @@ Value=0 ValueDefault=0 -[Vertical%20tightness] +[Vertical tightness] CallName="--vertical-tightness=" Category=6 Description="<html><p>Opening tokens (except for block braces) are controlled by <strong>-vt=n</strong>, or <strong>--vertical-tightness=n</strong>, where</p><pre>\n -vt=0 always break a line after opening token (default). \n -vt=1 do not break unless this would produce more than one \n step in indentation in a line.\n -vt=2 never break a line after opening token</pre><p>You must also use the <strong>-lp</strong> flag when you use the <strong>-vt</strong> flag; the reason is explained below.</p></html>" @@ -845,7 +845,7 @@ Value=0 ValueDefault=0 -[Vertical%20tightness%20closing] +[Vertical tightness closing] CallName="--vertical-tightness-closing=" Category=6 Description="<html><p>Closing tokens (except for block braces) are controlled by <strong>-vtc=n</strong>, or <strong>--vertical-tightness-closing=n</strong>, where</p><pre>\n -vtc=0 always break a line before a closing token (default), \n -vtc=1 do not break before a closing token which is followed \n by a semicolon or another closing token, and is not in \n a list environment.\n -vtc=2 never break before a closing token.</pre><p>The rules for <strong>-vtc=1</strong> are designed to maintain a reasonable balance between tightness and readability in complex lists.</p></html>" @@ -856,7 +856,7 @@ Value=0 ValueDefault=0 -[Want%20break%20after] +[Want break after] CallName="--want-break-after=" Category=6 Description="<html><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types (separated only by spaces). No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>By default, perltidy breaks <strong>after</strong> these token types: % + - * / x != == >= <= =~ !~ < > | & = **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=</p></dd><dd><p>And perltidy breaks <strong>before</strong> these token types by default: . << >> -> && || //</p></dd><dd><p>To illustrate, to cause a break after a concatenation operator, <code>'.'</code>, rather than before it, the command line would be</p></dd><dd><pre>\n -wba="."</pre></dd><dd><p>As another example, the following command would cause a break before math operators <code>'+'</code>, <code>'-'</code>, <code>'/'</code>, and <code>'*'</code>:</p></dd><dd><pre>\n -wbb="+ - / *"</pre></dd><dd><p>These commands should work well for most of the token types that perltidy uses (use <strong>--dump-token-types</strong> for a list). Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization. However, for a few token types there may be conflicts with hardwired logic which cause unexpected results. One example is curly braces, which should be controlled with the parameter <strong>bl</strong> provided for that purpose.</p></dd></html>" @@ -865,7 +865,7 @@ Value= ValueDefault= -[Want%20break%20before] +[Want break before] CallName="--want-break-before=" Category=6 Description="<html><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types (separated only by spaces). No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>By default, perltidy breaks <strong>after</strong> these token types: % + - * / x != == >= <= =~ !~ < > | & = **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=</p></dd><dd><p>And perltidy breaks <strong>before</strong> these token types by default: . << >> -> && || //</p></dd><dd><p>To illustrate, to cause a break after a concatenation operator, <code>'.'</code>, rather than before it, the command line would be</p></dd><dd><pre>\n -wba="."</pre></dd><dd><p>As another example, the following command would cause a break before math operators <code>'+'</code>, <code>'-'</code>, <code>'/'</code>, and <code>'*'</code>:</p></dd><dd><pre>\n -wbb="+ - / *"</pre></dd><dd><p>These commands should work well for most of the token types that perltidy uses (use <strong>--dump-token-types</strong> for a list). Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization. However, for a few token types there may be conflicts with hardwired logic which cause unexpected results. One example is curly braces, which should be controlled with the parameter <strong>bl</strong> provided for that purpose.</p></dd></html>" @@ -874,7 +874,7 @@ Value= ValueDefault= -[Want%20left%20space] +[Want left space] CallName="--want-left-space=" Category=3 Description="<html><dd><p>For those who want more detailed control over the whitespace around tokens, there are four parameters which can directly modify the default whitespace rules built into perltidy for any token. They are:</p></dd><dd><p><strong>-wls=s</strong> or <strong>--want-left-space=s</strong>,</p></dd><dd><p><strong>-nwls=s</strong> or <strong>--nowant-left-space=s</strong>,</p></dd><dd><p><strong>-wrs=s</strong> or <strong>--want-right-space=s</strong>,</p></dd><dd><p><strong>-nwrs=s</strong> or <strong>--nowant-right-space=s</strong>.</p></dd><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types. No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>To illustrate how these are used, suppose it is desired that there be no space on either side of the token types <strong>= + - / *</strong>. The following two parameters would specify this desire:</p></dd><dd><pre>\n -nwls="= + - / *" -nwrs="= + - / *"</pre></dd><dd><p>(Note that the token types are in quotes, and that they are separated by spaces). With these modified whitespace rules, the following line of math:</p></dd><dd><pre>\n $root = -$b + sqrt( $b * $b - 4. * $a * $c ) / ( 2. * $a );</pre></dd><dd><p>becomes this:</p></dd><dd><pre>\n $root=-$b+sqrt( $b*$b-4.*$a*$c )/( 2.*$a );</pre></dd><dd><p>These parameters should be considered to be hints to perltidy rather than fixed rules, because perltidy must try to resolve conflicts that arise between them and all of the other rules that it uses. One conflict that can arise is if, between two tokens, the left token wants a space and the right one doesn't. In this case, the token not wanting a space takes priority.</p></dd><dd><p>It is necessary to have a list of all token types in order to create this type of input. Such a list can be obtained by the command <strong>--dump-token-types</strong>. Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization.</p></dd><dd><p><strong>WARNING</strong> Be sure to put these tokens in quotes to avoid having them misinterpreted by your command shell.</p></dd></html>" @@ -883,7 +883,7 @@ Value= ValueDefault= -[Want%20right%20space] +[Want right space] CallName="--want-right-space=" Category=3 Description="<html><dd><p>For those who want more detailed control over the whitespace around tokens, there are four parameters which can directly modify the default whitespace rules built into perltidy for any token. They are:</p></dd><dd><p><strong>-wls=s</strong> or <strong>--want-left-space=s</strong>,</p></dd><dd><p><strong>-nwls=s</strong> or <strong>--nowant-left-space=s</strong>,</p></dd><dd><p><strong>-wrs=s</strong> or <strong>--want-right-space=s</strong>,</p></dd><dd><p><strong>-nwrs=s</strong> or <strong>--nowant-right-space=s</strong>.</p></dd><dd><p>These parameters are each followed by a quoted string, <strong>s</strong>, containing a list of token types. No more than one of each of these parameters should be specified, because repeating a command-line parameter always overwrites the previous one before perltidy ever sees it.</p></dd><dd><p>To illustrate how these are used, suppose it is desired that there be no space on either side of the token types <strong>= + - / *</strong>. The following two parameters would specify this desire:</p></dd><dd><pre>\n -nwls="= + - / *" -nwrs="= + - / *"</pre></dd><dd><p>(Note that the token types are in quotes, and that they are separated by spaces). With these modified whitespace rules, the following line of math:</p></dd><dd><pre>\n $root = -$b + sqrt( $b * $b - 4. * $a * $c ) / ( 2. * $a );</pre></dd><dd><p>becomes this:</p></dd><dd><pre>\n $root=-$b+sqrt( $b*$b-4.*$a*$c )/( 2.*$a );</pre></dd><dd><p>These parameters should be considered to be hints to perltidy rather than fixed rules, because perltidy must try to resolve conflicts that arise between them and all of the other rules that it uses. One conflict that can arise is if, between two tokens, the left token wants a space and the right one doesn't. In this case, the token not wanting a space takes priority.</p></dd><dd><p>It is necessary to have a list of all token types in order to create this type of input. Such a list can be obtained by the command <strong>--dump-token-types</strong>. Also try the <strong>-D</strong> flag on a short snippet of code and look at the .DEBUG file to see the tokenization.</p></dd><dd><p><strong>WARNING</strong> Be sure to put these tokens in quotes to avoid having them misinterpreted by your command shell.</p></dd></html>"
--- a/indenters/uigui_phpCB.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_phpCB.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[ header] categories=General cfgFileParameterEnding=" " configFilename= @@ -16,7 +16,7 @@ useCfgFileParameter= version=2007-02-21 -[Align%20all%20assignement%20statements] +[Align all assignement statements] Category=0 Description=<html>Align all assignement statements</html> EditorType=boolean @@ -24,7 +24,7 @@ Value=1 ValueDefault=1 -[Align%20all%20assignement%20statements%20to%20a%20fixed%20position] +[Align all assignement statements to a fixed position] CallName="--align-equal-statements-to-fixed-pos " Category=0 Description="<html>Align all assignement statements to a fixed position.<hr><table><thead><tr><td width='50%'>Source</td><td width='50%'>With --align-equal-statements-to-fixed-pos 40</td></tr></thead><tbody><tr><td width='50%'><pre><?php <br>$noError = true; <br>$feildEmpty = false; <br>$showMessage = false; <br>$showMessage = false; <br>$anotherVariable[0123] = 'bla bla bla'; <br>$showBlaBlaBlaMessage = false; <br>?></pre></td><td width='50%'><pre><?php <br>$noError<span> </span> = true; <br>$feildEmpty<span> </span> = false; <br>$showMessage<span> </span> = false; <br>$showMessage<span> </span> = false; <br>$anotherVariable[0123]<span> </span> = 'bla bla bla'; <br>$showBlaBlaBlaMessage<span> </span> = false; <br>?> </pre></td></tr></tbody></table></html>" @@ -35,7 +35,7 @@ Value=30 ValueDefault=30 -[Allow%20to%20insert%20a%20space%20after%20%27%28%27] +[Allow to insert a space after '('] Category=0 Description=<html>Allow to insert a space after start bracket '('</html> EditorType=boolean @@ -43,7 +43,7 @@ Value=0 ValueDefault=0 -[Allow%20to%20insert%20a%20space%20after%20%27if%27] +[Allow to insert a space after 'if'] Category=0 Description=<html>Allow to insert a space after 'if' keyword</html> EditorType=boolean @@ -51,7 +51,7 @@ Value=1 ValueDefault=1 -[Allow%20to%20insert%20a%20space%20after%20%27switch%27] +[Allow to insert a space after 'switch'] Category=0 Description=<html>Allow to insert a space after 'switch' keyword</html> EditorType=boolean @@ -59,7 +59,7 @@ Value=1 ValueDefault=1 -[Allow%20to%20insert%20a%20space%20after%20%27while%27] +[Allow to insert a space after 'while'] Category=0 Description=<html>Allow to insert a space after 'while' keyword</html> EditorType=boolean @@ -67,7 +67,7 @@ Value=1 ValueDefault=1 -[Allow%20to%20insert%20a%20space%20after%20%27%7D%27] +[Allow to insert a space after '}'] Category=0 Description=<html>Allow to insert a space after starting angle bracket '}'</html> EditorType=boolean @@ -75,7 +75,7 @@ Value=1 ValueDefault=1 -[Allow%20to%20insert%20a%20space%20before%20%27%29%27] +[Allow to insert a space before ')'] Category=0 Description=<html>Allow to insert a space before end bracket ')'</html> EditorType=boolean @@ -83,7 +83,7 @@ Value=0 ValueDefault=0 -[Allow%20to%20insert%20a%20space%20before%20%27%7B%27] +[Allow to insert a space before '{'] Category=0 Description=<html>Allow to insert a space before starting angle bracket '{'</html> EditorType=boolean @@ -91,7 +91,7 @@ Value=1 ValueDefault=1 -[Change%20comments] +[Change comments] Category=0 Description="<html>Change '# ...' comments into '// ...' comments<hr><table><thead><tr><td width='33%'>Source</td><td width='33%'>With --change-shell-comment-to-double-slashes-comment</td><td width='33%'>Without --change-shell-comment-to-double-slashes-comment</td></tr></thead><tbody><tr><td width='33%'><pre><?php<br><br>#comment content<br>//another comment<br>?></pre></td><td width='33%'><pre><?php<br><br>// comment content<br>// another comment<br>?></pre></td><td width='33%'><pre><?php<br><br># comment content<br>// another comment<br>?></pre></td></tr></tbody></table></html>" EditorType=boolean @@ -99,7 +99,7 @@ Value=1 ValueDefault=1 -[Comment%20render%20style] +[Comment render style] Category=0 Choices="--comment-rendering-style PEAR|--comment-rendering-style PHPDoc" ChoicesReadable="PEAR comment rendering style|PHPDoc comment rendering style" @@ -109,7 +109,7 @@ Value=0 ValueDefault=0 -[Force%20large%20PHP%20code%20tag] +[Force large PHP code tag] Category=0 Description="<html>Change '<?' and '<%' tokens into '<?php' and '%>' into '?>'</html>" EditorType=boolean @@ -117,7 +117,7 @@ Value=1 ValueDefault=1 -[Glue%20%22%26%26%22%20to%20following%20item] +[Glue "&&" to following item] Category=0 Description="<html>Glue '&' to following item<hr><table><thead><tr><td width='50%'>With --glue-amperscore</td><td width='50%'>Without --glue-amperscore</td></tr></thead><tbody><tr><td width='50%'><pre><?php<br>$value = &$objectInstance;<br>?></pre></td><td width='50%'><pre><?php<br>$value = & $objectInstance;<br>?></pre></td><br></tr></tbody></table></html>" EditorType=boolean @@ -125,7 +125,7 @@ Value=1 ValueDefault=1 -[Increase%20padding%20before%20case%20statements] +[Increase padding before case statements] Category=0 Description="<html>Increase padding before case statements:<hr><table><thead><tr><td width='50%'>With --extra-padding-for-case-statement</td><td width='50%'>Without --extra-padding-for-case-statement</td></tr></thead><tbody><tr><td width='50%'><pre><?php<br><br>switch($condition){<br><span> </span>case 1:<br><span> </span> action1();<br><span> </span> break;<br><span> </span>case 2:<br><span> </span> action2();<br><span> </span> break;<br><span> </span>default:<br><span> </span> defaultaction();<br><span> </span> break;<br>}<br>?></pre></td><td width='50%'><pre><?php<br><br>switch($condition){<br>case 1:<br> action1();<br> break;<br>case 2:<br> action2();<br> break;<br>default:<br> defaultaction();<br> break;<br>}<br>?></pre></td></tr></tbody></table></html>" EditorType=boolean @@ -133,7 +133,7 @@ Value=0 ValueDefault=0 -[Indent%20with%20TAB] +[Indent with TAB] Category=0 Description="<html>If selected, tabulation (ASCII #9) character is used to indent text, elsewhere space (ASCII #32) character is used</html>" EditorType=boolean @@ -141,7 +141,7 @@ Value=0 ValueDefault=0 -[Lowercase%20for%20NULL%2C%20TRUE%20and%20FALSE%20constants] +[Lowercase for NULL, TRUE and FALSE constants] Category=0 Description="<html>Lowercase for NULL, TRUE and FALSE constants as encouraged in PEAR coding standards<hr><table><thead><tr><td width='50%'>With --force-true-false-null-contant-lowercase</td><td width='50%'>Without --force-true-false-null-contant-lowercase</td></tr></thead><tbody><tr><td width='50%'><pre><?php<br>if(<strong>true</strong>){<br> if(<strong>false</strong>){<br> $value = <strong>null</strong>;<br> }<br>}<br>?></pre></td><td width='50%'><pre><?php<br>if(<strong>TRUE</strong>){<br> if(<strong>FALSE</strong>){<br> $value = <strong>NULL</strong>;<br> }<br>}<br>?></pre></td></tr></tbody></table></html>" EditorType=boolean @@ -149,7 +149,7 @@ Value=1 ValueDefault=1 -[Padding%20char%20count] +[Padding char count] CallName="--padding-char-count " Category=0 Description=<html>Indent using # spaces per indent</html> @@ -160,7 +160,7 @@ Value=4 ValueDefault=4 -[Use%20%22One%20true%20brace%22%20formating%20for%20functions] +[Use "One true brace" formating for functions] Category=0 Description="<html>Use 'One true brace' formating for functions<hr><table><thead><tr><td width='50%'>With --one-true-brace-function-declaration</td><td width='50%'>Without --one-true-brace-function-declaration</td></tr></thead><tbody><tr><td width='50%'><pre><?php<br><br>function aFunction($param)<br>{<br> // function content<br>}<br>?></pre></td><td width='50%'><pre><?php<br><br>function aFunction($param) {<br> // function content<br>}<br>?></pre></td></tr></tbody></table></html>" EditorType=boolean
--- a/indenters/uigui_phpStylist.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_phpStylist.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories="General|Operators|Functions, Classes and Objects|Control Structures|Arrays and Concatenation|Comments" cfgFileParameterEnding=" " configFilename=
--- a/indenters/uigui_php_Beautifier.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_php_Beautifier.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=General cfgFileParameterEnding=" " configFilename=
--- a/indenters/uigui_shellindent.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_shellindent.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories= cfgFileParameterEnding=" " configFilename=
--- a/indenters/uigui_tidy.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_tidy.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories="HTML, XHTML, XML|Diagnostics|Pretty Print|Character Encoding|Miscellaneous" cfgFileParameterEnding=cr configFilename=htmltidy.cfg @@ -25,7 +25,7 @@ Value=0 ValueDefault=1 -[Uppercase%20tags] +[Uppercase tags] Category=0 Description=<html>This option specifies if Tidy should output tag names in upper case. The default is no, which results in lower case tag names, except for XML input, where the original case is preserved.</html> EditorType=boolean
--- a/indenters/uigui_uncrustify.ini Thu Jun 05 12:30:51 2008 +0000 +++ b/indenters/uigui_uncrustify.ini Fri Jun 06 10:18:15 2008 +0000 @@ -1,4 +1,4 @@ -[%20header] +[header] categories=General options|Indenting|Spacing options|Code alignment (not left column spaces/tabs)|Newline adding and removing options|Positioning options|Line Splitting options|Blank line options|Code modifying options (non-whitespace)|Comment modifications|Preprocessor options cfgFileParameterEnding=cr configFilename=uncrustify.cfg
--- a/src/indenthandler.cpp Thu Jun 05 12:30:51 2008 +0000 +++ b/src/indenthandler.cpp Fri Jun 06 10:18:15 2008 +0000 @@ -702,28 +702,28 @@ // parse ini file indenter header // - indenterName = indenterSettings->value(" header/indenterName").toString(); - indenterFileName = indenterSettings->value(" header/indenterFileName").toString(); - configFilename = indenterSettings->value(" header/configFilename").toString(); - useCfgFileParameter = indenterSettings->value(" header/useCfgFileParameter").toString(); - cfgFileParameterEnding = indenterSettings->value(" header/cfgFileParameterEnding").toString(); + indenterName = indenterSettings->value("header/indenterName").toString(); + indenterFileName = indenterSettings->value("header/indenterFileName").toString(); + configFilename = indenterSettings->value("header/configFilename").toString(); + useCfgFileParameter = indenterSettings->value("header/useCfgFileParameter").toString(); + cfgFileParameterEnding = indenterSettings->value("header/cfgFileParameterEnding").toString(); if ( cfgFileParameterEnding == "cr" ) { cfgFileParameterEnding = "\n"; } - indenterShowHelpParameter = indenterSettings->value(" header/showHelpParameter").toString(); + indenterShowHelpParameter = indenterSettings->value("header/showHelpParameter").toString(); // Read the parameter order. Possible values are (p=parameter[file] i=inputfile o=outputfile) // pio, ipo, iop - parameterOrder = indenterSettings->value(" header/parameterOrder", "pio").toString(); - inputFileParameter = indenterSettings->value(" header/inputFileParameter").toString(); - inputFileName = indenterSettings->value(" header/inputFileName").toString(); - outputFileParameter = indenterSettings->value(" header/outputFileParameter").toString(); - outputFileName = indenterSettings->value(" header/outputFileName").toString(); - fileTypes = indenterSettings->value(" header/fileTypes").toString(); + parameterOrder = indenterSettings->value("header/parameterOrder", "pio").toString(); + inputFileParameter = indenterSettings->value("header/inputFileParameter").toString(); + inputFileName = indenterSettings->value("header/inputFileName").toString(); + outputFileParameter = indenterSettings->value("header/outputFileParameter").toString(); + outputFileName = indenterSettings->value("header/outputFileName").toString(); + fileTypes = indenterSettings->value("header/fileTypes").toString(); fileTypes.replace('|', " "); // read the categories names which are separated by "|" - QString categoriesStr = indenterSettings->value(" header/categories").toString(); + QString categoriesStr = indenterSettings->value("header/categories").toString(); categories = categoriesStr.split("|"); // Assure that the category list is never empty. At least contain a "general" section. if ( categories.isEmpty() ) { @@ -761,7 +761,7 @@ // if it is not the indent header definition read the parameter and add it to // the corresponding category toolbox page - if ( indenterParameter != " header") { + if ( indenterParameter != "header") { // read to which category the parameter belongs int category = indenterSettings->value(indenterParameter + "/Category").toInt(); // Assure that the category number is never greater than the available categories. @@ -1187,7 +1187,7 @@ */ QString IndentHandler::getManual() { if ( indenterSettings != NULL ) { - return indenterSettings->value(" header/manual").toString(); + return indenterSettings->value("header/manual").toString(); } else { return "";