4
<meta http-equiv="Content-Language" content="en-us">
5
<title>Artistic Style - Release Notes</title>
6
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7
<meta name="CREATED" content="19981123;1064600">
8
<meta name="CHANGEDBY" content="Jim Pattee">
9
<meta name="CHANGED" content="19981123;1091900">
10
<meta name="GENERATOR" content="Microsoft FrontPage 6.0">
11
<meta name="ProgId" content="FrontPage.Editor.Document">
12
<style> <!-- h1 {color:#0000A0; text-align:center; font-style:italic; font-size:200%;}
15
code {color:#0000A0; font-size:larger;}
21
<h1>Artistic Style Release Notes</h1>
24
<h3>Artistic Style 1.21 (June 2007)</h3>
26
<li>New function, formatArrayBrackets,
27
to improve array formatting and indentation.<li>Attach brackets to lines with end-of-line comments.
28
<li>Break brackets from lines with end-of-line comments without bringing
29
the comments with them.<li>Move ASFormatter and ASBeautifier static initialization
30
from constructor to "init" function to allow for changes in the file type.<li>Add --preserve-date (-Z) option.<li>New functions formatBrackets, padOperators and PadParens to improve decomposition.<li>Add identification of file
31
mode (C, C#, or Java) to file open procedure.<li>Keywords in headers now depend on file
33
Java) and object type (formatter or beautifier).<li>Remove short options -c (mode=c) and -j
34
(mode=java) since the mode is now set automatically from the file extension.<li>Change Linux bracket formatting for header files.<li>Fix formatting of empty blocks.<li>Expand BracketType definition.
35
<li>Fix "do not change" bracket mode inconsistencies with other bracket
37
<li>Remove mode=java from Java predefined style.<li>Change long option --errors-to-standard-output to --errors-to-stdout.<li>Fix breaking of struct variable declaration.<li>Add support for OpenVMS compiler.<li>Inline the ASBeautifier function isLegalNameChar.<li>Fix no-indent of block comments starting in
38
column 1 or 2.<li>Fix formatting of Java anonymous class defined as a method call
39
parameter (bracket within a paren).
40
<li>Fix indentation for Java "for each" statement.<li>Fix bracket being attached to a preprocessor directive.<li>Fix extra indent of single line blocks when a previous line
41
probation header is found.<li>Fix formatting of block comments when continuation lines have
42
different leading whitespace characters.<li>Fix deleting a blank line before a bracket when brackets=attach.<li>Fix segmentation fault on preprocessor continuation line followed by an empty line.<li>Fix bad bracket indent that sometimes occurs when brackets=attach and it
43
cannot be attached.<li>Fix trimming of comment lines.
44
<li>Fix incorrect identification of "new" operator pointers as
46
<li>Fix incorrect identification of assignments as command type bracket.<li>Fix incorrect indentation of pointers following a dot operator or
47
pointer.<li>Fix attaching "else if" statements to a single line block.
48
<li>Fix header recognition problem when header is proceeded by a tab
50
<li>Fix line break when colon is followed by a comment.<li>Fix
51
ASBeautifier not identifying a template definition.<li>Change indents around the end of line to two indents.<li>Change header includes to fix header dependencies for Linux GCC 4.3.<li>Add output line number
52
for debugging.<li>Add filename to trace output.<li>Add trace for arrays.<li>Add trace for bracketType .<li>Fix no-indent comment in a #else preprocessor directive.<li>Fix block comment continuation line indent when block comments do
53
not start the line.<li>Adjust position of block comments (/*) when padding is added or deleted.
54
<li>Fix incorrect formatting if "return" is included in a function name.
55
<li>Fix incorrect padding if template depth is greater that one and pad=oper is used.
56
<li>Fix incorrect bracket type identification when bracket is followed
57
by a comment.<li>Fix incorrect bracket type identification when a "const"
58
method is declared.<li>Fix incorrect bracket type identification when pre-definition header is inside a paren.<li>Fix deleting a space when attaching a bracket with line comments.<li>Fix indentation when the conditional
59
"?" operator is used in a single line
60
statement.<li>Fix indentation when single line "if" statement is used.<li>Add pointers, multiply operators, and selected variables to do not unpad in paren unpad
61
procedure.<li>Return exit code 0 for --version and --help.</ul>
62
<h3>Artistic Style 1.20.2 (February 2007)</h3>
64
<li>Fix problems with the new stream I/O procedure added in release
66
<li>Fix adding an extra blank line at end of document.</li>
67
<li>Fix line ending on last line when cin and cout option is
71
<h3>Artistic Style 1.20.1 (January 2007)</h3>
73
<li>The following changes were made to improve processing for Mac OS X
75
<li>Remove Makefile linker option -s and add a separate "strip"
77
<li>Open console input and output streams as binary to allow Linux line
78
ends on a Windows platform.</li>
79
<li>Change stream I/O procedure to allow for Mac OS 9 line endings.</li>
80
<li>Change output stream end of line from endl so output stream
81
is not flushed with each write.</li>
82
<li>Change information messages from cerr to cout.</li>
83
<li>Removed messages when I/O is to cin and cout to accommodate
87
<h3>Artistic Style 1.20 (January 2007)</h3>
89
<li>Call importOptions() from function AStyleMain() to allow slop in options parameters.</li>
90
<li>New makefiles for GCC and Intel with new compile options.</li>
91
<li>New project file for Visual C with new compile options.</li>
92
<li>Change comments to reflect the GNU Lesser General Public License.</li>
93
<li>Indent message maps for MFC and event tables for wxWidgets.</li>
94
<li>Fix incorrect formatting for an empty comment.</li>
95
<li>Fix "Unknown option" in default options file when last line does not
96
contain CR or LF.</li>
97
<li>Patch from Dieter Bayer to fix case indent when a scope resolution
98
operator is used.</li>
99
<li>Change long option --brackets=break-closing-headers to
100
--brackets=break-closing.</li>
101
<li>Add short option -y for --brackets=break-closing.</li>
102
<li>Add short option -e for --break-elseifs.</li>
103
<li>Add short option -w for --indent-preprocessor.</li>
104
<li>Add short option -f for --break-blocks.</li>
105
<li>Add short option -F for --break-blocks=all.</li>
106
<li>Remove the backup file after formatting when <nobr>--suffix=none.</nobr></li>
107
<li>Show total time at end of job.</li>
108
<li>Improved error handling for invalid options with ASTYLE_LIB.</li>
109
<li>Add function AStyleGetVersion() to ASTYLE_LIB option.</li>
110
<li>Change preprocessor macro from ASTYLE_GUI to ASTYLE_LIB.</li>
111
<li>Add astyle namespace to ASEnhancer.</li>
112
<li>Add #include <ctype.h> for Red Hat distribution of GCC 3.2 (prior to
114
<li>Remove commented-out code.</li>
116
<h3>Artistic Style 1.19 (July 2006)</h3>
118
<li>Add unpad=paren option.</li>
119
<li>Always pad paren headers (e.g. 'if', 'for', 'while').</li>
120
<li>Fix problem of pad=oper working different if pad=paren is declared.</li>
121
<li>Add additional tests to distinguish the multiplication operator from
123
<li>Fix padding parens before a member access pointer (->).</li>
124
<li>If space padding has changed, move end-of-line comments to the
125
original column, if possible.</li>
126
<li>Move potential calculation decision to outside of operator padding
128
<li>Fix duplication of last line of source if a final endline is not
130
<li>Fix class initializer not indented on last line if bracket is
132
<li>Fix identification of templates contained in parens.</li>
133
<li>Fix one line block occurring before end of class.</li>
134
<li>Fix line added after one line block with bracketFormatMode =
136
<li>Add needed variables to ASBeautifier copy constructor.</li>
137
<li>Trim end of line for multi-line comments.</li>
138
<li>Add a breakLine before paren checks (needed for unpad=paren option).</li>
139
<li>Add trace file to ASFormatter.</li>
140
<li>Move formatting message from end to beginning of formatting.</li>
141
<li>Move the building of vectors to ASResource. Vectors for
142
classes ASBeautifier and ASFormatter should now have the same values.</li>
143
<li>Move debugging variable inLineNumber from ASFormatter to
145
<li>Bypass char processing for UTF8 characters in ASBeautifier.</li>
146
<li>Move switchVariables struct from ASEnhancer to the header file. </li>
147
<li>Remove preprocessorHeader vector (not used).</li>
148
<li>Remove variable isInConst (not used).</li>
149
<li>Remove commented-out code.</li>
151
<h3>Artistic Style 1.18 (June 2006)</h3>
153
<li>The following changes were made for the option pad=oper:
155
<li>Does <strong>not</strong> remove extra spaces from formatted
157
<li>Does <strong>not</strong> pad opening parens on the outside.
159
<li>Does <strong>not</strong> remove leading spaces from multi-line
161
<li>Does <strong>not</strong> pad negative numbers. </li>
162
<li>Does <strong>not</strong> add a space to the end of preprocessor
164
<li>Will <strong>not</strong> pad operators inside block parens [].</li>
167
<li>The following changes were made for the option pad=paren:
169
<li>Formats correctly <strong>with</strong> or <strong>without</strong>
171
<li>Does <strong>not</strong> add a space for each additional run if
172
pad=oper is not used. </li>
173
<li>Outside of opening paren is padded correctly. </li>
174
<li>Inside of closing paren is padded correctly. </li>
175
<li>Does <strong>not</strong> pad block parens []. </li>
176
<li>Added short option P, previously used for pad=all.</li>
179
<li>Added new options pad=paren-out (d) and pad=paren-in (D). </li>
180
<li>Removed option pad=all. </li>
181
<li>Add short option V for convert-tabs. </li>
182
<li>Added bounds checking to options containing parameters. </li>
183
<li>Display a message when a default options file is used. </li>
184
<li>Replaced IS_PARAM_OPTION(S) macros with overloaded isParamOption.
185
Fixed compare problem with short param options. </li>
186
<li>Fix EOF problem with default options file.</li>
188
<h3>Artistic Style 1.17 (May 2006)</h3>
190
<li>The following changes were made for processing bracketFormatMode =
193
<li>Removed the function isFormattingEnabled() and always performed
194
the formatting. </li>
195
<li>Removed the formatting bypass for NONE_MODE. </li>
196
<li>Fix brackets always being broken in the 2 cases where NONE_MODE
197
formatting was done. </li>
198
<li>Added new functions to support the processing of NONE_MODE
200
<li>Made other minor changes necessary for correct NONE_MODE
204
<li>Changed indent cases option to indent the entire case block. </li>
205
<li>Changed to output Windows or Linux line endings. </li>
206
<li>Added ASEnhancer module for case statement indenting. </li>
207
<li>Corrected errors in identifying options indent=tab=, and
208
force-indent=tab=. </li>
209
<li>Corrected errors in identifying options min-conditional-indent=, and
210
max-instatement-indent=. </li>
211
<li>Improved error and information messages. </li>
212
<li>Added capability to compile as a console program, shared library, or
213
static library. </li>
214
<li>Fixed problem with semicolons and parens being put on a line by
216
<li>Fixed spaces being added before a line comment. </li>
217
<li>Fixed blank line added after some preprocessor statements. </li>
218
<li>Fixed preprocessor statements not being trimmed. </li>
219
<li>Do not indent line comments that begin in column 1 or 2. </li>
220
<li>Fixed indentation problem with ending }; of class statements. </li>
221
<li>Changed nextLine() function to eliminate char buffer limits. </li>
222
<li>Moved Windows default options file to %USERPROFILE%. </li>
223
<li>Removed NEW operators to prevent memory leaks. </li>
224
<li>Fixed space before the semicolon in return ; statement. </li>
225
<li>Fixed extra space that was sometimes added when pad operators was
227
<li>Removed string parameter from IS_PARAM_OPTION. </li>
228
<li>Added forward declaration of parseOption() to eliminate compile
230
<li>Added input line number counter for debugging. </li>
231
<li>Add statements to check for markers if break-blocks or
232
break-blocks=all is used. </li>
233
<li>Remove warnings for signed/unsigned mismatch. </li>
234
<li>Removed COMPARE macro and used string compare. </li>
235
<li>Removed compiler_defines.h. </li>
236
<li>Removed USES_NAMESPACE declaration.</li>
238
<h3>Artistic Style 1.16</h3>
240
<p>There was no release 1.16.</p>
242
<h3>Artistic Style 1.15.3 (7 March 2002)</h3>
247
Bug fix in handling of brackets after line-comments.</div>
253
Bug fix: C# add/remove event property headers now properly
258
<h3>Artistic Style 1.15.2 (2 March 2002)</h3>
262
Bug fixes in exception handling phrases, e.g. multiple catches and
266
<h3>Artistic Style 1.15.1 (2 March 2002)</h3>
270
Bug fix: C# properties are now formatted properly.</div>
273
<h3>Artistic Style 1.15.0 (2 March 2002)</h3>
277
Added support for C#.</div>
281
Artistic Style is now licensed only under the GNU Public License
286
Compilation under G++ 3.0 now works properly.</div>
290
Bug fix: Opening brackets that appear at the beginning of a line
291
immediately after an empty line comment are now handled properly,
292
and not appended as part of the line comment.</div>
296
Bug fix: Brackets inside comments are now not mis-indented within
301
<h3>Artistic Style 1.14.1 (2 June 2001)</h3>
306
Bug fix: : '<' and '>' symbols within template declarations (e.g.
307
'foo<bar*, xoo>') are now left unpadded in the padding modes.</div>
311
Bug fix: Fixed false recognizing of headers within larger words
312
(e.g. 'catch' in 'gcatch').</div>
315
<h3>Artistic Style 1.14.0 (1 June 2001)</h3>
319
Bug fix: Fixed indentation of statements within preprocessor
320
'#if...' statements.</div>
324
Bug fix: Templates are now not broken from their bodies.</div>
328
Bug fix: '<' and '>' symbols within template definitions (e.g.
329
'template<class T>') are now left unpadded in the padding modes.</div>
332
<h3>Artistic Style 1.13.8 (13 April 2001)</h3>
336
Bug fix: Fixed indentation of multiple nested non-block brackets,
337
such as in multi bracketed static array declarations.</div>
340
<h3>Artistic Style 1.13.7 (6 April 2001)</h3>
344
New option:'--force-indent=tab=#' (or 'T#') instructs astyle to
345
indent using tabs in all the pre-statement white space, including
346
areas astyle's '--indent=tab' prefers to indent using spaces, such
347
as white space in multi-line statements.</div>
351
Bug fix: Fixed unwanted empty line insertions between empty blocks
352
(e.g. '{}') and closing brackets that come immediately after them.</div>
356
Bug fix: Fixed unwanted empty line insertions immediately after
357
colons (e.g. 'default:', 'label:', ...)</div>
362
<h3>Artistic Style 1.13.6 (24 January 2001)</h3>
368
Bug fix: Preprocessor lines now remain unpadded in padding modes.</div>
371
<h3>Artistic Style 1.13.5 (24 January 2001)</h3>
375
Bug fix: Fixed the insertion of phantom empty lines immediately
376
after {} blocks.</div>
380
Bug fix: Bare open brackets ('{') with no preceding headers are now
381
broken appropriately from their preceding code lines in the 'attach'
382
and 'linux' bracketmodes.</div>
386
Bug fix: Fixed operator recognition for long operators such as
387
'>>=', '<<= '.</div>
390
<h3>Artistic Style 1.13.4 (24 January 2001)</h3>
394
Bug fix: L" unicode strings are now handled properly in padding
399
Bug fix: Fixed the padding around '-' operators (which went sour
400
somewhere in the past).</div>
404
Bug fix: Fixed the handling of exponent numbers (e.g. 12.2e+2) in
405
padding modes. The fix enables 'e+' to be regarded as part of the
409
<h3>Artistic Style 1.13.3 (23 January 2001)</h3>
413
Line that contain both headers and their following non-header code
414
(e.g. 'if (isFoo) doBar();') are now broken by default into multiple
415
lines. To keep these lines as single lines, use '--one-line=
416
keep-statements'.</div>
420
Added the new option '--break-elseifs' which breaks 'else if()'
421
statements into multiple lines.</div>
425
The option block breaking options now works properly with the
426
padding options.</div>
430
Various minor bug fixes.</div>
433
<h3>Artistic Style 1.13.2 (21 January 2001)</h3>
437
Added the new option '--brackets=break-closing-headers'. When this
438
option is added to either '--brackets=attach' or '--brackets=
439
linux', astyle breaks closing headers (e.g. 'else', 'catch') from
440
their preceding closing brackets.</div>
444
'--break-blocks' and '--break-blocks= all' now correctly handle
445
blocks that appear immediately before closing brackets, and do not
446
append empty lines between them and the closing brackets.</div>
449
<h3>Artistic Style 1.13.0 (27 September 1999)</h3>
451
<li>Moved back to odd-minor-numbered development versions, and
452
even-minor-numbered stable versions. </li>
453
<li>Added the new option '--break-blocks' which breaks apart unrelated
454
blocks, labels, classes, etc. </li>
455
<li>Added the new option '--break-blocks=all' which also breaks apart
456
blocks of closing headers, such as 'else', 'catch', etc. </li>
457
<li>Fixed indentation handling of labels and class-definition
458
identifiers such as 'public:', 'protected:', ... (thanks to Daryn Adler
460
<li>Fixed indentation of nested class definitions. (thanks to Daryn
461
Adler for his patch) </li>
462
<li>Added the new option '--indent-preprocessor' which (surprisingly)
463
tries to reindent C/C++ preprocessor macro lines. Astyle should do an
464
pretty nice indentation job if the macro code is sane, but don't expect
465
miracles for horrid macro definitions...</li>
467
<h3>Artistic Style 1.11.6 (27 September 1999)</h3>
469
<li>Improved indentation of lines containing single-line blocks.</li>
471
<h3>Artistic Style 1.11.5 (25 September 1999)</h3>
473
<li>Improved the bug fix for a 'const' keyword bug which resulted in
474
wrong indentation of methods that are declared const.</li>
476
<h3>Artistic Style 1.11.4 (18 September 1999)</h3>
478
<li>Improved handling of single colons (':') in class headers, e.g.
479
class Foo : public Bar { ... } </li>
480
<li>Improved handling of single colons (':') in method (constructor)
481
headers, e.g. Foo::Foo(int a) : Bar(a)</li>
483
<h3>Artistic Style 1.11.3 (16 September 1999)</h3>
485
<li>Fixed a serious bug in the formatting of brackets, introduced in
488
<h3>Artistic Style 1.11.2 (10 September 1999)</h3>
490
<li>Fixed an indentation bug in statements that contain the 'const',
491
that resulted in wrong indentation of array blocks that where declared
492
const. (Thanks Daniel!) </li>
493
<li>Fixed an indentation bug that could arise in lines that appear
494
immediately after several preprocessor commands. (Thanks Daniel!). </li>
495
<li>Fixed a bug that inserted an empty line after closing brackets if a
496
comment appeared immediately prior to the closing bracket. (Thanks Ed!)
498
<li>Fixed a bug that eliminated empty lines between closing brackets and
499
immediately following opening brackets. (Thanks Ed!)</li>
501
<h3>Artistic Style 1.11.1 (3 September 1999)</h3>
503
<li>Fixed a bug that inserted an empty line at the begining of source
506
<h3>Artistic Style 1.11.0 (3 September 1999)</h3>
508
<li>Astyle now filters out line-feeds ('\r') before begining to parse
509
lines. This should take care of bizarre formatting that existed when
510
moving source files from Windows (which breaks lines with a linefeed AND
511
newline ("\r\n") to unix (which breaks lines only with newlines). </li>
512
<li>The "struct", "static" and "synchronized" keywords are now finally
513
handled correctly in both the contexts of block headers AND simple
515
<li>Better treatment of precompiler lines that end with backslashes, and
516
the lines that immediately follow them. </li>
517
<li>The '--indent-classes' (or '-C') option now works correctly
519
<li>Series of short command-line options (e.g. "-b -s4 -C") are now
520
parsed correctly.</li>
522
<h3>Artistic Style 1.10.4 (27 July 1999)</h3>
524
<li>Fixed a MAJOR bug (inserted in 1.10.3) that resulted wrong handling
525
of double-colons ('::') in C++. </li>
527
<h3>Artistic Style 1.10.3 (24 July 1999)</h3>
529
<li>Fixed a bug (inserted yesterday) that resulted in unwanted line
530
breaks before closing-brackets. </li>
531
<li>Fixed a bug in the handling of 'static' blocks in java. </li>
532
<li>Added the new option '--indent-cases' (or '-K') for indenting 'case
533
XXX:' lines so they are flush with their following code lines. </li>
534
<li>Added the new option '--fill-empty-lines' (or '-E') which fills
535
empty lines with the white-space of their previous line. </li>
537
<h3>Artistic Style 1.10.2 (23 July 1999)</h3>
539
<li>Fixed a series of related bugs that resulted in certain cases of
540
lacking line breaks after close-brackets, and colons. Thanks Jeroen!</li>
542
<h3>Artistic Style 1.10.1 (18 July 1999)</h3>
544
<li>Fixed a bug (introduced in astyle 1.10.0) that can result in missing
545
line breaks before closing brackets if they appear immediately after
546
comments. Thanks Larry!</li>
548
<h3>Artistic Style 1.10.0 Release (14 July 1999)</h3>
550
<li>Improved handling of empty bracket blocks ( e.g.{ } ). Thanks
553
<h3>Artistic Style 1.10.0 Prerelease (4 July 1999)</h3>
555
<li>Fixed a bug in the in-statement indentation algorithm which resulted
556
in sub-optimal indentation of multiple-line conditional statements that
557
immediately follow headers such as 'if', 'else if', 'while', etc... As a
558
result, the current in-statement indentation is finally what it should
559
have been long ago - MUCH better then in the last stable versions. </li>
560
<li>The "linux" bracket style (in which definition brackets are broken
561
while code brackets are attached) has been fixed, and should finally
562
work correctly. </li>
563
<li>Artistic Style can now parse both C/C++ and Java files in the same
564
command. Unless a specific language mode is specified (e.g. --style=java
565
or --style=c), astyle will now automatically set the language mode
566
according to each file's suffix (java mode for the '.java' suffix , c
567
mode otherwise). </li>
568
<li>Multiple statements in a single line (e.g. aaa; bbb; fff;) are now
569
broken up by default. </li>
570
<li>Added the option '<strong>--one-line=keep-statement</strong>s' (or '<strong>-o</strong>')
571
that keeps multiple statements in a single line attached, thus
572
countering the default break detailed above. </li>
573
<li>Changed the option previously called '<strong>--keep-one-line-blocks</strong>'
574
to '<strong>--one-line=keep-blocks</strong>', for similarity with the
575
new option above. </li>
576
<li>Changed the short option name of the option '-<strong>-errors-to-standard-output</strong>'
577
from '<strong>-o</strong>' to '<strong>-X</strong>'. </li>
578
<li>Up to now, Artistic Style always inserted a minimal indent of
579
<strong>t</strong>wice the current selected indent size<strong> </strong>
580
inside multi-line conditional headers ('if', 'while' ...), so that it
581
would be clear where the headers end and the code after them begins. The
582
current version adds the option '<strong>--min-conditional-indent=#</strong>'
583
(or '<strong>-m#</strong>') that sets the absolute minimal indent
584
between conditional headers and their multiple-line conditional
585
statements. If this option is not specified, the default indent remains
586
<strong>twice the current selected indent size</strong>.<br>
587
For example, This option should come very handy in code that already has
588
brackets after EVERY conditional statement (even if just one line is in
589
that bracket...) - in such a case, it would be wise to set <strong>
590
--min-conditional-indent=0 </strong>since the brackets already make it
591
clear where the header ends and the code begins... </li>
592
<li>Added the ability to set the assumed tab size when in '<strong>--indent-tab</strong>'
593
mode by using '<strong>--indent-tab=#</strong>' or '<strong>-t#</strong>'
594
and replacing the <strong>#</strong> with the wanted size. If the size
595
is not specified, the size of each tab is assumed to be 4 spaces long.</li>
597
<h3>Artistic Style 1.8.2 (18 March 1999)</h3>
599
<li>Fixed pointer handling problems in ASBeautifier that led to crashes
600
when parsing preprocessor commands. </li>
601
<li>Fixed the problem in locating the default options file in the
602
directory pointed to by $HOME or %HOMEPATH% when these system variables
603
do not contain an '/' (or '\' ...) at their end. </li>
604
<li>Fixed inverse insertion of spaces vs. tabs when in -t mode. (Thanks
606
<li>Got rid of those pesky C4786 warnings when compiling under Visual
607
C++ (Thanks John!)</li>
609
<h3>Artistic Style 1.8.1 (9 March 1999)</h3>
611
<li>Changed the '--style=k&r' option to '--style= kr' , so that
612
linux/unix machines don't misinterpret the '&' as a background
613
processing command.</li>
615
<h3>Artistic Style 1.8.0 (3 March 1999)</h3>
617
<li>Added support for predefined styles. Current supported styles are:
618
<strong>ansi, k&r, linux, gnu, java</strong>. these can be set by using
619
'--style=THESTYLE' (e.g. '--style=linux'). </li>
620
<li>Added '--indent-blocks' (or -G) option, which <strong>adds
621
indentation to entire blocks</strong>, including their brackets, in
622
similar fashion to the standard gnu style. </li>
623
<li>Added option '--brackets=linux' (or '-l') which <strong>breaks
624
definition-block brackets, but attaches command-block brackets</strong>.
626
<li>Padding can now be set separately for operators alone('-p' or
627
'--pad=oper'), parentheses alone ('--pad=paren) or both ('-P' or
629
<li>Artistic Style looks for a default options file in the following
631
1. The contents of the <strong>ARTISTIC_STYLE_OPTIONS</strong>
632
environment variable if it exists.<br>
633
2. The file called .astylerc in the directory pointed to by the <strong>
634
HOME</strong> environment variable ( i.e. <strong>$HOME/.astylerc</strong>
636
3. The file called .astylerc in the directory pointed to by the <strong>
637
HOMEPATH</strong> environment variable ( i.e. <strong>
638
%HOMEPATH%\.astylerc</strong> ).<br>
639
If a default options file is found, the options in this file will be
640
parsed BEFORE the command-line options. Options within the default
641
option file may be written without the preliminary '-' or '--'.
642
Indentation within #if , #else and #endif precompiler commands now works
643
correctly even if the program lines between these precompiler commands
644
contain non-pared brackets. </li>
645
<li>Improved handling of labels (e.g. 'exit:'). By default, labels are
646
now flushed completely to the left. Labels can also be indented to one
647
indent LESS than current standard indentation by using the new option
648
'--indent-labels' (or '-L') . </li>
649
<li>Fixed handling of the 'operator' keyword when it is preceded by a
650
non space character (such as '&' or '*'). </li>
651
<li>Fixed wrong bracket handling after 'throws' statements. </li>
652
<li>Fixed wrong indentation of single-line blocks. These where indented
653
1 indent to much. </li>
654
<li>Fixed wrong indentation of headers in internal classes (java mode).
655
These where indented 1 indent to little. </li>
656
<li>The option ' --errors-to-standard-output' now has the one-letter
658
<li>Fixed bug which resulted in an unneeded indent in
659
function-declarations in which function-variables are declared before
660
the function declaration and are preceded by the 'static' keyword.
663
<h3>Artistic Style 1.6.0 (5 January 1999)</h3>
665
<li>Fixed zero indentation that resulted when a '-suffix' option was set
666
after a '--indent=spaces' (or '-s') option.. </li>
667
<li>Wrong options are now announced. </li>
668
<li>Changed default indentation to NOT automatically indent class blocks
669
and switch blocks. Instead, the new options '--indent-classes' (or '-C')
670
and '--indent-switches' (or '-S') should be used. The option
671
'--indent-switches' replaces the old option '--flush-switches'.</li>
673
<h3>Artistic Style 1.4.1 (4 January 1999)</h3>
675
<li>Fixed ability to write options without the preceding '--' in the
676
default options file. </li>
677
<li>Added one-letter options to most options that had only long-options
678
in version 1.4.0 . </li>
679
<li>Added a '-v' or '--version' option that writes the current Artistic
682
<h3>Artistic Style 1.4.0 (3 January 1999)</h3>
684
<li><strong>MAJOR NEW CHANGE IN THE FORMAT OF OPTIONS:</strong><br>
685
Options are now either <strong>short one-letter options</strong>
686
starting with '-', or <strong>long multi-letter options</strong>
687
starting with '--'. The Short one-letter options MAY BE ATTACHED
688
TOGETHER. Thus, writing '-bps4' is the same as writing '-b -p -s4'.<br>
689
Many options that have up to now had a 2 letter format now retain only
690
their long format. I truly believe that the combination of
691
attached-one-letter options PLUS a default option's file containing
692
long-letter-options related to style will be much easier to work with
693
than the previous setup. </li>
694
<li>Added support for <strong>a default options file</strong> (pointed
695
to by the <strong>ARTISTIC_STYLE_OPTIONS environment variable</strong>).
697
<li>Changed downloading method from the server. From now, there will be
698
specific directories containing the latest stable sources, stable
699
binaries, and development sources. </li>
700
<li>Space padding ('-p' or '--pad') now works correctly (1) around
701
semicolons and commas, (2) between headers that require parentheses
702
after them (such as 'if', 'while'...)and those parentheses, and (3)
703
after parentheses (unless immediately followed by a ';' or ',' or '.') .
705
<li>From now on, namespace blocks are NOT indented by default. To indent
706
namespace blocks use the new '--indent-namespaces' option. </li>
707
<li>Added options '--errors-to-standard-output' for redirection of
708
standard-error to standard-output from within Artistic Style, and
709
'--suffix=' for specifying a suffix other than '.orig' to append to
710
original filenames.. </li>
711
<li>Corrected indentation of 'default' in switch statements. (Up to now,
712
this only worked correctly in java mode...). </li>
714
<h3>Artistic Style 1.2.0 (19 December 1998)</h3>
716
<li>Artistic Style 1.2.0 is the first stable result of a new version
717
numbering, in which development versions are numbered with an odd minor
718
number (such as 1.1.x), and stable versions are numbered with an even
719
number (1.2.x). Thus, version 1.2.0 accumulates all the
720
additions/changes of the 1.1.x development versions of Artistic Style.
722
<li>A new '-ol' formatting mode that eliminates breaking of one-line
724
<li>Fixed a SERIOUS bug, which resulted in wrong formatting of brackets
725
('{', '}') that came IMMEDIATELY AFTER definition type brackets, (e.g.
726
brackets that come right after 'class', 'interface', 'name-space', etc
727
...). This bug was mistakenly introduced when I set out to correctly
728
space-pad pointer and reference signs, somewhere in version 0.9.x . </li>
729
<li>Fixed unwanted elimination of final empty lines. </li>
730
<li>Fixed broken indentation of virgin opening-brackets that occur
731
immediately after a previous closing-bracket. </li>
732
<li>Fixed space-padding to not insert a space in front of ':' characters
733
unless they are a part of a '? ... : ' statement.</li>
735
<h3>Artistic Style 1.0.5 (11 December 1998)</h3>
737
<li style="MARGIN-BOTTOM: 0cm">'extern' blocks now handled correctly.
739
<li style="MARGIN-BOTTOM: 0cm">Fixed handling of ^= in '-p' mode. </li>
740
<li style="MARGIN-BOTTOM: 0cm">Win32 executables now contain wildcard
741
expansion. *** Look at the README.TXT for info on how to include
742
wildcard expansion abilities when compiling Artistic Style under Win32.
743
(Thanks for the info on wildcard-expansion enabling, Nat!!!)</li>
745
<h3>Artistic Style 1.0.4 (2 December 1998)</h3>
747
<li style="MARGIN-BOTTOM: 0cm">Fixed unwanted space-padding around
748
urinary minuses and '-' symbols within exponents (e.g. 2.5E-5) when
749
using the '-p' option.</li>
751
<h3>Artistic Style 1.0.3 (1 December 1998)</h3>
753
<li style="MARGIN-BOTTOM: 0cm">Control characters now remain in the
755
<li style="MARGIN-BOTTOM: 0cm">Fixed a bug in which long quoted
756
white-space sequences where mistakenly eliminated in the '-p' mode. </li>
757
<li style="MARGIN-BOTTOM: 0cm">Fixed unwanted line-breaks in '-ab -p'
758
mode, that in some cases occurred between '//' and the rest of a line
760
<li style="MARGIN-BOTTOM: 0cm">Fixed handling of '>>=', '<<= ' in '-p'
763
<h3>Artistic Style 1.0.2 (27 November 1998)</h3>
765
<li style="MARGIN-BOTTOM: 0cm">Fixed a SERIOUS bug of missing
766
needed line-breaks in lines immediately after line-comments when in
768
<li style="MARGIN-BOTTOM: 0cm">Support for the 'finally' header. </li>
769
<li style="MARGIN-BOTTOM: 0cm">lines that contain only white-space now
770
become empty lines.</li>
772
<h3>Artistic Style 1.0.1 (26 November 1998)</h3>
774
<li style="MARGIN-BOTTOM: 0cm">Fixed a SERIOUS bug, which lacked a
775
needed line-break between closing brackets and the headers
776
that follow them (e.g. '} else') when in '-bb' mode. In fixing the bug,
777
I used a variation on a patch sent by Richard Bullington - THANKS! </li>
778
<li style="MARGIN-BOTTOM: 0cm">Fixed a set of SERIOUS bugs which
779
inserted an empty line into both the start and end of the reindented
781
<li style="MARGIN-BOTTOM: 0cm">Improved documentation of formatting
782
options in the file astyle.html .</li>
784
<h3>Artistic Style 1.0.0 (24 November 1998)</h3>
786
<li style="MARGIN-BOTTOM: 0cm">Indented files now <b><u>retain the
787
original file name</u></b>, while the original pre-indented file is
788
saved with a ".orig"at its end. Thus, after the call "<b>astyle -bb
789
foo.cpp</b>", the newly indented file will be called "<b>foo.cpp"</b>,
790
while a file called "<b>foo.cpp.orig</b>" will contain the original
791
pre-indented file. </li>
792
<li style="MARGIN-BOTTOM: 0cm">Artistic Style may now be used and /or
793
modified and/or distributed under <b>EITHER</b> the <b>"Artistic
794
License"</b>, or the <b>GNU General Public License (GPL).</b> </li>
795
<li style="MARGIN-BOTTOM: 0cm">Methods with headers that end with
796
'const' are now properly indented. </li>
797
<li style="MARGIN-BOTTOM: 0cm">Cleaner, more robust, and better
798
documented source code.</li>
800
<h3>Artistic Style 0.9.2</h3>
802
<li style="MARGIN-BOTTOM: 0cm">Fixed a serious bug which led to a
803
maximal supported source code line size of 128 characters!!! </li>
804
<li style="MARGIN-BOTTOM: 0cm">Maximal supported line size is now 1024
806
<li style="MARGIN-BOTTOM: 0cm">Fixed a serious bug in the handling of
807
brackets inside '#define' statements. </li>
808
<li>Fixed a serious bug in which '#include' files containing slashes
809
(i.e. #include <foo_dir/foo> ) where space-padded when using option '-p'
810
on C, C++ files.</li>
812
<h3>Artistic Style 0.9.1</h3>
814
<li style="MARGIN-BOTTOM: 0cm">Much improved space-padding around
815
pointers ('*') and references ('&') and the 'operator' key-word in
816
C and C++ source files when using the '-p' space padding option. </li>
817
<li style="MARGIN-BOTTOM: 0cm">Fixed several pointer handling bugs which
818
led to potential core dumps. </li>
819
<li>Version 0.9.1 now includes all the abilities I am planning for the
820
final 1.0 version, and <b><u>should be looked at as the first
821
pre-release version of Artistic Style</u></b>.</li>
823
<h3>Artistic Style 0.9.0</h3>
825
<li style="MARGIN-BOTTOM: 0cm">Added a <b>formatting layer</b>
826
(ASFormatter.cpp) around the indentation layer (ASBeautifier.cpp). </li>
827
<li style="MARGIN-BOTTOM: 0cm">As a result, the following formatting
828
capabilities have been added:
830
<li style="MARGIN-BOTTOM: 0cm">Bracket ('{' and '}') placement in
831
either ANSI C style or Java style. </li>
832
<li style="MARGIN-BOTTOM: 0cm">Space padding around operators, i.e.
833
(1+2)*3-4 becomes ( 1 + 2 ) * 3 - 4 .</li>
836
<li style="MARGIN-BOTTOM: 0cm">Fixed the 'tab' elimination bug
837
introduced in ASBeautifier 0.8.2 . </li>
838
<li>Fixed a bug which under-indented class headers containing
839
inheritance info.</li>
841
<h3>ASBeautifier 0.8.2</h3>
843
<li style="MARGIN-BOTTOM: 0cm">Fixed indentation problem in brackets
844
around 'struct', and 'union' blocks. </li>
845
<li style="MARGIN-BOTTOM: 0cm">Added recognition for '\' characters in
846
the end of lines. </li>
847
<li style="MARGIN-BOTTOM: 0cm">Improved indentation of
848
post-method-declaration variable initializations. </li>
849
<li>Several minor bug fixes.</li>
851
<h3>ASBeautifier 0.8.1</h3>
853
<li>Fixed an important bug in pointer arithmetic which resulted both in
854
phantom indentation errors, and in core-dumps when trying to indent java
857
<h3>ASBeautifier 0.8.0</h3>
859
<li style="MARGIN-BOTTOM: 0cm">This is the first public release of
860
ASBeautifier. It is a direct port to C++ of JSBeautifier 1.1.1, PLUS
861
extensions to for C++ indentation. </li>
862
<li style="MARGIN-BOTTOM: 0cm">So far, very little beta-testing has been
863
done for the C++ extensions. This should change extremely with the
864
open-source release (this was the case with JSBeautifier...), so expect
865
ASBeautifier to become bug-free fast!!! </li>
866
<li>The C++ source code is not yet written in optimal quality. I rushed
867
a little so that I could release this initial release as soon as
868
possible. This will soon change.</li>
b'\\ No newline at end of file'
added
removed
src/plugins/astyle/astyle/astyle_notes.html
