astyle_release_notes.html

Artistic Style is a reindenter and reformatter of C, C++, C# and Java source code. When indentin

					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.</li>
		</ul>
		<h3>In Artistic Style 1.8.2&nbsp;(18 March 1999)</h3>
		<ul>
			<li>
			Fixed pointer handling problems in ASBeautifier that led to crashes when 
			parsing preprocessor commands.
			<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>
			Fixed inverse insertion of spaces vs. tabs when in -t mode. (Thanks Brian!)
			<li>
				Got rid of those pesky C4786 warnings when compiling under Visual C++ (Thanks 
				John!)</li>
		</ul>
		<h3>In Artistic Style 1.8.1&nbsp;(9 March 1999)</h3>
		<ul>
			<li>
				Changed the '--style=k&amp;r' option to '--style= kr' , so that linux/unix 
				machines don't misinterpret the '&amp;' as a background processing command.</li>
		</ul>
		<h3>In Artistic Style 1.8.0&nbsp;(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>
				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>
				Added option '--brackets=linux' (or '-l') which <strong>breaks definition-block 
					brackets, but attaches command-block brackets</strong>.
			<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>
				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>
				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 '&amp;' or '*').
			<li>
			Fixed wrong bracket handling after 'throws' statements.
			<li>
			Fixed wrong indentation of single-line blocks. These where indented 1 indent to 
			much.
			<li>
			Fixed wrong indentation of headers in internal classes (java mode). These where 
			indented 1 indent to little.
			<li>
			The option ' --errors-to-standard-output' now has the one-letter option '-o'.
			<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&nbsp;&nbsp; (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>
			Wrong options are now announced.
			<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&nbsp;&nbsp; (4 January 1999)</h3>
		<ul>
			<li>
			Fixed ability to write options without the preceding '--' in the default 
			options file.
			<li>
			Added one-letter options to most options that had only long-options in version 
			1.4.0 .
			<li>
				Added a '-v' or '--version' option that writes the current Artistic Style 
				version.</li>
		</ul>
		<h3>In Artistic Style 1.4.0&nbsp;&nbsp; (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>
				Added support for <strong>a default options file</strong> (pointed to by the <strong>
					ARTISTIC_STYLE_OPTIONS environment variable</strong>).
			<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>
			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>
			From now on, namespace blocks are NOT indented by default. To indent namespace 
			blocks use the new '--indent-namespaces' option.
			<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>
				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&nbsp;&nbsp; (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>
			A new '-ol' formatting mode that eliminates breaking of one-line blocks.
			<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>
			Fixed unwanted elimination of final empty lines.
			<li>
			Fixed broken indentation of virgin opening-brackets that occur immediately 
			after a previous closing-bracket.
			<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&nbsp;&nbsp; (11 December 1998)</h3>
		<ul>
			<li style="MARGIN-BOTTOM: 0cm">
			'extern' blocks now handled correctly.
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed handling of ^= in '-p' mode.
			<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>In Artistic Style 1.0.4&nbsp;&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>In Artistic Style 1.0.3&nbsp;&nbsp; (1 December 1998)</h3>
		<ul>
			<li style="MARGIN-BOTTOM: 0cm">
			Control characters now remain in the indented file.
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed a bug in which long quoted white-space sequences where mistakenly 
			eliminated in the '-p' mode.
			<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 style="MARGIN-BOTTOM: 0cm">
				Fixed handling of '&gt;&gt;=', '&lt;&lt;= ' in '-p' mode.</li>
		</ul>
		<h3>In Artistic Style 1.0.2&nbsp;&nbsp; (27 November 1998)</h3>
		<ul>
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed a SERIOUS bug of missing&nbsp; needed line-breaks in lines immediately 
			after line-comments when in '-ab' mode.
			<li style="MARGIN-BOTTOM: 0cm">
			Support for the 'finally' header.
			<li style="MARGIN-BOTTOM: 0cm">
				lines that contain only white-space now become empty lines.</li>
		</ul>
		<h3>In Artistic Style 1.0.1&nbsp;&nbsp; (26 November 1998)</h3>
		<ul>
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed a SERIOUS bug, which lacked a needed line-break between&nbsp; closing 
			brackets&nbsp; 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 style="MARGIN-BOTTOM: 0cm">
			Fixed a set of&nbsp; SERIOUS bugs which inserted an empty line into both the 
			start and end of the reindented file.
			<li style="MARGIN-BOTTOM: 0cm">
				Improved documentation of formatting options in the file astyle.html .</li>
		</ul>
		<h3>In Artistic Style 1.0.0&nbsp;&nbsp; (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 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 style="MARGIN-BOTTOM: 0cm">
			Methods with headers that end with 'const' are now properly indented.
			<li style="MARGIN-BOTTOM: 0cm">
				Cleaner, more robust, and better documented source code.</li>
		</ul>
		<h3>In 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 style="MARGIN-BOTTOM: 0cm">
			Maximal supported line size is now 1024 characters.
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed a serious bug in the handling of brackets inside '#define' statements.
			<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>In 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&nbsp; in C and C++ source files when using the '-p' 
			space padding option.
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed several pointer handling bugs which led to potential core dumps.
			<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: 0cm">
				Added a <b>formatting layer</b>
			(ASFormatter.cpp) around the indentation layer (ASBeautifier.cpp).
			<li style="MARGIN-BOTTOM: 0cm">
			As a result, the following formatting capabilities have been added:
			<li>
				<ul>
					<li style="MARGIN-BOTTOM: 0cm">
					Bracket ('{' and '}') placement in either ANSI C style or Java style.
					<li style="MARGIN-BOTTOM: 0cm">
						Space padding around operators, i.e. (1+2)*3-4 becomes ( 1 + 2 ) * 3 - 4 .</li>
				</ul>
			<li style="MARGIN-BOTTOM: 0cm">
			Fixed the 'tab' elimination bug introduced in ASBeautifier 0.8.2 .
			<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: 0cm">
			Fixed indentation problem in brackets around 'struct', and 'union' blocks.
			<li style="MARGIN-BOTTOM: 0cm">
			Added recognition for '\' characters in the end of lines.
			<li style="MARGIN-BOTTOM: 0cm">
			Improved indentation of post-method-declaration variable initializations.
			<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: 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 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>
				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>&nbsp;</p>
		</blockquote>
	</body>
</html>