notes.html

c语言格式化源代码

    <h3>Artistic Style 1.8.0 (3 March 1999)</h3>

    <ul>
        <li>Added support for predefined styles. Current supported styles are: <strong>ansi,
        k&amp;r, linux, gnu, java</strong>. these can be set by using '--style=THESTYLE' (e.g.
        '--style=linux').</li>

        <li>Added '--indent-blocks' (or -G) option, which <strong>adds indentation to entire
        blocks</strong>, including their brackets, in similar fashion to the standard gnu
        style.</li>

        <li>Added option '--brackets=linux' (or '-l') which <strong>breaks definition-block
        brackets, but attaches command-block brackets</strong>.</li>

        <li>Padding can now be set separately for operators alone('-p' or '--pad=oper'),
        parentheses alone ('--pad=paren) or both ('-P' or '--pad=all').</li>

        <li>Artistic Style looks for a default options file in the following order:<br />
         1. The contents of the <strong>ARTISTIC_STYLE_OPTIONS</strong> environment variable if it
        exists.<br />
         2. The file called .astylerc in the directory pointed to by the <strong>HOME</strong>
        environment variable ( i.e. <strong>$HOME/.astylerc</strong> ).<br />
         3. The file called .astylerc in the directory pointed to by the <strong>HOMEPATH</strong>
        environment variable ( i.e. <strong>%HOMEPATH%\.astylerc</strong> ).<br />
         If a default options file is found, the options in this file will be parsed BEFORE the
        command-line options. Options within the default option file may be written without the
        preliminary '-' or '--'. Indentation within #if , #else and #endif precompiler commands now
        works correctly even if the program lines between these precompiler commands contain
        non-pared brackets.</li>

        <li>Improved handling of labels (e.g. 'exit:'). By default, labels are now flushed
        completely to the left. Labels can also be indented to one indent LESS than current
        standard indentation by using the new option '--indent-labels' (or '-L') .</li>

        <li>Fixed handling of the 'operator' keyword when it is preceded by a non space character
        (such as '&amp;' or '*').</li>

        <li>Fixed wrong bracket handling after 'throws' statements.</li>

        <li>Fixed wrong indentation of single-line blocks. These where indented 1 indent to
        much.</li>

        <li>Fixed wrong indentation of headers in internal classes (java mode). These where
        indented 1 indent to little.</li>

        <li>The option ' --errors-to-standard-output' now has the one-letter option '-o'.</li>

        <li>Fixed bug which resulted in an unneeded indent in function-declarations in which
        function-variables are declared before the function declaration and are preceded by the
        'static' keyword. Thanks Scott.</li>
    </ul>

    <h3>Artistic Style 1.6.0 (5 January 1999)</h3>

    <ul>
        <li>Fixed zero indentation that resulted when a '-suffix' option was set after a
        '--indent=spaces' (or '-s') option.</li>

        <li>Wrong options are now announced.</li>

        <li>Changed default indentation to NOT automatically indent class blocks and switch blocks.
        Instead, the new options '--indent-classes' (or '-C') and '--indent-switches' (or '-S')
        should be used. The option '--indent-switches' replaces the old option
        '--flush-switches'.</li>
    </ul>

    <h3>Artistic Style 1.4.1 (4 January 1999)</h3>

    <ul>
        <li>Fixed ability to write options without the preceding '--' in the default options
        file.</li>

        <li>Added one-letter options to most options that had only long-options in version
        1.4.0.</li>

        <li>Added a '-v' or '--version' option that writes the current Artistic Style version.</li>
    </ul>

    <h3>Artistic Style 1.4.0 (3 January 1999)</h3>

    <ul>
        <li><strong>MAJOR NEW CHANGE IN THE FORMAT OF OPTIONS:</strong><br />
         Options are now either <strong>short one-letter options</strong> starting with '-', or
        <strong>long multi-letter options</strong> starting with '--'. The Short one-letter options
        MAY BE ATTACHED TOGETHER. Thus, writing '-bps4' is the same as writing '-b -p -s4'.<br />
         Many options that have up to now had a 2 letter format now retain only their long format.
        I truly believe that the combination of attached-one-letter options PLUS a default option's
        file containing long-letter-options related to style will be much easier to work with than
        the previous setup.</li>

        <li>Added support for <strong>a default options file</strong> (pointed to by the
        <strong>ARTISTIC_STYLE_OPTIONS environment variable</strong>).</li>

        <li>Changed downloading method from the server. From now, there will be specific
        directories containing the latest stable sources, stable binaries, and development
        sources.</li>

        <li>Space padding ('-p' or '--pad') now works correctly (1) around semicolons and commas,
        (2) between headers that require parentheses after them (such as 'if', 'while'...)and those
        parentheses, and (3) after parentheses (unless immediately followed by a ';' or ',' or
        '.').</li>

        <li>From now on, namespace blocks are NOT indented by default. To indent namespace blocks
        use the new '--indent-namespaces' option.</li>

        <li>Added options '--errors-to-standard-output' for redirection of standard-error to
        standard-output from within Artistic Style, and '--suffix=' for specifying a suffix other
        than '.orig' to append to original filenames.</li>

        <li>Corrected indentation of 'default' in switch statements. (Up to now, this only worked
        correctly in java mode...).</li>
    </ul>

    <h3>Artistic Style 1.2.0 (19 December 1998)</h3>

    <ul>
        <li>Artistic Style 1.2.0 is the first stable result of a new version numbering, in which
        development versions are numbered with an odd minor number (such as 1.1.x), and stable
        versions are numbered with an even number (1.2.x). Thus, version 1.2.0 accumulates all the
        additions/changes of the 1.1.x development versions of Artistic Style.</li>

        <li>A new '-ol' formatting mode that eliminates breaking of one-line blocks.</li>

        <li>Fixed a SERIOUS bug, which resulted in wrong formatting of brackets ('{', '}') that
        came IMMEDIATELY AFTER definition type brackets, (e.g. brackets that come right after
        'class', 'interface', 'name-space', etc ...). This bug was mistakenly introduced when I set
        out to correctly space-pad pointer and reference signs, somewhere in version 0.9.x.</li>

        <li>Fixed unwanted elimination of final empty lines.</li>

        <li>Fixed broken indentation of virgin opening-brackets that occur immediately after a
        previous closing-bracket.</li>

        <li>Fixed space-padding to not insert a space in front of ':' characters unless they are a
        part of a '? ... : ' statement.</li>
    </ul>

    <h3>Artistic Style 1.0.5&nbsp; (11 December 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">'extern' blocks now handled correctly.</li>

        <li style="margin-bottom: 0cm;">Fixed handling of ^= in '-p' mode.</li>

        <li style="margin-bottom: 0cm;">Win32 executables now contain wildcard expansion. *** Look
        at the README.TXT for info on how to include wildcard expansion abilities when compiling
        Artistic Style under Win32. (Thanks for the info on wildcard-expansion enabling,
        Nat!!!)</li>
    </ul>

    <h3>Artistic Style 1.0.4&nbsp; (2 December 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Fixed unwanted space-padding around urinary minuses and '-'
        symbols within exponents (e.g. 2.5E-5) when using the '-p' option.</li>
    </ul>

    <h3>Artistic Style 1.0.3&nbsp; (1 December 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Control characters now remain in the indented file.</li>

        <li style="margin-bottom: 0cm;">Fixed a bug in which long quoted white-space sequences
        where mistakenly eliminated in the '-p' mode.</li>

        <li style="margin-bottom: 0cm;">Fixed unwanted line-breaks in '-ab -p' mode, that in some
        cases occurred between '//' and the rest of a line comment.</li>

        <li style="margin-bottom: 0cm;">Fixed handling of '&gt;&gt;=', '&lt;&lt;= ' in '-p'
        mode.</li>
    </ul>

    <h3>Artistic Style 1.0.2 (27 November 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Fixed a SERIOUS bug of missing needed line-breaks in lines
        immediately after line-comments when in '-ab' mode.</li>

        <li style="margin-bottom: 0cm;">Support for the 'finally' header.</li>

        <li style="margin-bottom: 0cm;">lines that contain only white-space now become empty
        lines.</li>
    </ul>

    <h3>Artistic Style 1.0.1&nbsp; (26 November 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Fixed a SERIOUS bug, which lacked a needed line-break
        between closing brackets and the headers that follow them (e.g. '} else') when in '-bb'
        mode. In fixing the bug, I used a variation on a patch sent by Richard Bullington -
        THANKS!</li>

        <li style="margin-bottom: 0cm;">Fixed a set of SERIOUS bugs which inserted an empty
        line into both the start and end of the reindented file.</li>

        <li style="margin-bottom: 0cm;">Improved documentation of formatting options in the file
        astyle.html .</li>
    </ul>

    <h3>Artistic Style 1.0.0 (24 November 1998)</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Indented files now <b>retain the original file name</b>,
        while the original pre-indented file is saved with a ".orig"at its end. Thus, after the
        call "<b>astyle -bb foo.cpp</b>", the newly indented file will be called "<b>foo.cpp"</b>,
        while a file called "<b>foo.cpp.orig</b>" will contain the original pre-indented file.</li>

        <li style="margin-bottom: 0cm;">Artistic Style may now be used and /or modified and/or
        distributed under <b>EITHER</b> the <b>"Artistic License"</b>, or the <b>GNU General Public
        License (GPL).</b></li>

        <li style="margin-bottom: 0cm;">Methods with headers that end with 'const' are now properly
        indented.</li>

        <li style="margin-bottom: 0cm;">Cleaner, more robust, and better documented source
        code.</li>
    </ul>

    <h3>Artistic Style 0.9.2</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Fixed a serious bug which led to a maximal supported source
        code line size of 128 characters!!!</li>

        <li style="margin-bottom: 0cm;">Maximal supported line size is now 1024 characters.</li>

        <li style="margin-bottom: 0cm;">Fixed a serious bug in the handling of brackets inside
        '#define' statements.</li>

        <li>Fixed a serious bug in which '#include' files containing slashes (i.e. #include
        &lt;foo_dir/foo&gt; ) where space-padded when using option '-p' on C, C++ files.</li>
    </ul>

    <h3>Artistic Style 0.9.1</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Much improved space-padding around pointers ('*') and
        references ('&amp;') and the 'operator' key-word in C and C++ source files when using the
        '-p' space padding option.</li>

        <li style="margin-bottom: 0cm;">Fixed several pointer handling bugs which led to potential
        core dumps.</li>

        <li>Version 0.9.1 now includes all the abilities I am planning for the final 1.0 version,
        and <b>should be looked at as the first pre-release version of Artistic Style</b>.</li>
    </ul>

    <h3>Artistic Style 0.9.0</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Added a <b>formatting layer</b> (ASFormatter.cpp) around
        the indentation layer (ASBeautifier.cpp).</li>

        <li style="margin-bottom: 0cm;">
            As a result, the following formatting capabilities have been added: 

            <ul>
                <li style="margin-bottom: 0cm;">Bracket ('{' and '}') placement in either ANSI C
                style or Java style.</li>

                <li style="margin-bottom: 0cm;">Space padding around operators, i.e. (1+2)*3-4
                becomes ( 1 + 2 ) * 3 - 4.</li>
            </ul>
        </li>

        <li style="margin-bottom: 0cm;">Fixed the 'tab' elimination bug introduced in ASBeautifier
        0.8.2.</li>

        <li>Fixed a bug which under-indented class headers containing inheritance info.</li>
    </ul>

    <h3>ASBeautifier 0.8.2</h3>

    <ul>
        <li style="margin-bottom: 0cm;">Fixed indentation problem in brackets around 'struct', and
        'union' blocks.</li>

        <li style="margin-bottom: 0cm;">Added recognition for '\' characters in the end of
        lines.</li>

        <li style="margin-bottom: 0cm;">Improved indentation of post-method-declaration variable
        initializations.</li>

        <li>Several minor bug fixes.</li>
    </ul>

    <h3>ASBeautifier 0.8.1</h3>

    <ul>
        <li>Fixed an important bug in pointer arithmetic which resulted both in phantom indentation
        errors, and in core-dumps when trying to indent java files.</li>
    </ul>

    <h3>ASBeautifier 0.8.0</h3>

    <ul>
        <li style="margin-bottom: 0cm;">This is the first public release of ASBeautifier. It is a
        direct port to C++ of JSBeautifier 1.1.1, PLUS extensions to for C++ indentation.</li>

        <li style="margin-bottom: 0cm;">So far, very little beta-testing has been done for the C++
        extensions. This should change extremely with the open-source release (this was the case
        with JSBeautifier...), so expect ASBeautifier to become bug-free fast!!!</li>

        <li>The C++ source code is not yet written in optimal quality. I rushed a little so that I
        could release this initial release as soon as possible. This will soon change.</li>
    </ul>

    <p>&nbsp;</p>
</body>
</html>