|
|
|
@@ -17,14 +17,16 @@
|
|
|
|
|
<style type="text/css">
|
|
|
|
|
hr { margin-left: -0.4in; }
|
|
|
|
|
/* the following styles are for formatting code samples */
|
|
|
|
|
div.code { background: #fffdda; padding: 0.5em; border-style: 1px solid;}
|
|
|
|
|
div.code { background: #fffdda; padding: 0.5em; border: 1px gray solid; border-radius: 5px;}
|
|
|
|
|
/* code */
|
|
|
|
|
code { color: navy; }
|
|
|
|
|
code { color: mediumblue; }
|
|
|
|
|
code.title { font-size: larger; font-weight: bold; }
|
|
|
|
|
/* spans */
|
|
|
|
|
span.brace { color: red; }
|
|
|
|
|
span.comment { color: dimgray; font-style: italic; }
|
|
|
|
|
span.option { color: saddlebrown; font-weight: bold; }
|
|
|
|
|
|
|
|
|
|
p.contents2 > a { margin-left: 2em; display: list-item;}
|
|
|
|
|
</style>
|
|
|
|
|
|
|
|
|
|
<!-- When the user scrolls down from the top of the document, show the button -->
|
|
|
|
@@ -62,162 +64,166 @@
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
|
|
|
A Free, Fast, and Small Automatic Formatter<br />
|
|
|
|
|
for C, C++, C++/CLI, Objective‑C, C#, and Java Source Code
|
|
|
|
|
for C, C++, C++/CLI, Objective-C, C#, and Java Source Code
|
|
|
|
|
</h2>
|
|
|
|
|
|
|
|
|
|
<h3 id="Contents">Contents</h3>
|
|
|
|
|
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_General_Information">General Information</a></p>
|
|
|
|
|
<a href="#_General_Information">General Information</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Quick_Start">Quick Start</a></p>
|
|
|
|
|
<a href="#_Quick_Start">Quick Start</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Usage">Usage</a></p>
|
|
|
|
|
<a href="#_Usage">Usage</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Options">Options</a></p>
|
|
|
|
|
<a href="#_Options">Options</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Option_Files">Option Files</a></p>
|
|
|
|
|
<a href="#_Option_Files">Option Files</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Disable_Formatting">Disable Formatting</a></p>
|
|
|
|
|
<a href="#_Disable_Formatting">Disable Formatting</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Basic_Brace_Styles">Basic Brace Styles</a></p>
|
|
|
|
|
<a href="#_Basic_Brace_Styles">Basic Brace Styles</a></p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Brace_Style_Options">Brace Style Options</a></p>
|
|
|
|
|
<a href="#_Brace_Style_Options">Brace Style Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_default_brace_style">default brace style</a>
|
|
|
|
|
<a class="contents" href="#_style=allman">style=allman</a>
|
|
|
|
|
<a class="contents" href="#_style=java">style=java</a>
|
|
|
|
|
<a class="contents" href="#_style=kr">style=kr</a>
|
|
|
|
|
<a class="contents" href="#_style=stroustrup">style=stroustrup</a>
|
|
|
|
|
<a class="contents" href="#_style=whitesmith">style=whitesmith</a>
|
|
|
|
|
<a class="contents" href="#_style=vtk">style=vtk</a>
|
|
|
|
|
<a class="contents" href="#_style=ratliff">style=ratliff</a>
|
|
|
|
|
<a class="contents" href="#_style=gnu">style=gnu</a>
|
|
|
|
|
<a class="contents" href="#_style=linux">style=linux</a>
|
|
|
|
|
<a class="contents" href="#_style=horstmann">style=horstmann</a>
|
|
|
|
|
<a class="contents" href="#_style=1tbs">style=1tbs</a>
|
|
|
|
|
<a class="contents" href="#_style=google">style=google</a>
|
|
|
|
|
<a class="contents" href="#_style=mozilla">style=mozilla</a>
|
|
|
|
|
<a class="contents" href="#_style=webkit">style=webkit</a>
|
|
|
|
|
<a class="contents" href="#_style=pico">style=pico</a>
|
|
|
|
|
<a class="contents" href="#_style=lisp">style=lisp</a>
|
|
|
|
|
<a class="contents" href="#_default_brace_style">default brace style</a>
|
|
|
|
|
<a class="contents" href="#_style=allman">style=allman</a>
|
|
|
|
|
<a class="contents" href="#_style=java">style=java</a>
|
|
|
|
|
<a class="contents" href="#_style=kr">style=kr</a>
|
|
|
|
|
<a class="contents" href="#_style=stroustrup">style=stroustrup</a>
|
|
|
|
|
<a class="contents" href="#_style=whitesmith">style=whitesmith</a>
|
|
|
|
|
<a class="contents" href="#_style=vtk">style=vtk</a>
|
|
|
|
|
<a class="contents" href="#_style=ratliff">style=ratliff</a>
|
|
|
|
|
<a class="contents" href="#_style=gnu">style=gnu</a>
|
|
|
|
|
<a class="contents" href="#_style=linux">style=linux</a>
|
|
|
|
|
<a class="contents" href="#_style=horstmann">style=horstmann</a>
|
|
|
|
|
<a class="contents" href="#_style=1tbs">style=1tbs</a>
|
|
|
|
|
<a class="contents" href="#_style=google">style=google</a>
|
|
|
|
|
<a class="contents" href="#_style=mozilla">style=mozilla</a>
|
|
|
|
|
<a class="contents" href="#_style=webkit">style=webkit</a>
|
|
|
|
|
<a class="contents" href="#_style=pico">style=pico</a>
|
|
|
|
|
<a class="contents" href="#_style=lisp">style=lisp</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Tab_Options">Tab Options</a></p>
|
|
|
|
|
<a href="#_Tab_Options">Tab Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_default_indent">default indent</a>
|
|
|
|
|
<a class="contents" href="#_indent=spaces">indent=spaces</a>
|
|
|
|
|
<a class="contents" href="#_indent=tab">indent=tab</a>
|
|
|
|
|
<a class="contents" href="#_indent=force-tab">indent=force‑tab</a>
|
|
|
|
|
<a class="contents" href="#_indent=force-tab-x">--indent=force‑tab‑x</a>
|
|
|
|
|
<a class="contents" href="#_default_indent">default indent</a>
|
|
|
|
|
<a class="contents" href="#_indent=spaces">indent=spaces</a>
|
|
|
|
|
<a class="contents" href="#_indent=tab">indent=tab</a>
|
|
|
|
|
<a class="contents" href="#_indent=force-tab">indent=force-tab</a>
|
|
|
|
|
<a class="contents" href="#_indent=force-tab-x">--indent=force-tab-x</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Brace_Modify_Options">Brace Modify Options</a></p>
|
|
|
|
|
<a href="#_Brace_Modify_Options">Brace Modify Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_attach_namespaces">attach‑namespaces</a>
|
|
|
|
|
<a class="contents" href="#_attach_classes">attach‑classes</a>
|
|
|
|
|
<a class="contents" href="#_attach_inlines">attach‑inlines</a>
|
|
|
|
|
<a class="contents" href="#_attach-extern-c">attach‑extern‑c</a>
|
|
|
|
|
<a class="contents" href="#_attach-closing-while">attach‑closing‑while</a>
|
|
|
|
|
<a class="contents" href="#_attach_namespaces">attach-namespaces</a>
|
|
|
|
|
<a class="contents" href="#_attach_classes">attach-classes</a>
|
|
|
|
|
<a class="contents" href="#_attach_inlines">attach-inlines</a>
|
|
|
|
|
<a class="contents" href="#_attach-extern-c">attach-extern-c</a>
|
|
|
|
|
<a class="contents" href="#_attach-closing-while">attach-closing-while</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Indentation_Options">Indentation Options</a></p>
|
|
|
|
|
<a href="#_Indentation_Options">Indentation Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_indent-classes">indent‑classes</a>
|
|
|
|
|
<a class="contents" href="#_indent-modifiers">indent‑modifiers</a>
|
|
|
|
|
<a class="contents" href="#_indent-switches">indent‑switches</a>
|
|
|
|
|
<a class="contents" href="#_indent-cases">indent‑cases</a>
|
|
|
|
|
<a class="contents" href="#_indent-namespaces">indent‑namespaces</a>
|
|
|
|
|
<a class="contents" href="#_indent-after-parens">indent‑after‑parens</a>
|
|
|
|
|
<a class="contents" href="#_indent-continuation">indent‑continuation</a>
|
|
|
|
|
<a class="contents" href="#_indent-labels">indent‑labels</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-block">indent‑preproc‑block</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-define">indent‑preproc‑define</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-cond">indent‑preproc‑cond</a>
|
|
|
|
|
<a class="contents" href="#_indent-col1-comments">indent‑col1‑comments</a>
|
|
|
|
|
<a class="contents" href="#_min-conditional-indent">min‑conditional‑indent</a>
|
|
|
|
|
<a class="contents" href="#_max-continuation-indent">max‑continuation‑indent</a>
|
|
|
|
|
<a class="contents" href="#_indent-classes">indent-classes</a>
|
|
|
|
|
<a class="contents" href="#_indent-modifiers">indent-modifiers</a>
|
|
|
|
|
<a class="contents" href="#_indent-switches">indent-switches</a>
|
|
|
|
|
<a class="contents" href="#_indent-cases">indent-cases</a>
|
|
|
|
|
<a class="contents" href="#_indent-namespaces">indent-namespaces</a>
|
|
|
|
|
<a class="contents" href="#_indent-after-parens">indent-after-parens</a>
|
|
|
|
|
<a class="contents" href="#_indent-continuation">indent-continuation</a>
|
|
|
|
|
<a class="contents" href="#_indent-labels">indent-labels</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-block">indent-preproc-block</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-define">indent-preproc-define</a>
|
|
|
|
|
<a class="contents" href="#_indent-preproc-cond">indent-preproc-cond</a>
|
|
|
|
|
<a class="contents" href="#_indent-col1-comments">indent-col1-comments</a>
|
|
|
|
|
<a class="contents" href="#_min-conditional-indent">min-conditional-indent</a>
|
|
|
|
|
<a class="contents" href="#_max-continuation-indent">max-continuation-indent</a>
|
|
|
|
|
<a class="contents" href="#_lambda_indent">lambda-indent</a>
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Padding_Options">Padding Options</a></p>
|
|
|
|
|
<a href="#_Padding_Options">Padding Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_break-blocks">break‑blocks</a>
|
|
|
|
|
<a class="contents" href="#_break-blocks=all">break‑blocks=all</a>
|
|
|
|
|
<a class="contents" href="#_pad-oper">pad‑oper</a>
|
|
|
|
|
<a class="contents" href="#_pad-comma">pad‑comma</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren">pad‑paren</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren-out">pad‑paren‑out</a>
|
|
|
|
|
<a class="contents" href="#_pad-first-paren-out">pad‑first‑paren‑out</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren-in">pad‑paren‑in</a>
|
|
|
|
|
<a class="contents" href="#_pad-header">pad‑header</a>
|
|
|
|
|
<a class="contents" href="#_unpad-paren">unpad‑paren</a>
|
|
|
|
|
<a class="contents" href="#_pad-brackets">pad‑brackets</a>
|
|
|
|
|
<a class="contents" href="#_unpad-brackets">unpad‑brackets</a>
|
|
|
|
|
<a class="contents" href="#_delete-empty-lines">delete‑empty‑lines</a>
|
|
|
|
|
<a class="contents" href="#_fill-empty-lines">fill‑empty‑lines</a>
|
|
|
|
|
<a class="contents" href="#_align-pointer">align‑pointer</a>
|
|
|
|
|
<a class="contents" href="#_align-reference">align‑reference</a>
|
|
|
|
|
<a class="contents" href="#_break-blocks">break-blocks</a>
|
|
|
|
|
<a class="contents" href="#_break-blocks=all">break-blocks=all</a>
|
|
|
|
|
<a class="contents" href="#_pad-oper">pad-oper</a>
|
|
|
|
|
<a class="contents" href="#_pad-comma">pad-comma</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren">pad-paren</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren-out">pad-paren-out</a>
|
|
|
|
|
<a class="contents" href="#_pad-first-paren-out">pad-first-paren-out</a>
|
|
|
|
|
<a class="contents" href="#_pad-paren-in">pad-paren-in</a>
|
|
|
|
|
<a class="contents" href="#_pad-header">pad-header</a>
|
|
|
|
|
<a class="contents" href="#_unpad-paren">unpad-paren</a>
|
|
|
|
|
<a class="contents" href="#_pad-brackets">pad-brackets</a>
|
|
|
|
|
<a class="contents" href="#_unpad-brackets">unpad-brackets</a>
|
|
|
|
|
<a class="contents" href="#_delete-empty-lines">delete-empty-lines</a>
|
|
|
|
|
<a class="contents" href="#_fill-empty-lines">fill-empty-lines</a>
|
|
|
|
|
<a class="contents" href="#_squeeze-ws">squeeze-ws</a>
|
|
|
|
|
<a class="contents" href="#_squeeze-lines">squeeze-lines</a>
|
|
|
|
|
<a class="contents" href="#_align-pointer">align-pointer</a>
|
|
|
|
|
<a class="contents" href="#_align-reference">align-reference</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Formatting_Options">Formatting Options</a></p>
|
|
|
|
|
<a href="#_Formatting_Options">Formatting Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_break-closing-braces">break‑closing‑braces</a>
|
|
|
|
|
<a class="contents" href="#_break-elseifs">break‑elseifs</a>
|
|
|
|
|
<a class="contents" href="#_break-one-line-headers">break‑one‑line‑headers</a>
|
|
|
|
|
<a class="contents" href="#_add-braces">add‑braces</a>
|
|
|
|
|
<a class="contents" href="#_add-one-line-braces">add‑one‑line‑braces</a>
|
|
|
|
|
<a class="contents" href="#_remove-braces">remove‑braces</a>
|
|
|
|
|
<a class="contents" href="#_break-return-type">break‑return‑type</a>
|
|
|
|
|
<a class="contents" href="#_attach-return-type">attach‑return‑type</a>
|
|
|
|
|
<a class="contents" href="#_keep-one-line-blocks">keep‑one‑line‑blocks</a>
|
|
|
|
|
<a class="contents" href="#_keep-one-line-statements">keep‑one‑line‑statements</a>
|
|
|
|
|
<a class="contents" href="#_convert-tabs">convert‑tabs</a>
|
|
|
|
|
<a class="contents" href="#_close-templates">close‑templates</a>
|
|
|
|
|
<a class="contents" href="#_remove-comment-prefix">remove‑comment‑prefix</a>
|
|
|
|
|
<a class="contents" href="#_max-code-length">max‑code‑length</a>
|
|
|
|
|
<a class="contents" href="#_max-code-length">break‑after‑logical</a>
|
|
|
|
|
<a class="contents" href="#_mode">mode</a>
|
|
|
|
|
<a class="contents" href="#_break-closing-braces">break-closing-braces</a>
|
|
|
|
|
<a class="contents" href="#_break-elseifs">break-elseifs</a>
|
|
|
|
|
<a class="contents" href="#_break-one-line-headers">break-one-line-headers</a>
|
|
|
|
|
<a class="contents" href="#_add-braces">add-braces</a>
|
|
|
|
|
<a class="contents" href="#_add-one-line-braces">add-one-line-braces</a>
|
|
|
|
|
<a class="contents" href="#_remove-braces">remove-braces</a>
|
|
|
|
|
<a class="contents" href="#_break-return-type">break-return-type</a>
|
|
|
|
|
<a class="contents" href="#_attach-return-type">attach-return-type</a>
|
|
|
|
|
<a class="contents" href="#_keep-one-line-blocks">keep-one-line-blocks</a>
|
|
|
|
|
<a class="contents" href="#_keep-one-line-statements">keep-one-line-statements</a>
|
|
|
|
|
<a class="contents" href="#_convert-tabs">convert-tabs</a>
|
|
|
|
|
<a class="contents" href="#_close-templates">close-templates</a>
|
|
|
|
|
<a class="contents" href="#_remove-comment-prefix">remove-comment-prefix</a>
|
|
|
|
|
<a class="contents" href="#_max-code-length">max-code-length</a>
|
|
|
|
|
<a class="contents" href="#_max-code-length">break-after-logical</a>
|
|
|
|
|
<a class="contents" href="#_mode">mode</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Objective_C_Options">Objective‑C Options</a></p>
|
|
|
|
|
<a href="#_Objective_C_Options">Objective-C Options</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_pad-method-prefix">pad‑method‑prefix</a>
|
|
|
|
|
<a class="contents" href="#_unpad-method-prefix">unpad‑method‑prefix</a>
|
|
|
|
|
<a class="contents" href="#_pad-return-type">pad‑return‑type</a>
|
|
|
|
|
<a class="contents" href="#_unpad-return-type">unpad‑return‑type</a>
|
|
|
|
|
<a class="contents" href="#_pad-param-type">pad‑param‑type</a>
|
|
|
|
|
<a class="contents" href="#_unpad-param-type">unpad‑param‑type</a>
|
|
|
|
|
<a class="contents" href="#_align-method-colon">align‑method‑colon</a>
|
|
|
|
|
<a class="contents" href="#_pad-method-colon">pad‑method‑colon</a>
|
|
|
|
|
<a class="contents" href="#_pad-method-prefix">pad-method-prefix</a>
|
|
|
|
|
<a class="contents" href="#_unpad-method-prefix">unpad-method-prefix</a>
|
|
|
|
|
<a class="contents" href="#_pad-return-type">pad-return-type</a>
|
|
|
|
|
<a class="contents" href="#_unpad-return-type">unpad-return-type</a>
|
|
|
|
|
<a class="contents" href="#_pad-param-type">pad-param-type</a>
|
|
|
|
|
<a class="contents" href="#_unpad-param-type">unpad-param-type</a>
|
|
|
|
|
<a class="contents" href="#_align-method-colon">align-method-colon</a>
|
|
|
|
|
<a class="contents" href="#_pad-method-colon">pad-method-colon</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Other_Options">Other Options</a> </p>
|
|
|
|
|
<a href="#_Other_Options">Other Options</a> </p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_suffix">suffix</a> <a class="contents" href="#_suffix=none">suffix=none</a>
|
|
|
|
|
<a class="contents" href="#_recursive">recursive</a>
|
|
|
|
|
<a class="contents" href="#_dry-run">dry-run</a>
|
|
|
|
|
<a class="contents" href="#_exclude">exclude</a>
|
|
|
|
|
<a class="contents" href="#_ignore-exclude-errors">ignore‑exclude‑errors</a>
|
|
|
|
|
<a class="contents" href="#_ignore-exclude-errors-x">ignore‑exclude‑errors‑x</a>
|
|
|
|
|
<a class="contents" href="#_errors-to-stdout">errors‑to‑stdout</a>
|
|
|
|
|
<a class="contents" href="#_preserve-date">preserve‑date</a>
|
|
|
|
|
<a class="contents" href="#_verbose">verbose</a>
|
|
|
|
|
<a class="contents" href="#_formatted">formatted</a>
|
|
|
|
|
<a class="contents" href="#_quiet">quiet</a>
|
|
|
|
|
<a class="contents" href="#_lineend">lineend</a>
|
|
|
|
|
<a class="contents" href="#_suffix">suffix</a> <a class="contents" href="#_suffix=none">suffix=none</a>
|
|
|
|
|
<a class="contents" href="#_recursive">recursive</a>
|
|
|
|
|
<a class="contents" href="#_dry-run">dry-run</a>
|
|
|
|
|
<a class="contents" href="#_exclude">exclude</a>
|
|
|
|
|
<a class="contents" href="#_ignore-exclude-errors">ignore-exclude-errors</a>
|
|
|
|
|
<a class="contents" href="#_ignore-exclude-errors-x">ignore-exclude-errors-x</a>
|
|
|
|
|
<a class="contents" href="#_errors-to-stdout">errors-to-stdout</a>
|
|
|
|
|
<a class="contents" href="#_preserve-date">preserve-date</a>
|
|
|
|
|
<a class="contents" href="#_verbose">verbose</a>
|
|
|
|
|
<a class="contents" href="#_formatted">formatted</a>
|
|
|
|
|
<a class="contents" href="#_quiet">quiet</a>
|
|
|
|
|
<a class="contents" href="#_lineend">lineend</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p class="contents1">
|
|
|
|
|
<a class="contents" href="#_Command_Line_Only">Command Line Only</a></p>
|
|
|
|
|
<a href="#_Command_Line_Only">Command Line Only</a></p>
|
|
|
|
|
<p class="contents2">
|
|
|
|
|
<a class="contents" href="#_options">options</a>
|
|
|
|
|
<a class="contents" href="#_project">project</a>
|
|
|
|
|
<a class="contents" href="#_ascii">ascii</a>
|
|
|
|
|
<a class="contents" href="#_version">version</a>
|
|
|
|
|
<a class="contents" href="#_help">help</a>
|
|
|
|
|
<a class="contents" href="#_html">html</a>
|
|
|
|
|
<a class="contents" href="#_html=">html=</a>
|
|
|
|
|
<a class="contents" href="#_stdin=">stdin=</a>
|
|
|
|
|
<a class="contents" href="#_stdout=">stdout=</a>
|
|
|
|
|
<a class="contents" href="#_options">options</a>
|
|
|
|
|
<a class="contents" href="#_project">project</a>
|
|
|
|
|
<a class="contents" href="#_ascii">ascii</a>
|
|
|
|
|
<a class="contents" href="#_version">version</a>
|
|
|
|
|
<a class="contents" href="#_help">help</a>
|
|
|
|
|
<a class="contents" href="#_html">html</a>
|
|
|
|
|
<a class="contents" href="#_html=">html=</a>
|
|
|
|
|
<a class="contents" href="#_stdin=">stdin=</a>
|
|
|
|
|
<a class="contents" href="#_stdout=">stdout=</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
@@ -269,11 +275,11 @@
|
|
|
|
|
these settings. If no translation is available it will default to English. There is an "ascii" option to use English
|
|
|
|
|
instead of the system language.</p>
|
|
|
|
|
<p>
|
|
|
|
|
The source code for the translations is at the end of ASLocalizer.cpp in the form of an English‑Translation
|
|
|
|
|
The source code for the translations is at the end of ASLocalizer.cpp in the form of an English-Translation
|
|
|
|
|
pair. If you make corrections to a translation, send the source as a bug report and it will be included in the
|
|
|
|
|
next release.</p>
|
|
|
|
|
<p>
|
|
|
|
|
To add a new language, add a new translation class to ASLocalizer.h. Add the English‑Translation pair to
|
|
|
|
|
To add a new language, add a new translation class to ASLocalizer.h. Add the English-Translation pair to
|
|
|
|
|
the constructor in ASLocalizer.cpp. Update the WinLangCode array and add the language code to the function setTranslationClass().
|
|
|
|
|
The ASLocalizer.cpp program contains comments that give web pages for obtaining the LCIDs and language codes.
|
|
|
|
|
Send the source code as a bug report and it will be included in the next release.</p>
|
|
|
|
@@ -284,10 +290,10 @@
|
|
|
|
|
The names of special characters used in programming vary by region. The terminology used by Artistic Style,
|
|
|
|
|
followed by other common names, is<strong>:</strong></p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
braces or curly braces { } ‑ also called brackets, or curly brackets.<br />
|
|
|
|
|
parens or round brackets ( ) ‑ also called parentheses, brackets, circle brackets, or soft brackets.<br />
|
|
|
|
|
square brackets [ ] ‑ also called block parens, brackets, closed brackets, or hard brackets.<br />
|
|
|
|
|
angle brackets < > ‑ also called brackets, pointy brackets, triangular brackets, diamond brackets, tuples,
|
|
|
|
|
braces or curly braces { } - also called brackets, or curly brackets.<br />
|
|
|
|
|
parens or round brackets ( ) - also called parentheses, brackets, circle brackets, or soft brackets.<br />
|
|
|
|
|
square brackets [ ] - also called block parens, brackets, closed brackets, or hard brackets.<br />
|
|
|
|
|
angle brackets < > - also called brackets, pointy brackets, triangular brackets, diamond brackets, tuples,
|
|
|
|
|
or chevrons.
|
|
|
|
|
</blockquote>
|
|
|
|
|
<p>
|
|
|
|
@@ -305,12 +311,12 @@
|
|
|
|
|
hanging indent format is used. If the "exec sql" statement is indented more than the following statements, the
|
|
|
|
|
SQL will be aligned in a single column.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Unicode files encoded as UTF‑16, both big and little endian, will be formatted. The files must begin with
|
|
|
|
|
a byte order mark (BOM) to be recognized. Files encoded as UTF‑32 will be rejected. Some compilers do not
|
|
|
|
|
support these encodings. These files can be converted to UTF‑8 encoding with the program "iconv". There
|
|
|
|
|
Unicode files encoded as UTF-16, both big and little endian, will be formatted. The files must begin with
|
|
|
|
|
a byte order mark (BOM) to be recognized. Files encoded as UTF-32 will be rejected. Some compilers do not
|
|
|
|
|
support these encodings. These files can be converted to UTF-8 encoding with the program "iconv". There
|
|
|
|
|
are Linux and Windows versions available (the Windows version does not seem to work for all encodings). Visual
|
|
|
|
|
Studio can convert the files from the "File > Advanced Save Options" menu. There are other development environments
|
|
|
|
|
and text editors, such as SciTE, that can convert files to UTF‑8.</p>
|
|
|
|
|
and text editors, such as SciTE, that can convert files to UTF-8.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Embedded statements that are multiple-line and are NOT in a C-type format, such as Python, are usually mal-formatted
|
|
|
|
|
(a C-type format has blocks enclosed by braces and statements terminated by a semi-colon). Macros that define
|
|
|
|
@@ -656,8 +662,8 @@ indent-switches <span class="comment"># cannot do this on the command line</
|
|
|
|
|
a function.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Using the k&r option may cause problems because of the &. This can be resolved by enclosing the k&r
|
|
|
|
|
in quotes (e.g. ‑‑style="k&r") or by using one of the alternates ‑‑style=kr or
|
|
|
|
|
‑‑style=k/r.</p>
|
|
|
|
|
in quotes (e.g. --style="k&r") or by using one of the alternates --style=kr or
|
|
|
|
|
--style=k/r.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>int Foo(bool isBar)
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
@@ -676,7 +682,7 @@ indent-switches <span class="comment"># cannot do this on the command line</
|
|
|
|
|
Stroustrup style uses linux braces. Opening braces are broken from function definitions only. The opening braces
|
|
|
|
|
are attached to everything else, including namespaces, classes, arrays, structs, enums, and statements within
|
|
|
|
|
a function. The closing headers are broken from closing braces (e.g. --break-closing-headers). This style
|
|
|
|
|
frequently is used with attach‑closing‑while, tabbed indents, and an indent of 5
|
|
|
|
|
frequently is used with attach-closing-while, tabbed indents, and an indent of 5
|
|
|
|
|
spaces. </p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>int Foo(bool isBar)
|
|
|
|
@@ -815,7 +821,7 @@ indent-switches <span class="comment"># cannot do this on the command line</
|
|
|
|
|
else, including arrays, structs, enums, and statements within a function. </p>
|
|
|
|
|
<p>
|
|
|
|
|
In the following example, braces have been added to the "return 0;" statement. The option
|
|
|
|
|
‑‑add‑one‑line‑braces can also be used with this style.</p>
|
|
|
|
|
--add-one-line-braces can also be used with this style.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>int Foo(bool isBar)
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
@@ -869,7 +875,7 @@ indent-switches <span class="comment"># cannot do this on the command line</
|
|
|
|
|
<code class="title">--style=webkit / -A17</code><br />
|
|
|
|
|
WebKit style uses linux braces. Opening braces are broken from function definitions only. The opening braces are
|
|
|
|
|
attached to everything else, including namespaces, classes, arrays, structs, enums, and statements within a function.
|
|
|
|
|
This style frequently is used with attach‑closing‑while, and an indent of 4 spaces.
|
|
|
|
|
This style frequently is used with attach-closing-while, and an indent of 4 spaces.
|
|
|
|
|
</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>int Foo(bool isBar)
|
|
|
|
@@ -1159,7 +1165,7 @@ public:
|
|
|
|
|
<code class="title">--indent-modifiers / -xG</code><br />
|
|
|
|
|
Indent 'class ' and 'struct' access modifiers, 'public:', 'protected:'
|
|
|
|
|
and 'private:', one half indent. The rest of the class is not indented. This option is effective
|
|
|
|
|
for C++ files only. If used with indent‑classes this option will be ignored.</p>
|
|
|
|
|
for C++ files only. If used with indent-classes this option will be ignored.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>class Foo
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
@@ -1444,7 +1450,7 @@ error:
|
|
|
|
|
<p id="_indent-col1-comments">
|
|
|
|
|
<code class="title">--indent-col1-comments / -Y</code><br />
|
|
|
|
|
Indent C++ comments beginning in column one. By default C++ comments beginning in column one are
|
|
|
|
|
assumed to be commented‑out code and not indented. This option will allow the comments to be indented with
|
|
|
|
|
assumed to be commented-out code and not indented. This option will allow the comments to be indented with
|
|
|
|
|
the code.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>void Foo()\n"
|
|
|
|
@@ -1509,6 +1515,7 @@ if (a < b
|
|
|
|
|
</div>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p id="_max-continuation-indent">
|
|
|
|
|
<code class="title">--max-continuation-indent=<span class="option">#</span> / -M<span class="option">#</span></code><br />
|
|
|
|
|
Set the maximum of <span class="option">#</span> spaces to indent a continuation line. The
|
|
|
|
@@ -1536,6 +1543,38 @@ fooFunction(barArg1,
|
|
|
|
|
barArg3);
|
|
|
|
|
</pre>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<p id="_lambda_indent">
|
|
|
|
|
<code class="title">--lambda-indent</code><br />
|
|
|
|
|
This option improves indentation of C++ lambda functions. As it currently does not work well with complex lambda function bodies, this feature is not enabled by default.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>void abssort (float* x, unsigned n)
|
|
|
|
|
{
|
|
|
|
|
std::sort (x, x + n,
|
|
|
|
|
[] (float a, float b) {
|
|
|
|
|
return (std::abs (a) < std::abs (b));
|
|
|
|
|
}
|
|
|
|
|
);
|
|
|
|
|
}</pre>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<p class="code">
|
|
|
|
|
becomes:</p>
|
|
|
|
|
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>void abssort (float* x, unsigned n)
|
|
|
|
|
{
|
|
|
|
|
std::sort (x, x + n,
|
|
|
|
|
[] (float a, float b) {
|
|
|
|
|
return (std::abs (a) < std::abs (b));
|
|
|
|
|
}
|
|
|
|
|
);
|
|
|
|
|
}</pre>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<hr />
|
|
|
|
@@ -1673,9 +1712,9 @@ isBar = false;
|
|
|
|
|
<br />
|
|
|
|
|
Insert space padding around the <strong>first</strong> paren in a series on the <strong>outside</strong>
|
|
|
|
|
only. Parens that are empty will not be padded. Any end of line comments will remain in the original column,
|
|
|
|
|
if possible. This can be used with unpad-paren below to remove unwanted spaces. If used with pad‑paren or
|
|
|
|
|
pad‑paren‑out, this option will be ignored. If used with pad‑paren‑in, the result will
|
|
|
|
|
be the pad‑paren.</p>
|
|
|
|
|
if possible. This can be used with unpad-paren below to remove unwanted spaces. If used with pad-paren or
|
|
|
|
|
pad-paren-out, this option will be ignored. If used with pad-paren-in, the result will
|
|
|
|
|
be the pad-paren.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>if (isFoo((a+2), b))
|
|
|
|
|
bar(a, b);
|
|
|
|
@@ -1727,13 +1766,13 @@ isBar = false;
|
|
|
|
|
<br />
|
|
|
|
|
Remove extra space padding around parens on the inside and outside. Any end of line comments will remain
|
|
|
|
|
in the original column, if possible. This option can be used in combination with the paren padding options
|
|
|
|
|
pad‑paren, pad‑paren‑out, pad‑paren‑in,
|
|
|
|
|
and pad‑header above. Only padding that has not been requested by other options will be
|
|
|
|
|
pad-paren, pad-paren-out, pad-paren-in,
|
|
|
|
|
and pad-header above. Only padding that has not been requested by other options will be
|
|
|
|
|
removed.</p>
|
|
|
|
|
<p>
|
|
|
|
|
For example, if a source has parens padded on both the inside and outside, and you want inside only. You need
|
|
|
|
|
to use unpad-paren to remove the outside padding, and pad‑paren‑in to
|
|
|
|
|
retain the inside padding. Using only pad‑paren‑in> would not remove the outside
|
|
|
|
|
to use unpad-paren to remove the outside padding, and pad-paren-in to
|
|
|
|
|
retain the inside padding. Using only pad-paren-in> would not remove the outside
|
|
|
|
|
padding.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>if ( isFoo( ( a+2 ), b ) )
|
|
|
|
@@ -1794,14 +1833,68 @@ isBar = false;
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
foo2 = 2;
|
|
|
|
|
<span class="brace">}</span>
|
|
|
|
|
</pre>
|
|
|
|
|
<span class="brace">}</span></pre>
|
|
|
|
|
</div>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_fill-empty-lines">
|
|
|
|
|
<code class="title">--fill-empty-lines / -E</code><br />
|
|
|
|
|
Fill empty lines with the white space of the previous line.</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_squeeze-lines">
|
|
|
|
|
<code class="title">--squeeze-lines=#</code><br />
|
|
|
|
|
Remove superfluous empty lines exceeding the given number.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>void Foo()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void Foo2()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span>
|
|
|
|
|
</pre>
|
|
|
|
|
<p class="code">
|
|
|
|
|
becomes:</p>
|
|
|
|
|
<pre>void Foo()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void Foo2()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span></pre>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_squeeze-ws">
|
|
|
|
|
<code class="title">--squeeze-ws</code><br />
|
|
|
|
|
Remove superfluous whitespace</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>void Foo ()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span>
|
|
|
|
|
</pre>
|
|
|
|
|
<p class="code">
|
|
|
|
|
becomes:</p>
|
|
|
|
|
<pre>void Foo ()
|
|
|
|
|
<span class="brace">{</span>
|
|
|
|
|
foo1 = 1;
|
|
|
|
|
<span class="brace">}</span></pre>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_align-pointer">
|
|
|
|
@@ -2033,7 +2126,7 @@ else
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_break-return-type">
|
|
|
|
|
<code class="title">--break-return-type / -xB</code><br />
|
|
|
|
|
<code class="title">--break-return-type / -xB</code><br />
|
|
|
|
|
<code class="title">--break-return-type-decl / -xD</code><br />
|
|
|
|
|
Break the return type from the function name. The two options are for the function definitions (-xB), and the
|
|
|
|
|
function declarations or signatures (-xD). If used with --attach-return-type, the result will be to break the
|
|
|
|
@@ -2048,7 +2141,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_attach-return-type">
|
|
|
|
|
<code class="title">--attach-return-type / -xf</code><br />
|
|
|
|
|
<code class="title">--attach-return-type / -xf</code><br />
|
|
|
|
|
<code class="title">--attach-return-type-decl / -xh</code><br />
|
|
|
|
|
Attach the return type to the function name. The two options are for the function definitions (-xf), and the
|
|
|
|
|
function declarations or signatures (-xh). They are intended to undo the --break-return-type options. If used
|
|
|
|
@@ -2138,19 +2231,19 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
<code class="title">--max-code-length=<span class="option">#</span> / -xC<span class="option">#</span>
|
|
|
|
|
<br />
|
|
|
|
|
--break-after-logical / -xL</code><br />
|
|
|
|
|
The option max‑code‑length will break a line if the code exceeds <span class="option">#</span>
|
|
|
|
|
The option max-code-length will break a line if the code exceeds <span class="option">#</span>
|
|
|
|
|
characters. The valid values are <strong>50</strong> thru <strong>200</strong>. Lines without logical conditionals
|
|
|
|
|
will break on a logical conditional (||, &&, ...), comma, paren, semicolon, or space.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Some code will not be broken, such as comments, quotes, and arrays. If used with keep‑one‑line‑blocks
|
|
|
|
|
or add-one-line-braces the blocks will NOT be broken. If used with keep‑one‑line‑statements
|
|
|
|
|
Some code will not be broken, such as comments, quotes, and arrays. If used with keep-one-line-blocks
|
|
|
|
|
or add-one-line-braces the blocks will NOT be broken. If used with keep-one-line-statements
|
|
|
|
|
the statements will be broken at a semicolon if the line goes over the maximum length. If there is no available
|
|
|
|
|
break point within the max code length, the line will be broken at the first available break point after the max
|
|
|
|
|
code length.</p>
|
|
|
|
|
<p>
|
|
|
|
|
By default logical conditionals will be placed first in the new line. The option
|
|
|
|
|
<strong>break‑after‑logical</strong> will cause the logical conditionals to be placed last on the
|
|
|
|
|
previous line. This option has no effect without max‑code‑length.</p>
|
|
|
|
|
<strong>break-after-logical</strong> will cause the logical conditionals to be placed last on the
|
|
|
|
|
previous line. This option has no effect without max-code-length.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>if (thisVariable1 == thatVariable1 || thisVariable2 == thatVariable2 || thisVariable3 == thatVariable3)
|
|
|
|
|
bar();</pre>
|
|
|
|
@@ -2161,7 +2254,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
|| thisVariable3 == thatVariable3)
|
|
|
|
|
bar();</pre>
|
|
|
|
|
<p class="code">
|
|
|
|
|
becomes (with break‑after‑logical):</p>
|
|
|
|
|
becomes (with break-after-logical):</p>
|
|
|
|
|
<pre>if (thisVariable1 == thatVariable1 ||
|
|
|
|
|
thisVariable2 == thatVariable2 ||
|
|
|
|
|
thisVariable3 == thatVariable3)
|
|
|
|
@@ -2185,18 +2278,18 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
|
|
|
|
|
<!-- * * * * * * * * * * * * * Objective-C Options * * * * * * * * * * * * * -->
|
|
|
|
|
|
|
|
|
|
<h3 id="_Objective_C_Options">Objective‑C Options</h3>
|
|
|
|
|
<h3 id="_Objective_C_Options">Objective-C Options</h3>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
These options are effective for Objective‑C files only. The standard paren padding options will still apply
|
|
|
|
|
These options are effective for Objective-C files only. The standard paren padding options will still apply
|
|
|
|
|
to the Objective-C method prefix and return type unless overridden by the following options.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Because of the longer indents sometimes needed for Objective‑C, the option "max-continuation-indent" may
|
|
|
|
|
Because of the longer indents sometimes needed for Objective-C, the option "max-continuation-indent" may
|
|
|
|
|
need to be increased. If you are not getting the paren and square bracket alignment you want, try increasing
|
|
|
|
|
this value. The option is described in the "Indentation Options" section.</p>
|
|
|
|
|
<p id="_pad-method-prefix">
|
|
|
|
|
<code class="title">--pad-method-prefix / -xQ</code><br />
|
|
|
|
|
Insert space padding <strong>after</strong> the '-' or '+' Objective‑C method prefix. This will add
|
|
|
|
|
Insert space padding <strong>after</strong> the '-' or '+' Objective-C method prefix. This will add
|
|
|
|
|
exactly one space. Any additional spaces will be deleted.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>-(void)foo1;
|
|
|
|
@@ -2210,8 +2303,8 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_unpad-method-prefix">
|
|
|
|
|
<code class="title">--unpad-method-prefix / -xR</code><br />
|
|
|
|
|
Remove all space padding <strong>after</strong> the '-' or '+' Objective‑C method prefix.
|
|
|
|
|
This option will be ignored if used with pad‑method‑prefix. This option takes precedence over the
|
|
|
|
|
Remove all space padding <strong>after</strong> the '-' or '+' Objective-C method prefix.
|
|
|
|
|
This option will be ignored if used with pad-method-prefix. This option takes precedence over the
|
|
|
|
|
pad paren outside option.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>- (void) foo1;
|
|
|
|
@@ -2225,7 +2318,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_pad-return-type">
|
|
|
|
|
<code class="title">--pad-return-type / -xq</code><br />
|
|
|
|
|
Insert space padding <strong>after</strong> the Objective‑C return type. This will add exactly one
|
|
|
|
|
Insert space padding <strong>after</strong> the Objective-C return type. This will add exactly one
|
|
|
|
|
space. Any additional spaces will be deleted. </p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>-(void)foo1;
|
|
|
|
@@ -2239,8 +2332,8 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_unpad-return-type">
|
|
|
|
|
<code class="title">--unpad-return-type / -xr</code><br />
|
|
|
|
|
Remove all space padding <strong>after</strong> the Objective‑C return type. This option
|
|
|
|
|
will be ignored if used with pad‑return‑type. This option takes precedence over the pad paren
|
|
|
|
|
Remove all space padding <strong>after</strong> the Objective-C return type. This option
|
|
|
|
|
will be ignored if used with pad-return-type. This option takes precedence over the pad paren
|
|
|
|
|
outside option. </p>
|
|
|
|
|
<div class="code">
|
|
|
|
|
<pre>-(void) foo1;
|
|
|
|
@@ -2254,7 +2347,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_pad-param-type">
|
|
|
|
|
<code class="title">--pad-param-type / -xS</code><br />
|
|
|
|
|
Insert space padding around an Objective‑C parameter type. This will add exactly
|
|
|
|
|
Insert space padding around an Objective-C parameter type. This will add exactly
|
|
|
|
|
one space. Any additional spaces will be deleted. This has precedence over the pad method colon option and
|
|
|
|
|
will always cause space padding after a method colon.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
@@ -2269,7 +2362,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_unpad-param-type">
|
|
|
|
|
<code class="title">--unpad-param-type / -xs</code><br />
|
|
|
|
|
Remove all space padding around an Objective‑C parameter type. This option takes precedence over the
|
|
|
|
|
Remove all space padding around an Objective-C parameter type. This option takes precedence over the
|
|
|
|
|
pad paren outside option. The pad method colon option has precedence over the <strong>opening</strong> paren.
|
|
|
|
|
The closing paren will always be unpadded.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
@@ -2289,7 +2382,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_align-method-colon">
|
|
|
|
|
<code class="title">--align-method-colon / -xM</code><br />
|
|
|
|
|
Align the colons in Objective‑C method declarations
|
|
|
|
|
Align the colons in Objective-C method declarations
|
|
|
|
|
and method calls. If this option is not declared, method definitions will be indented uniformly, and method calls
|
|
|
|
|
will align with the first keyword.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
@@ -2327,11 +2420,11 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
</p>
|
|
|
|
|
<p id="_pad-method-colon">
|
|
|
|
|
<code class="title">--pad-method-colon=none / -xP0<br />
|
|
|
|
|
--pad-method-colon=all / -xP1<br />
|
|
|
|
|
--pad-method-colon=all / -xP1<br />
|
|
|
|
|
--pad-method-colon=after / -xP2<br />
|
|
|
|
|
--pad-method-colon=before / -xP3
|
|
|
|
|
</code><br />
|
|
|
|
|
Add or remove space padding before or after the colons in an Objective‑C method call. These options will
|
|
|
|
|
Add or remove space padding before or after the colons in an Objective-C method call. These options will
|
|
|
|
|
pad exactly one space. Any additional spaces will be deleted. The space padding after the method colon can be
|
|
|
|
|
overridden by pad-param-type.</p>
|
|
|
|
|
<div class="code">
|
|
|
|
@@ -2391,7 +2484,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
required files.</p>
|
|
|
|
|
<p>
|
|
|
|
|
Wildcards are NOT allowed. There may be more than one exclude statement. The file path and name may be placed
|
|
|
|
|
in double quotes (e.g. ‑‑exclude="foo bar.cpp").</p>
|
|
|
|
|
in double quotes (e.g. --exclude="foo bar.cpp").</p>
|
|
|
|
|
<p id="_ignore-exclude-errors">
|
|
|
|
|
<code class="title">--ignore-exclude-errors / -i</code><br />
|
|
|
|
|
Allow processing to continue if there are errors in the "exclude=###" options.<br />
|
|
|
|
@@ -2438,7 +2531,7 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
will be ignored.</p>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<hr style="margin-left: -0.4in;" />
|
|
|
|
|
<hr />
|
|
|
|
|
|
|
|
|
|
<!-- * * * * * * * * * * * * Command-Line Options * * * * * * * * * * * * -->
|
|
|
|
|
|
|
|
|
@@ -2514,17 +2607,13 @@ Foo(bool isFoo);</pre>
|
|
|
|
|
Do not use this with ">" redirection.</p>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<hr style="margin-left: -0.4in;" />
|
|
|
|
|
<hr />
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: -0.4in; text-align: center;">
|
|
|
|
|
<p >
|
|
|
|
|
<a href="http://sourceforge.net/projects/astyle">
|
|
|
|
|
<img src="http://sflogo.sourceforge.net/sflogo.php?group_id=2319&type=16" alt="" />
|
|
|
|
|
</a></p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
|
|
|
|
Andre Simon