readme.txt

Artistic Style plugin for Notepad++
-----------------------------------
An Artistic Style plugin for Notepad++ to Format C, C++, C++/CLI, Objective-C, C#, and Java Source Code.

Thanks to developers of Artistic Style, Scintilla and Notepad++.

NOTE: Artistic Style Version 3.4
For information on Artistic Style, please see http://sourceforge.net/projects/astyle/ or https://gitlab.com/saalen/astyle
For information on Scintilla, please see http://www.scintilla.org/ or http://sourceforge.net/projects/scintilla/
For information on Notepad++, please see https://notepad-plus-plus.org/ or https://github.com/notepad-plus-plus/notepad-plus-plus


Name:      NppAStyle
Author:    YWX (wxFortranIndent@163.com)
Created:   2023-12
Copyright: (c) YWX <wxFortranIndent@163.com>
License:   GNU General Public License, version 3

Send bug reports and questions to YWX <wxFortranIndent@163.com>.

Please notice that often trying to correct the bug yourself is the
quickest way to fix it. Even if you fail to do it, you may
discover valuable information allowing us to fix it while doing
it. We also give much higher priority to bug reports with patches
fixing the problems so this ensures that your report will be
addressed sooner.

To get the source code, please visit https://github.com/ywx/NppAStyle
Get a local copy of the Artistic Style Plugin For Notepad++ repository with this command:
git clone git://github.com/ywx/NppAStyle.git NppAStyle-Code

Download NppAStyle.zip (include NppAStyle.dll) from https://github.com/ywx/NppAStyle/releases

For information on Git，please see http://git-scm.com/ or https://github.com/git/git
For information on Git for Windows，please see http://msysgit.github.io/

How to Use NppAStyle
====================
1, Copy NppAStyle.dll to <Notepad++ installation directory>\plugins
   Reboot Notepad++, NppAStyle menu will appear in Plugins menu.
2, Or Use Notepad++ Menu Command : Settings => Import => Import plugin(s)...
3, Run Menu Command : NppAStyle => Options ... , Before First Run Menu Command : NppAStyle => Format Code


                     Artistic Style 3.4
                     Maintained by: Andre Simon, Jim Pattee
                     Original Author: Tal Davidson

Brace Style Options:
--------------------
    None style nothing to do.

    Allman style formatting/indenting.
    Broken braces.

    Java style formatting/indenting.
    Attached braces.

    Kernighan & Ritchie style formatting/indenting.
    Linux braces, with broken closing headers.

    Stroustrup style formatting/indenting.
    Linux braces.

    Whitesmith style formatting/indenting.
    Broken, indented braces.
    Indented class blocks and switch blocks.

    VTK style formatting/indenting.
    Broken, indented braces except for the opening braces.

    Ratliff style formatting/indenting.
    Attached, indented braces.

    GNU style formatting/indenting.
    Broken braces, indented blocks.

    Linux style formatting/indenting.
    Linux braces, minimum conditional indent is one-half indent.

    Horstmann style formatting/indenting.
    Run-in braces, indented switches.

    One True Brace (1TBS) Style formatting/indenting.
    Linux braces, add braces to all conditionals.

    Google style formatting/indenting.
    Attached braces, indented class modifiers.

    Mozilla style formatting/indenting.
    Linux braces, with broken braces for structs and enums,
    and attached braces for namespaces.

    WebKit style formatting/indenting.
    Linux braces, with attached closing headers.

    Pico style formatting/indenting.
    Run-in opening braces and attached closing braces.
    Uses keep one line blocks and keep one line statements.

    Lisp style formatting/indenting.
    Attached opening braces and attached closing braces.
    Uses keep one line statements.

Brace Modify Options:
---------------------
    Attach Namespaces
    Attach braces to a namespace statement.

    Attach Classes
    Attach braces to a class statement.

    Attach Inlines
    Attach braces to class inline function definitions.

    Attach Extern C
    Attach braces to an extern "C" statement.

    Attach closing while
    Attach closing while of do-while to the closing brace.

Function Declaration Options:
---------------------
    Break Func Return Type
    Break Func Return Type Decl
    Break the return type from the function name. Options are
    for the function definitions and the function declarations.

Indentation Options:
--------------------
    Indent classes blocks
    Indent 'class' blocks so that the entire block is indented.

    Indent access modifiers
    Indent 'class' access modifiers, 'public:', 'protected:' or
    'private:', one half indent. The rest of the class is not indented.

    Indent switches blocks
    Indent 'switch' blocks, so that the inner 'case XXX:'
    headers are indented in relation to the switch block.

    Indent case blocks
    Indent case blocks from the 'case XXX:' headers.
    Case statements not enclosed in blocks are NOT indented.

    Indent namespace blocks
    Indent the contents of namespace blocks.

    Indent after parens
    Indent, instead of align, continuation lines following lines
    that contain an opening paren '(' or an assignment '='.

    Indent continuation #
    Indent continuation lines an additional # indents.
    The valid values are 0 thru 4 indents.
    The default value is 1 indent.

    Indent goto labels
    Indent labels so that they appear one indent less than
    the current indentation level, rather than being
    flushed completely to the left (which is the default).

    Indent preproc blocks
    Indent preprocessor blocks at brace level 0.
    Without this option the preprocessor block is not indented.

    Indent preproc conditional
    Indent preprocessor conditional statements #if/#else/#endif
    to the same level as the source code.

    Indent preproc define
    Indent multi-line preprocessor #define statements.

    Indent comments at 1st column
    Indent line comments that start in column one.

    Indent C++ lambda functions (experimental, broken for complex fct bodies)

    Minimum Conditional Indent #
    Indent a minimal # spaces in a continuous conditional
    belonging to a conditional header.
    The valid values are:
    Zero - no minimal indent.
    One  - indent at least one additional indent.
    Two  - indent at least two additional indents.
    One Half - indent at least one-half an additional indent.
    The default value is Two, two additional indents.

    Maximum continuation Indent #
    Indent a maximal # spaces in a continuation line,
    relative to the previous line.
    The valid values are 40 thru 120.
    The default value is 40.

Padding Options:
----------------
    Pad operators
    Insert space padding around operators.

    Pad commas
    Insert space padding after commas.

    Pad parens outside
    Insert space padding around parenthesis on the outside only.

    Pad first paren outside
    Insert space padding around first parenthesis in a series on
    the outside only.

    Pad parens inside
    Insert space padding around parenthesis on the inside only.

    Pad header
    Insert space padding after paren headers (e.g. 'if', 'for'...).

    Unpad parens
    Remove unnecessary space padding around parenthesis. This
    can be used in combination with the 'pad' options above.

    Pad Brackets
    Insert space padding around square brackets on both the outside
    and the inside (experimental).

    Unpad Brackets
    Remove unnecessary space padding around square brackets (experimental).

    Delete empty lines
    Delete empty lines within a function or method.
    It will NOT delete lines added by the break-blocks options.

    Fill empty line
    Fill empty lines with the white space of their previous lines.

    Align pointer : None, Type, Middle, Name
    Attach a pointer or reference operator (*, &, or ^) to either
    the operator type (left), middle, or operator name (right).
    To align the reference separately use --align-reference.

    Align reference : None, Type, Middle, Name, Same as Pointer
    Attach a reference operator (&) to either
    the operator type (left), middle, or operator name (right).
    If not set, follow pointer alignment.

Formatting Options:
-------------------
    Break blocks
    Insert empty lines around unrelated blocks, labels, classes, ...

    Break closing header blocks
    Break braces before closing headers (e.g. 'else', 'catch', ...).
    Use with Brace Style : java, kr, stroustrup, linux, or 1tbs.

    Break else/if statements
    Break 'else if()' statements into two different lines.

    Break one line headers
    Break one line headers (e.g. 'if', 'while', 'else', ...) from a
    statement residing on the same line.

    Add braces
    Add braces to unbraced one line conditional statements.

    Add one line braces
    Add one line braces to unbraced one line conditional statements.

    Remove braces
    Remove braces from a braced one line conditional statements.

    Keep one line blocks
    Don't break blocks residing completely on one line.

    Keep one line statements
    Don't break lines containing multiple statements into
    multiple single-statement lines.

    Close templates
    Close ending angle brackets on template definitions.

    Strip comment prefix
    Remove the leading '*' prefix on multi-line comments and
    indent the comment text one indent.

    Maximum Code Line Width #
    max-code-length=# will break the line if it exceeds more than
    # characters. The valid values are 50 thru 200.

    Break line after logical
    If the line contains logical conditionals they will be placed
    first on the new line. The option break-after-logical will
    cause the logical conditional to be placed last on the previous line.

Objective-C Options:
--------------------
    Pad method prefix
    Insert space padding after the '-' or '+' Objective-C method prefix.

    Unpad method prefix
    Remove all space padding after the '-' or '+' Objective-C method prefix.

    Pad return type
    Insert space padding after the Objective-C return type.

    Unpad return type
    Remove all space padding after the Objective-C return type.

    Pad param type
    Insert space padding after the Objective-C return type.

    Unpad param type
    Remove all space padding after the Objective-C return type.

    Align method colons
    Align the colons in an Objective-C method definition.

    Pad method colons : No Change, None, All, After, Before
    Add or remove space padding before or after the colons in an
    Objective-C method call.