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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Artistic Style - Index</title>
<meta http-equiv="Content-Language" content="en-us" />
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<link href="styles.css" rel="stylesheet" type="text/css" />
</head>
<body>
<!-- body text -->
<h1>
Artistic Style 2.01</h1>
<h2>
A Free, Fast and Small Automatic Formatter<br />
for C, C++, C#, and Java Source Code</h2>
<br />
<center>
<table>
<tbody>
<tr><td>Home Page:</td>
<td><a href="http://astyle.sourceforge.net/">http://astyle.sourceforge.net/</a></td>
</tr>
<tr><td>Project Page:</td>
<td><a href="http://sourceforge.net/projects/astyle/">http://sourceforge.net/projects/astyle/</a></td>
</tr>
</tbody>
</table>
</center>
<p>
</p>
<p class="noindent">
Artistic Style is a source code indenter, formatter, and beautifier for the C, C++, C# and Java programming languages.</p>
<p class="noindent">
When indenting source code, we as programmers have a tendency to use both spaces and tab characters to create
the wanted indentation. Moreover, some editors by default insert spaces instead of tabs when pressing the tab
key, and other editors (Emacs for example) have the ability to "pretty up" lines by automatically setting up the
white space before the code on the line, possibly inserting spaces in a code that up to now used only tabs for
indentation.</p>
<p class="noindent">
Since the NUMBER of space characters showed on screen for each tab character in the source code changes between
editors (unless the user sets up the number to his liking...), one of the standard problems programmers are facing
when moving from one editor to another is that code containing both spaces and tabs that was up to now perfectly
indented, suddenly becomes a mess to look at when changing to another editor. Even if you as a programmer take
care to ONLY use spaces or tabs, looking at other people's source code can still be problematic.</p>
<p class="noindent">
To address this problem, Artistic Style was created - a filter written in C++ that automatically re-indents and
re-formats C / C++ / C# / Java source files. It can be used from a command line, or it can be incorporated as
classes in another C++ program.</p>
<h3>
<a href="astyle.html">Documentation</a></h3>
<p>
There is complete documentation for using Artistic Style. Most documentation is included in the distribution package.</p>
<h3>
<a href="news.html">News</a> and <a href="notes.html">Release Notes</a></h3>
<p>
Information on the changes in the current release. The News contains information on major changes and how they
might affect the use of Artistic Style. The Release Notes contains a list of all changes made to the program.
Information on old releases is also listed.
</p>
<h3>
<a href="http://sourceforge.net/projects/astyle/files/">Download</a></h3>
<p>
The latest release can be downloaded from the SourceForge file releases page. The green "Download Now" button
will, in most cases, download the correct package for your platform. Otherwise you can select the appropriate
package from the "All Files" list. The OpenVMS and Windows packages contain compiled binaries. Other platforms
will need to compile the source code. Makefiles are included for the most popular compilers. Follow the install
instructions for the appropriate platform as described in the "Install Information" documentation.</p>
<h3>
<a href="subversion.html">Subversion</a></h3>
<p>
The latest development files can be checked out from the Artistic Style repository using Subversion.
</p>
<h3>
<a href="install.html">Install</a></h3>
<p>
Information on compiling and installing Artistic Style. The Windows and OpenVMS platforms come with a precompiled
executable. Other platforms must compile the project. Follow the instructions for the appropriate platform (Linux,
Mac, OpenVMS, or Windows).</p>
<h3>
<a href="license.html">License</a></h3>
<p>
Artistic Style may be used and distributed under version 3 the <a href="http://www.gnu.org/licenses/lgpl.html"><b>
GNU Lesser General Public License</b></a> (LGPL). The LGPL is a set of additional permissions added to version
3 of the <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>. You can use Artistic Style
in free or commercial software without charge. Projects that use Artistic Style do not have to make the source
code available. If Artistic Style itself is modified, however, the modified Artistic Style source code must be
made available.</p>
<h3>
<a href="scripts.html">Scripts</a></h3>
<p>
This page contains scripts to support the Artistic Style program. They are in various script languages and work
on different platforms. It includes scripts to clean the directories of backup files created by Artistic Style.</p>
<h3>
<a href="links.html">Links</a></h3>
<p>
There are several applications that use Artistic Style as contributed software. It is either embedded in the application
or called as a command line program. The applications include Graphical User Interfaces to view the effect of
formatting on the source code, development environments for various platforms, and other software. </p>
<h3>
<a href="http://astyle.sourceforge.net/develop/">Developer Information</a></h3>
<p>
Artistic Style has compile options for creating a shared library (DLL) or static library for use with a Graphical
User Interface (GUI). With the Java Development Kit (JDK) installed it can be compiled as a Java Native Interface
(JNI) and called from a Java program. The Developer Information documents the calling procedure and has example
programs for C++, Java, and C#.</p>
<h3>
Bug Reports, Change Requests, Notification</h3>
<p>
Bug reports and change requests should be submitted to the <a href="http://sourceforge.net/tracker/?group_id=2319&atid=102319">
bug tracker page</a>. You must be logged in to SourceForge to submit a report. If possible include an example
that shows the problem. It does not need to be functional code. Note that code copied and pasted into the bug
report <strong>will not be indented</strong> after the data is submitted. You must indicate the indentation when
you submit the request (e.g. replace leading spaces with periods).</p>
<p>
New releases are announced through an <a href="https://lists.sourceforge.net/lists/listinfo/astyle-announce">astyle-announce</a>
mailing list. You will receive notification of new releases and important repository commits. No SourceForge user
account is needed, but registered site users can subscribe using their SourceForge mail alias. (Mail aliases take
the form: username@users.sourceforge.net). The sign-up page can also be accessed from the <a href="https://sourceforge.net/projects/astyle/support">
user support page</a>. There are other ways to subscribe on the <a href="http://sourceforge.net/projects/astyle/files/">
file releases page</a> that use an RSS feed. You can use them if you want.</p>
<p>
To contact the project by email use the address <a href="mailto:jimp03@email.com">jimp03@email.com</a>.</p>
<h3>
Maintainers</h3>
<p>
Artistic Style is maintained and updated by <a href="mailto:jimp03@email.com">Jim Pattee</a>. The original author
was Tal Davidson, Israel.</p>
<h3>
Acknowledgments</h3>
<p>
Thanks to Jim Watson, Fred Shwartz, W. Nathaniel Mills III, Danny Deschenes, Andre Houde,
Richard Bullington, Paul-Michael Agapow, Daryn Adler, Dieter Bayer, Sam Cooler, Jim Duff,
Emilio Guijarro, Jens Krinke, Eran Ifrah, Travis Robinson, Max Horn, Ettl Martin,
Mario Gleichmann, J P Nurmi, Colin D Bennett, Christian Stimming, MrTact, Wim Rosseel,
Matthew Woehlke, Chris Schwarz, Chang Jiang, Arseny Solokha for their patches and contributions
to Artistic Style.</p>
<p>
Thanks to <strong><a href="http://sourceforge.net">SourceForge</a></strong> for giving Artistic Style its home.</p>
<p>
Thanks to all the dedicated beta-testers and bug notifiers!</p>
<!-- bottom of document -->
<p>
</p>
<hr style="margin-left: -0.4in;" />
<center class="footer">
<table width="100%">
<col width="30%" />
<col width="40%" />
<col width="30%" />
<tr><td align="left" style="height: 32px"><a href="http://www.gnu.org/licenses/lgpl.html">
<img src="http://www.gnu.org/graphics/lgplv3-88x31.png" alt="[LGPLv3]" /></a> <a href="http://www.gnu.org/licenses/gpl.html">
<img src="http://www.gnu.org/graphics/gplv3-88x31.png" alt="[GPLv3]" /></a></td>
<td align="center" style="color: #0000A0; font-size: x-large; font-weight: bold; height: 32px;">ENJOY!!!</td>
<td align="right" style="height: 32px"><a href="http://sourceforge.net/projects/astyle">
<img src="http://sflogo.sourceforge.net/sflogo.php?group_id=2319&type=15" width="150" height="40" alt="[SourceForge.net]" /></a>
</td>
</tr>
</table>
</center>
<p>
</p>
</body>
</html>
|
