1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
|
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="CREATED" content="19981123;1064600">
<meta name="CHANGEDBY" content="Tal Davidson">
<meta name="CHANGED" content="19981123;1091900">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<title>Artistic Style - Release Notes</title>
<style>
<!--
-->
</style>
</head>
<body bgcolor="#FFFFFF">
<p align="center"><font color="#000080" size="7"><b><i>Artistic
Style - Release notes</i></b></font> </p>
<p align="center"> </p>
<h3>In Artistic Style 1.11.5 (25 September 1999)</h3>
<ul>
<li>Improved the bugfix for a 'const' keyword bug which resulted in wrong indentation of methods that are declared const.</li>
</ul>
<h3>In Artistic Style 1.11.4 (18 September 1999)</h3>
<ul>
<li>Improved handling of single colons (':') in class headers, e.g. class Foo : public Bar { ... }</li>
<li>Improved handling of single colons (':') in method (constructor) headers, e.g. Foo::Foo(int a) : Bar(a)</li>
</ul>
<h3>In Artistic Style 1.11.3 (16 September 1999)</h3>
<ul>
<li>Fixed a serious bug in the formatting of brackets, introduced in 1.11.2.</li>
</ul>
<h3>In Artistic Style 1.11.2 (10 September 1999)</h3>
<ul>
<li>Fixed an indentation bug in statements that contain the 'const', that
resulted in wrong indentation of array blocks that where declared const.
(Thanks Daniel!)</li>
<li>Fixed an indentation bug that could arise in lines that appear immediately after several preprocessor commands. (Thanks Daniel!).</li>
<li>Fixed a bug that inserted an empty line after closing brackets if a
comment appeared immediately prior to the closing bracket. (Thanks Ed!)</li>
<li>Fixed a bug that eliminated empty lines between closing brackets and immediately following opening brackets. (Thanks Ed!)</li>
</ul>
<h3>In Artistic Style 1.11.1 (3 September 1999)</h3>
<ul>
<li>Fixed a bug that inserted an empty line at the begining of source files.
</li>
</ul>
<h3>In Artistic Style 1.11.0 (3 September 1999)</h3>
<ul>
<li>Astyle now filters out linefeeds ('\r') before begining to parse lines.
This should take care of bizzare formatting that existed when moving source
files from Windows (which breaks lines with a linefeed AND newline ("\r\n")
to unix (which breaks lines only with newlines).</li>
<li>The "struct", "static" and "synchronized" keywords are now finally
handled correctly in both the contexts of block headers AND
simple keywords.</li>
<li>Better treatment of precompiler lines that end with backslashes, and
the lines that immediately follow them.</li>
<li>The '--indent-classes' (or '-C') option now works correctly
(again...).</li>
<li>Series of short command-line options (e.g. "-b -s4 -C") are now parsed
correctly.</li>
</ul>
<h3>In Artistic Style 1.10.4 (27 July 1999)</h3>
<ul>
<li>Fixed a MAJOR bug (inserted in 1.10.3) that resulted wrong handling of
double-colons ('::') in C++. </li>
</ul>
<h3>In Artistic Style 1.10.3 (24 July 1999)</h3>
<ul>
<li>Fixed a bug (inserted yesterday) that resulted in unwanted line breaks
before closing-brackets.</li>
<li>Fixed a bug in the handling of 'static' blocks in java.</li>
<li>Added the new option '--indent-cases' (or '-K') for indenting 'case XXX:'
lines so they are flush with their following code lines.</li>
<li>Added the new option '--fill-empty-lines' (or '-E') which fills empty
lines with the white-space of their previous line. </li>
</ul>
<h3>In Artistic Style 1.10.2 (23 July 1999)</h3>
<ul>
<li>Fixed a series of related bugs that resulted in certain cases of lacking line breaks after
close-brackets, and colons. Thanks Jeroen!</li>
</ul>
<h3>In Artistic Style 1.10.1 (18 July 1999)</h3>
<ul>
<li>Fixed a bug (introduced in astyle 1.10.0) that can result in missing line
breaks before closing brackets if they appear immediately after comments. Thanks
Larry!</li>
</ul>
<h3>In Artistic Style 1.10.0 Release (14 July 1999)</h3>
<ul>
<li>Improved handling of empty bracket blocks ( e.g.{ } ). Thanks Michael!</li>
</ul>
<h3>In Artistic Style 1.10.0 Prerelease (4 July 1999)</h3>
<ul>
<li>Fixed a bug in the in-statement indentation algorithm which resulted in
sub-optimal indentation of multiple-line conditional statements that immediately
follow headers such as 'if', 'else if', 'while', etc... As a
result, the current in-statement indentation is finally what it should have
been long ago - MUCH better then in the last stable versions.</li>
<li>The "linux" bracket style (in which definition brackets are
broken while code brackets are attached) has been fixed, and should finally
work correctly.</li>
<li>Artistic Style can now parse both C/C++ and Java files in the same
command. Unless a specific language mode is specified (e.g. --style=java or
--style=c), astyle will now automatically set the language mode according to
each file's suffix (java mode for the '.java' suffix , c mode
otherwise).</li>
<li>Multiple statements in a single line (e.g. aaa; bbb; fff;) are now broken
up by default.</li>
<li>Added the option '<strong>--one-line=keep-statement</strong>s' (or '<strong>-o</strong>')
that keeps multiple statements in a single line attached, thus countering
the default break detailed above.
<li>Changed the option previously called '<strong>--keep-one-line-blocks</strong>'
to '<strong>--one-line=keep-blocks</strong>', for similarity with the new
option above.
<li>Changed the short option name of the option '-<strong>-errors-to-standard-output</strong>'
from '<strong>-o</strong>' to '<strong>-X</strong>'.
<li>Up to now, Artistic Style always inserted a minimal indent of <strong>t</strong>wice
the current selected indent size<strong> </strong>inside multi-line
conditional headers ('if', 'while' ...), so that it would be clear where the
headers end and the code after them begins. The current version adds the
option '<strong>--min-conditional-indent=#</strong>' (or '<strong>-m#</strong>')
that sets the absolute minimal indent between conditional headers and their
multiple-line conditional 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>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.
</ul>
<h3>In 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>In 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>In 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>
</ul>
<ul>
<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>In 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>In 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>In 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>In 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>In Artistic Style 1.0.5 (11 December 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">'extern' blocks now handled
correctly.</li>
<li style="margin-bottom: 0.00cm">Fixed handling of ^= in
'-p' mode.</li>
<li style="margin-bottom: 0.00cm">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>In Artistic Style 1.0.4 (2 December 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">Fixed unwanted
space-padding around urinary minuses and '-' symbols
within exponents (e.g. 2.5E-5) when using the '-p'
option.</li>
</ul>
<h3>In Artistic Style 1.0.3 (1 December 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">Control characters now
remain in the indented file.</li>
<li style="margin-bottom: 0.00cm">Fixed a bug in which long
quoted white-space sequences where mistakenly eliminated
in the '-p' mode.</li>
<li style="margin-bottom: 0.00cm">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: 0.00cm">Fixed handling of
'>>=', '<<=' in '-p' mode.</li>
</ul>
<h3>In Artistic Style 1.0.2 (27 November 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">Fixed a SERIOUS bug of
missing needed line-breaks in lines immediately
after line-comments when in '-ab' mode.</li>
<li style="margin-bottom: 0.00cm">Support for the 'finally'
header.</li>
<li style="margin-bottom: 0.00cm">lines that contain only
white-space now become empty lines.</li>
</ul>
<h3>In Artistic Style 1.0.1 (26 November 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">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: 0.00cm">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: 0.00cm">Improved documentation of
formatting options in the file astyle.html .</li>
</ul>
<h3>In Artistic Style 1.0.0 (24 November 1998)</h3>
<ul>
<li style="margin-bottom: 0.00cm">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: 0.00cm">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: 0.00cm">Methods with headers that
end with 'const' are now properly indented.</li>
<li style="margin-bottom: 0.00cm">Cleaner, more robust, and
better documented source code.</li>
</ul>
<h3>In Artistic Style 0.9.2</h3>
<ul>
<li style="margin-bottom: 0.00cm">Fixed a serious bug which
led to a maximal supported source code line size of 128
characters!!!</li>
<li style="margin-bottom: 0.00cm">Maximal supported line size
is now 1024 characters.</li>
<li style="margin-bottom: 0.00cm">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>In Artistic Style 0.9.1</h3>
<ul>
<li style="margin-bottom: 0.00cm">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: 0.00cm">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>In Artistic Style 0.9.0</h3>
<ul>
<li style="margin-bottom: 0.00cm">Added a <b>formatting layer</b>
(ASFormatter.cpp) around the indentation layer
(ASBeautifier.cpp).</li>
<li style="margin-bottom: 0.00cm">As a result, the following
formatting capabilities have been added:</li>
<li><ul>
<li style="margin-bottom: 0.00cm">Bracket ('{' and
'}') placement in either ANSI C style or Java
style.</li>
<li style="margin-bottom: 0.00cm">Space padding
around operators, i.e. (1+2)*3-4 becomes ( 1 + 2
) * 3 - 4 .</li>
</ul>
</li>
<li style="margin-bottom: 0.00cm">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>In ASBeautifier 0.8.2</h3>
<ul>
<li style="margin-bottom: 0.00cm">Fixed indentation problem
in brackets around 'struct', and 'union' blocks.</li>
<li style="margin-bottom: 0.00cm">Added recognition for '\'
characters in the end of lines.</li>
<li style="margin-bottom: 0.00cm">Improved indentation of
post-method-declaration variable initializations.</li>
<li>Several minor bug fixes.</li>
</ul>
<h3>In 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>In ASBeautifier 0.8.0</h3>
<ul>
<li style="margin-bottom: 0.00cm">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: 0.00cm">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>
<blockquote>
<p> </p>
</blockquote>
</body>
</html>
|
