📄 astyle_notes.html
字号:
statements. If this option is not specified, the default indent remains
<strong>twice the current selected indent size</strong>.<br>
For example, This option should come very handy in code that already has
brackets after EVERY conditional statement (even if just one line is in
that bracket...) - in such a case, it would be wise to set <strong>
--min-conditional-indent=0 </strong>since the brackets already make it
clear where the header ends and the code begins... </li>
<li>Added the ability to set the assumed tab size when in '<strong>--indent-tab</strong>'
mode by using '<strong>--indent-tab=#</strong>' or '<strong>-t#</strong>'
and replacing the <strong>#</strong> with the wanted size. If the size
is not specified, the size of each tab is assumed to be 4 spaces long.</li>
</ul>
<h3>Artistic Style 1.8.2 (18 March 1999)</h3>
<ul>
<li>Fixed pointer handling problems in ASBeautifier that led to crashes
when parsing preprocessor commands. </li>
<li>Fixed the problem in locating the default options file in the
directory pointed to by $HOME or %HOMEPATH% when these system variables
do not contain an '/' (or '\' ...) at their end. </li>
<li>Fixed inverse insertion of spaces vs. tabs when in -t mode. (Thanks
Brian!) </li>
<li>Got rid of those pesky C4786 warnings when compiling under Visual
C++ (Thanks John!)</li>
</ul>
<h3>Artistic Style 1.8.1 (9 March 1999)</h3>
<ul>
<li>Changed the '--style=k&r' option to '--style= kr' , so that
linux/unix machines don't misinterpret the '&' as a background
processing command.</li>
</ul>
<h3>Artistic Style 1.8.0 (3 March 1999)</h3>
<ul>
<li>Added support for predefined styles. Current supported styles are:
<strong>ansi, k&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 '&' 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 (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 (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 (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 '>>=', '<<= ' 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 (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><u>retain the
original file name</u></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 <foo_dir/foo> ) 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 ('&') 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><u>should be looked at as the first
pre-release version of Artistic Style</u></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> </p>
</blockquote>
</body>
</html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -