debian/0000755000000000000000000000000012145314652007171 5ustar debian/astyle.install0000644000000000000000000000007512144606225012063 0ustar build/gcc/bin/astyle usr/bin doc/* usr/share/doc/astyle/html debian/rules0000755000000000000000000000125612144606225010254 0ustar #!/usr/bin/make -f # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 #export DH_OPTIONS=-v # Avoid unneeded library dependencies LDFLAGS = $(shell dpkg-buildflags --get LDFLAGS) LDFLAGS += -Wl,--as-needed # Target for stripping / not stripping BUILD_TARGET = astyle ifneq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS))) BUILD_TARGET = astyled endif # For hardening options CFLAGS += $(CPPFLAGS) %: dh $@ override_dh_auto_build: $(MAKE) -C build/gcc $(BUILD_TARGET) [ "$(BUILD_TARGET)" = "astyle" ] || mv bin/$(BUILD_TARGET) bin/astyle override_dh_auto_clean: $(MAKE) -C build/gcc clean [ ! -d build/gcc/obj ] || rmdir build/gcc/obj [ ! -d bin ] || rmdir bin debian/astyle.10000644000000000000000000006322712144606225010565 0ustar .TH ASTYLE 1 "February 21, 2011" astyle "User's Manual" .SH NAME astyle \- indentation and reformatting filters for C, C++, C#, Java .SH SYNOPSIS .B astyle [\fIoptions\fR] < \fIOriginal\fR > \fIBeautified\fR \fBastyle\fR [\fIoptions\fR] [\fIFile1\fR] [\fIFile2\fR] [\fI...\fR] .SH DESCRIPTION \fBArtistic Style\fR (or \fBastyle\fR) is a source code indenter, formatter, and beautifier for the C, C++, C# and Java programming languages. 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. Since the NUMBER of space characters showed on screen for each tab character in the source code changes between editors (until the user sets up the number to his liking...), one of the standard problems facing programmers when moving from one source code editor to another is that code containing both spaces and tabs that was up to now perfectly indented, suddently 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 peoples source code can still be problematic. To address this problem \fBastyle\fR was created - a series of filters, written in C++, that automatically reindent and reformat C/C++/C#/Java source files. These can be used from a command line, or it can be incorporated as classes in another C++ program. .SH USAGE When indenting a specific file, the newly indented file RETAINS the original filename. While a copy of the original file is created, with a suffix of ".orig" added to the original filename. By default, astyle is set up to indent C/C++ files, with 4 spaces per indent, a maximal indentation of 40 spaces inside continuous statements, and NO formatting. A default options file may be used to set your favorite source style. But, the command line options have precedence. The default options file can be \fB$HOME/.astylerc\fR, or be specified in the \fBARTISTIC_STYLE_OPTIONS\fR environment variable or the \fB\-\-options\fR command line option. .SH OPTIONS Not specifying any option will result in 4 spaces per indent, no change in bracket placement, and no formatting changes. Options may be written in two different ways: long options start with two dashes (`\-\-') and must be written one at a time; short options start with a single dash ('\-') may be concatenated together (thus, \fB\-bps4\fR is the same as \fB\-b \-p \-s4\fR). A summary of the options supported by \fBastyle\fR is included below. .SS "Bracket Style Options:" Bracket Style options define the bracket style to use. This option always overrides any individual option settings. You will always get the requested style regardless of other defined options. All other options are available to customize the bracket style. By default, none of the styles indent namespaces. All options default to 4 spaces per indent, indented with spaces. .TP \fBdefault bracket style\fR If no bracket style option is set, the opening brackets will not be changed and closing brackets will be broken from the preceding line. .TP \fB\-\-style=\fR\fIallman\fR, \fB\-\-style=\fR\fIansi\fR, \fB\-\-style=\fR\fIbsd\fR, \fB\-\-style=\fR\fIbreak\fR, \fB\-A\fR\fI1\fR Allman style formatting/indenting uses broken brackets. .TP \fB\-\-style=\fR\fIjava\fR, \fB\-\-style=\fR\fIattach\fR, \fB\-A\fR\fI2\fR Java style formatting/indenting uses attached brackets. .TP \fB\-\-style=\fR\fIkr\fR, \fB\-\-style=\fR\fIk&r\fR, \fB\-\-style=\fR\fIk/r\fR, \fB\-A\fR\fI3\fR Kernighan & Ritchie style formatting/indenting uses linux brackets. Brackets are broken from namespaces, classes, and function definitions. Brackets are attached to statements within a function. .TP \fB\-\-style=\fR\fIstroustrup\fR, \fB\-A\fR\fI4\fR Stroustrup style formatting/indenting uses stroustrup brackets. Brackets are broken from function definitions only. Brackets are attached to namespaces, classes, and statements within a function. This style frequently is used with an indent of 5 spaces. .TP \fB\-\-style=\fR\fIwhitesmith\fR, \fB\-A\fR\fI5\fR Whitesmith style formatting/indenting uses broken, indented brackets. Class blocks and switch blocks are indented to prevent a 'hanging indent' with switch statements and C++ class modifiers (public, private, protected). .TP \fB\-\-style=\fR\fIbanner\fR, \fB\-A\fR\fI6\fR Banner style formatting/indenting uses attached, indented brackets. Class blocks and switch blocks are indented to prevent a 'hanging indent' with switch statements and C++ class modifiers (public, private, protected). .TP \fB\-\-style=\fR\fIgnu\fR, \fB\-A\fR\fI7\fR GNU style formatting/indenting uses broken brackets and indented blocks. This style frequently is used with an indent of 2 spaces. Extra indentation is added to blocks \fBwithin a function.\fR The opening bracket for namespaces, classes, and functions is not indented. .TP \fB\-\-style=\fR\fIlinux\fR, \fB\-A\fR\fI8\fR Linux style formatting/indenting uses linux style brackets. Brackets are broken from namespace, class, and function definitions. Brackets are attached to statements within a function. \fBMinimum conditional indent\fR is one-half indent. If you want a different minimum conditional indent use the K&R style instead. This style works best with a large indent. It frequently is used with an indent of 8 spaces. Also known as Kernel Normal Form (KNF) style, this is the style used in the Linux kernel. .TP \fB\-\-style=\fR\fIhorstmann\fR, \fB\-A\fR\fI9\fR Horstmann style formatting/indenting uses run-in brackets, brackets are broken and allow run-in statements. Switches are indented to allow a run-in to the opening switch block. This style frequently is used with an indent of 3 spaces. .TP \fB\-\-style=\fR\fI1tbs\fR, \fB\-\-style=\fR\fIotbs\fR, \fB\-A\fR\fI10\fR "One True Brace Style" formatting/indenting uses linux brackets and adds brackets to unbracketed one line conditional statements. The option \fB\-\-add\-one\-line\-brackets\fR can also be used with this style. .TP \fB\-\-style=\fR\fIpico\fR, \fB\-A\fR\fI11\fR Pico style formatting/indenting uses run-in brackets, opening brackets are broken and allow run-in statements. The closing bracket is attached to the last line in the block. Switches are indented to allow a run-in to the opening switch block. The style implies \fB\-\-keep\-one\-line\-blocks\fR and \fB\-\-keep\-one\-line\-statements\fR. This style does not support multiple-line brackets. If add-brackets is used they will be added as one-line brackets. This style frequently is used with an indent of 2 spaces. .TP \fB\-\-style=\fR\fI1isp\fR, \fB\-\-style=\fR\fIpython\fR, \fB\-A\fR\fI12\fR Lisp style formatting/indenting uses attached brackets, opening brackets are attached at the end of the statement. The closing bracket is attached to the last line in the block. The style implies \fB\-\-keep\-one\-line\-statements\fR but NOT \fB\-\-keep\-one\-line\-blocks\fR. This style does not support one-line brackets. If \fB\-\-add\-one\-line\-brackets\fR is used they will be added as multiple-line brackets. .SS "Tab Options:" .TP \fBdefault indent\fR If no indentation option is set, the default option of 4 spaces will be used (e.g. \fB\-s\fR4 \fB\-\-indent=\fR\fIspaces=4\fR). .TP \fB\-\-indent=\fR\fIspaces\fR, \fB\-\-indent=\fR\fIspaces=#\fR, \fB\-s\fR, \fB\-s\fR\fI#\fR Indent using # spaces per indent (e.g. \fB-s\fR\fI6\fR / \fB\-\-indent=\fR\fIspaces=6\fR). # must be between 2 and 20. Not specifying # will result in a default of 4 spaces per indent. .TP \fB\-\-indent=\fR\fItab\fR, \fB\-\-indent=\fR\fItab=#\fR, \fB\-t\fR, \fB\-t\fR\fI#\fR Indent using tabs for indentation, and spaces for continuation line alignment. This ensures that the code is displayed correctly  regardless of the viewer’s tab size. Treat each tab as # spaces (e.g. \fB-t\fR\fI6\fR / \fB\-\-indent=\fR\fItab=6\fR). # must be between 2 and 20. If no # is set, treats tabs as 4 spaces. .TP \fB\-\-indent=\fR\fIforce\-tab\fR, \fB\-\-indent=\fR\fIforce\-tab=#\fR, \fB\-T\fR, \fB\-T\fR\fI#\fR Indent using all tab characters, if possible. If a continuation line is not an even number of tabs, spaces will be added at the end. Treat each tab as # spaces (e.g. \fB\-T\fR\fI6\fR / \fB\-\-indent=\fR\fIforce\-tab=6\fR). Uses tabs as indents where \fB\-\-indent=\fR\fItab\fR prefers to use spaces, such as inside multi-line statements. # must be between 2 and 20. If no # is set, treats tabs as 4 spaces. .TP \fB\-\-indent=\fR\fIforce\-tab\-x\fR, \fB\-\-indent=\fR\fIforce\-tab\-x=#\fR, \fB\-xT\fR, \fB\-xT\fR\fI#\fR This force-tab option allows the tab length to be set to a length that is different than the indent length. This may cause the indentation to be a mix of both tabs and spaces. Tabs will be used to indent, if possible. If a tab indent cannot be used, spaces will be used instead. This option sets the tab length. Treat each tab as # spaces (e.g. \fB\-xT\fR\fI6\fR / \fB\-\-indent=\fR\fIforce\-tab\-x=6\fR). # must be between 2 and 20. If no # is set, treats tabs as 8 spaces. To change the indent length \fB\-\-indent=\fR\fIforce\-tab\fR must also be used. .SS "Indentation Options:" .TP \fB\-\-indent\-classes\fR, \fB\-C\fR Indent 'class' and 'struct' blocks so that the blocks 'public:', \'protected:' and 'private:' are indented. The struct blocks are indented only if an access modifier is declared somewhere in the struct. The entire block is indented. This option is effective for C++ files only. .TP \fB\-\-indent\-switches\fR, \fB\-S\fR Indent 'switch' blocks so that the 'case X:' statements are indented in the switch block. The entire case block is indented. .TP \fB\-\-indent\-cases\fR, \fB\-K\fR Indent 'case X:' blocks from the 'case X:' headers. Case statements not enclosed in blocks are NOT indented. .TP \fB\-\-indent\-namespaces\fR, \fB\-N\fR Add extra indentation to namespace blocks. This option has no effect on Java files. .TP \fB\-\-indent\-labels\fR, \fB\-L\fR Add extra indentation to labels so they appear 1 indent less than the current indentation, rather than being flushed to the left (the default). .TP \fB\-\-indent\-preprocessor\fR, \fB\-w\fR Indent multi-line preprocessor definitions ending with a backslash. Should be used with \fB\-\-convert\-tabs\fR for proper results. Does a pretty good job, but cannot perform miracles in obfuscated preprocessor definitions. Without this option the preprocessor statements remain unchanged. .TP \fB\-\-indent\-col1\-comments\fR, \fB\-Y\fR Indent C++ comments beginning in column one. By default C++ comments beginning in column one are not indented. This option will allow the comments to be indented with the code. .TP \fB\-\-min\-conditional\-indent=\fR\fI#\fR, \fB\-m\fR\fI#\fR Set the minimal indent that is added when a header is built of multiple lines. This indent helps to easily separate the header from the command statements that follow. The value for # indicates a \fBnumber of indents\fR and is a minimum value. The indent may be greater to align with the data on the previous line. The valid values are: 0 - no minimal indent. The lines will be aligned with the paren on the preceding line. 1 - indent at least one additional indent. 2 - indent at least two additional indents. 3 - indent at least one-half an additional indent. This is intended for large indents (e.g. 8). The default value is \fB2\fR, two additional indents. .TP \fB\-\-max\-instatement\-indent=\fR\fI#\fR, \fB\-M\fR\fI#\fR Set the maximum of # spaces to indent a continuation line. The # indicates a number of columns and must not be greater than \fB120\fR. If no # is set, the default value of \fB40\fR will be used. A maximum of less than two indent lengths will be ignored. This option will prevent continuation lines from extending too far to the right. Setting a larger value will allow the code to be extended further to the right. .SS "Padding Options:" .TP \fB\-\-break\-blocks\fR, \fB\-f\fR Pad empty lines around header blocks (e.g. 'if', 'for', 'while'...). .TP \fB\-\-break\-blocks=\fR\fIall\fR, \fB\-F\fR Pad empty lines around header blocks (e.g. 'if', 'for', 'while'...). Treat closing header blocks (e.g. 'else', 'catch') as stand-alone blocks. .TP \fB\-\-pad\-oper\fR, \fB\-p\fR Insert space padding around operators. Any end of line comments will remain in the original column, if possible. Note that there is no option to unpad. Once padded, they stay padded. .TP \fB\-\-pad\-paren\fR, \fB\-P\fR Insert space padding around parenthesis on both the \fBoutside\fR and the \fBinside\fR. Any end of line comments will remain in the original column, if possible. .TP \fB\-\-pad\-paren\-out\fR, \fB\-d\fR Insert space padding around parenthesis on the \fBoutside\fR only. Any end of line comments will remain in the original column, if possible. This can be used with \fB\-\-unpad\-paren\fR below to remove unwanted spaces. .TP \fB\-\-pad\-first\-paren\-out\fR, \fB\-xd\fR Insert space padding around the \fBfirst\fR parenthesis in a series on the \fBoutside\fR only. Any end of line comments will remain in the original column, if possible. This can be used with unpad-paren below to remove unwanted spaces. If used with \fB\-\-pad\-paren\fR or \fB\-\-pad\-paren\-out\fR, this option will be ignored. If used with \fB\-\-pad\-paren\-in\fR, the result will be the same as pad-paren. .TP \fB\-\-pad\-paren\-in\fR, \fB\-D\fR Insert space padding around parenthesis on the \fBinside\fR only. Any end of line comments will remain in the original column, if possible. This can be used with \fB\-\-unpad\-paren\fR below to remove unwanted spaces. .TP \fB\-\-pad\-header\fR, \fB\-H\fR Insert space padding after paren headers only (e.g. 'if', 'for', 'while'...). Any end of line comments will remain in the original column, if possible. This can be used with \fB\-\-unpad\-paren\fR to remove unwanted spaces. .TP \fB\-\-unpad\-paren\fR, \fB\-U\fR Remove extra space padding around parenthesis on the inside and outside. Any end of line comments will remain in the original column, if possible. This option can be used in combination with the paren padding options \fB\-\-pad\-paren\-out\fR and \fB\-\-pad\-paren\-in\fR above. Only padding that has not been requested by other options will be removed. .TP \fB\-\-delete\-empty\-lines\fR, \fB\-xe\fR Delete empty lines within a function or method. Empty lines outside of functions or methods are NOT deleted. If used with \fB\-\-break\-blocks\fR or \fB\-\-break\-blocks\fR=all it will delete all lines \fBexcept\fR the lines added by the \fB\-\-break\-blocks\fR options. .TP \fB\-\-fill\-empty\-lines\fR, \fB\-E\fR Fill empty lines with the white space of their previous lines. .TP \fB\-\-align\-pointer=\fR\fItype\fR, \fB\-k\fR\fI1\fR .TQ \fB\-\-align\-pointer=\fR\fImiddle\fR, \fB\-k\fR\fI2\fR .TQ \fB\-\-align\-pointer=\fR\fIname\fR, \fB\-k\fR\fI3\fR Attach a pointer or reference operator (*, &, or ^) to either the variable type (left) or variable name (right), or place it between the type and name (middle). The spacing between the type and name will be preserved, if possible. This option is for C/C++, C++/CLI, and C# files. To format references separately use the following \fB\-\-align\-reference\fR option. .TP \fB\-\-align\-reference=\fR\fInone\fR, \fB\-W\fR\fI0\fR .TQ \fB\-\-align\-reference=\fR\fItype\fR, \fB\-W\fR\fI1\fR .TQ \fB\-\-align\-reference=\fR\fImiddle\fR, \fB\-W\fR\fI2\fR .TQ \fB\-\-align\-reference=\fR\fIname\fR, \fB\-W\fR\fI3\fR This option will align references separate from pointers. Pointers are not changed by this option. If pointers and references are to be aligned the same, use the previous \fB\-\-align\-pointer\fR option. The option \fB\-\-align\-reference=\fR\fInone\fR will not change the reference alignment. The other options are the same as for \fB\-\-align\-pointer\fR. This option is for C/C++, C++/CLI, and C# files. .SS "Formatting Options:" .TP \fB\-\-break\-closing\-brackets\fR, \fB\-y\fR When used with \fB\-\-brackets\fR=attach, \fB\-\-brackets=\fR\fIlinux or \fB\-\-brackets\fR=stroustrup, this breaks closing headers (e.g. \'else\', \'catch\', ...) from their immediately preceding closing brackets. Closing header brackets are always broken with broken brackets, horstmann brackets, indented blocks, and indented brackets. .TP \fB\-\-break\-elseifs\fR, \fB\-e\fR Break "else if" header combinations into separate lines. This option has no effect if \fB\-\-keep\-one\-line\-statements\fR is used, the "else if" statements will remain as they are. If this option is NOT used, "else if" header combinations will be placed on a single line. .TP \fB\-\-add\-brackets\fR, \fB\-j\fR Add brackets to unbracketed one line conditional statements (e.g. 'if', 'for', 'while'...). The statement must be on a single line. The brackets will be added according to the currently requested predefined style or bracket type. If no style or bracket type is requested the brackets will be attached. If \fB\-\-add\-one\-line\-brackets\fR is also used the result will be one line brackets. .TP \fB\-\-add\-one\-line\-brackets\fR, \fB\-J\fR Add one line brackets to unbracketed one line conditional statements (e.g. 'if', 'for', 'while'...). The statement must be on a single line. The option implies \fB\-\-keep\-one\-line\-blocks\fR and will not break the one line blocks. .TP \fB\-\-keep\-one\-line\-blocks\fR, \fB\-O\fR Don't break one-line blocks. .TP \fB\-\-keep\-one\-line\-statements\fR, \fB\-o\fR Don't break complex statements and multiple statements residing on a single line. .TP \fB\-\-convert\-tabs\fR, \fB\-c\fR Convert tabs to spaces in the non-indentation part of the line. The number of spaces inserted will maintain the spacing of the tab. The current setting for spaces per tab is used. It may not produce the expected results if \fB\-\-convert\-tabs\fR is used when changing spaces per tab. Tabs are not replaced in quotes. .TP \fB\-\-close\-templates\fR, \fB-xy\fR Closes whitespace in the angle brackets of template definitions. Closing the ending angle brackets is now allowed by the C++11 standard. Be sure your compiler supports this before making the changes. .TP \fB\-\-max\-code\-length=\fR\fI#\fR, \fB-xC\fR\fI#\fR .TQ \fB\-\-break\-after\-logical\fR, \fB-xL\fR The option \fB\-\-max\‑code\‑length\fR will break a line if the code exceeds # characters. The valid values are 50 thru 200. Lines without logical conditionals will break on a logical conditional (||, &&, ...), comma, paren, semicolon, or space. Some code will not be broken, such as comments, quotes, and arrays. If used with keep‑one‑line‑blocks or add-one-line-brackets the blocks will NOT be broken. If used with keep‑one‑line‑statements the statements will be broken at a semicolon if the line goes over the maximum length. If there is no available break point within the max code length, the line will be broken at the first available break point after the max code length. By default logical conditionals will be placed first on the new line. The option break‑after‑logical will cause the logical conditionals to be placed last on the previous line. This option has no effect without max‑code‑length. .TP \fB\-\-mode=\fR\fIc\fR .TQ \fB\-\-mode=\fR\fIcs\fR .TQ \fB\-\-mode=\fR\fIjava\fR Indent a C/C++, C#, or Java file. The option is usually set from the file extension for each file. You can override the setting with this entry. It will be used for all files regardless of the file extension. It allows the formatter to identify language specific syntax such as C++ classes, templates, and keywords. .SS "Other options:" .TP \fB\-\-suffix=\fR\fI####\fR Append the suffix \fI####\fR instead of '.orig' to original filename (e.g. \fB\-\-suffix=\fR\fI.bak\fR). If this is to be a file extension, the dot '.' must be included. Otherwise the suffix will be appended to the current file extension. .TP \fB\-\-suffix=\fR\fInone\fR, \fB\-n\fR Do not retain a backup of the original file. The original file is purged after it is formatted. .TP \fB\-\-recursive\fR, \fB\-r\fR, \fB\-R\fR For each directory in the command line, process all subdirectories recursively. When using the recursive option the file name statement should contain a wildcard. The filepath and name should be placed in double quotes so the shell will not resolve the wildcards (e.g. "$HOME/src/*.cpp"). .TP \fB\-\-exclude=\fR\fI####\fR Specify a file or sub directory #### to be excluded from processing. Excludes are matched from the end of the filepath. An exclude option of "templates" will exclude ALL directories named "templates". An exclude option of "cpp/templates" will exclude ALL "cpp/templates" directories. You may proceed backwards in the directory tree to exclude only the required directories. Specific files may be excluded in the same manner. An exclude option of "default.cpp" will exclude ALL files named "default.cpp". An exclude option of "python/default.cpp" will exclude ALL files named "default.cpp" contained in a "python" subdirectory. You may proceed backwards in the directory tree to exclude only the required files. Wildcards are NOT allowed. There may be more than one exclude statement. The filepath and name may be placed in double quotes (e.g. \fB\-\-exclude=\fR\fI"foo bar.cpp"\fR). .TP \fB\-\-ignore\-exclude\-errors\fR, \fB\-i\fR Allow processing to continue if there are errors in the \fB\-\-exclude=\fR\fI###\fR options. This option lets the excludes for several projects be entered in a single option file. This option may be placed in the same option file as the excludes. It will display the unmatched excludes. The following option will not display the unmatched excludes. .TP \fB\-\-ignore\-exclude\-errors\-x\fR, \fB\-xi\fR Allow processing to continue if there are errors in the \fB\-\-exclude=\fR\fI###\fR options. This option lets the excludes for several projects be entered in a single option file. This option may be placed in the same option file as the excludes. It will NOT display the unmatched excludes. The preceding option will display the unmatched excludes. .TP \fB\-\-errors\-to\-stdout\fR, \fB\-X\fR Print errors and help information to standard-output rather than to standard-error. .TP \fB\-\-preserve\-date\fR, \fB\-Z\fR Preserve the original file's date and time modified. The date and time modified will not be changed in the formatted file. This option is not effective if redirection is used to rename the input file. Please note that the date is not actually preserved: 10 seconds are added to the original date (this behaviour is reported as Debian bug #686317). .TP \fB\-\-verbose\fR, \fB\-v\fR Verbose display mode. Display optional information, such as release number and statistical data. .TP \fB\-\-formatted\fR, \fB\-Q\fR Formatted files display mode. Display only the files that have been formatted. Do not display files that are unchanged. .TP \fB\-\-quiet\fR,\fB\-q\fR Quiet display mode. Suppress all output except error messages. .TP \fB\-\-lineend=\fR\fIwindows\fR, \fB\-z\fR\fI1\fR .TQ \fB\-\-lineend=\fR\fIlinux\fR, \fB\-z\fR\fI2\fR .TQ \fB\-\-lineend=\fR\fImacold\fR, \fB\-z\fR\fI3\fR Force use of the specified line end style. Valid options are \fIwindows\fR (CRLF), \fIlinux\fR (LF), and \fImacold\fR (CR). MacOld style is the format for OS 9 and earlier. Mac OS X uses the Linux style. If one of these options is not used the line ends will be determined automatically from the input file. .SS "Command Line Only:" These options are available for the command-line only. They are NOT available in an options file. .TP \fB\-\-options=\fR\fI####\fR Specify an options file \fI####\fR to read and use. It must contain a file path for the file. This will allow the file name to be changed from astylerc or .astylerc. .TP \fB\-\-options=\fR\fInone\fR Disable the default options file. Only the command-line parameters will be used. .TP \fB\-\-ascii\fR, \fB\-I\fR The displayed output will be ascii characters only. The text will be displayed in English and numbers will not be formatted. The short option must be by itself, it cannot be concatenated with other options. .TP \fB\-\-version\fR, \fB\-V\fR Print version number and quit. The short option must be by itself, it cannot be concatenated with other options. .TP \fB\-\-help\fR, \fB\-h\fR, \fB\-?\fR Print a help message and quit. The short option must be by itself, it cannot be concatenated with other options. .SH FILES Artistic Style looks for a default options file in the following order: .TP .B 1. The contents of the file indicated by the \-\-options= command line option; .B 2. The contents of the \fIARTISTIC_STYLE_OPTIONS\fR environment variable if it exists. .TP .B 3. The file called \fI.astylerc\fR in the directory pointed to by the \fIHOME\fR environment variable (i.e. \fI$HOME/.astylerc\fR). .TP .B 4. The file called \fI.astylerc\fR in the directory pointed to by the \fIHOMEPATH\fR environment variable (i.e. \fI%HOMEPATH%\.astylerc\fR). .P If a default options file is found, the options in this file will be parsed BEFORE the command-line options. This option file lookup can be disabled by specifying \-\-options=none on the command line. .P Long options within the default option file may be written without the preliminary '\-\-', but short options require the preceding '\-'. Lines within the options file that begin with '#' are considered line-comments. .SH VERSION 2.03 .SH "SEE ALSO" .BR indent(1) .I http://astyle.sourceforge.net/ .br .I http://www.sourceforge.net/projects/astyle/ .br .I http://packages.debian.org/astyle .SH AUTHOR Tal Davidson This man-page was written by Jan Schaumann as part of "The Missing Man Pages Project". Please see \fIhttp://www.netmeister.org/misc/m2p2/index.html\fR for details. Minor modifications by Luca Filipozzi . Updated on August 2009 by Margarita Manterola . Updated from 2010 to 2013 by Matteo Cypriani . debian/astyle.manpages0000644000000000000000000000002012144606225012176 0ustar debian/astyle.1 debian/changelog0000644000000000000000000002345312144606225011051 0ustar astyle (2.03-1) unstable; urgency=low * New upstream release. (Closes: #707889, #631966, LP: #1049606) * Update manpage. -- Matteo Cypriani Wed, 15 May 2013 00:10:00 -0400 astyle (2.02.1-2) unstable; urgency=low * Upload to unstable * manpage: highlight buggy --preserve-date (Closes: #686317) * Fix debian/changelog -- Matteo Cypriani Sun, 05 May 2013 16:48:47 -0400 astyle (2.02.1-1) experimental; urgency=low [ Matteo Cypriani ] * New upstream release. (Closes: #649616) * Update manpage. * Bump Standards-Version to 3.9.4 (no changes needed). * Switch to debhelper 9. * debian/rules: + add CPPFLAGS to CFLAGS as expected by upstream build system. + add commented out DH_OPTIONS=-v for easy verbose build. * debian/copyright: update Format and dates. [ Thomas Preud'homme ] * Switch to a dh style rules file to provide build-{arch,indep} targets. * Fix the package to be able to build twice in a row. * Call make clean unconditionally in override_dh_auto_clean. -- Matteo Cypriani Mon, 14 Jan 2013 17:52:11 -0500 astyle (2.01-1) unstable; urgency=low * New upstream release. (Closes: #616710) * Update package description. * Update manpage. * Bump Standards-Version to 3.9.2 * Convert debian/copyright to DEP5 format. * Switch to 3.0 (quilt) format. * Add VCS fields. * Avoid unneeded dependency on libgcc_s. -- Matteo Cypriani Thu, 12 May 2011 15:15:13 +0200 astyle (1.24-1) unstable; urgency=low * New upstream release. - Fix comma separated initialization bug (Closes: #569170) * Updated the manpage to reflect the new options. -- Matteo Cypriani Thu, 08 Apr 2010 20:40:00 +0200 astyle (1.23-1) unstable; urgency=low * New upstream release. (Closes: #522730) * Updated manpage to reflect new option. * Added NEWS file to warn about the changes. -- Margarita Manterola Fri, 07 Aug 2009 13:26:10 +0000 astyle (1.22-3) unstable; urgency=low * Fixed lintian warnings regarding hyphens in the manpage. * Fixed the watch file for the new version. -- Margarita Manterola Wed, 27 Aug 2008 14:52:19 +0000 astyle (1.22-2) unstable; urgency=low * Fixed bug in the manpage, mixing -V and -v. Thanks to Martin Ferrari for the report. (Closes: #496790) * Updated Standards-Version to 3.8.0. + Added README.source pointing to dpatch's README.source.gz -- Margarita Manterola Wed, 27 Aug 2008 14:03:03 +0000 astyle (1.22-1) unstable; urgency=low * New upstream release + Fix incorrect identification of bracket type following a struct statement. (Closes: #112546) * Added new "links.html" document to debian/astyle.docs * Changed debian/rules to use the new "buildgcc" directory. * Corrected the doc-base section. -- Margarita Manterola Sun, 27 Apr 2008 13:58:37 +0000 astyle (1.21-3) unstable; urgency=low * Fixed debian/rules so that "nostrip" is honored by the build process. (Closes: #436484) * Fixed the clean rule to actually call make clean. -- Margarita Manterola Tue, 11 Mar 2008 17:51:07 +0000 astyle (1.21-2) unstable; urgency=low * New fix_for_gcc_4.3.dpatch, provided by Cyril Brulebois. (Closes: #455426) * Fixed watch file. * Added Homepage field to the Source package. * Updated Standards-Version (no changes needed). * Fixed debian/rules to not ignore make clean errors. * Fixed debian/copyright to have a copyright statement and make it machine parseable. Added the years for the upstream authors and the debian maintainers. * Updated the doc-base section to reflect the new menu structure. -- Margarita Manterola Tue, 11 Mar 2008 17:34:44 +0000 astyle (1.21-1) unstable; urgency=low * New upstream release + Do not apply fix_for_gcc_4.3.dpatch, since it's now applied upstream. + Fix formatting of empty blocks. (Closes: #397799) -- Margarita Manterola Fri, 22 Jun 2007 17:49:56 -0300 astyle (1.20.2-2) unstable; urgency=low * New upstream release (now in unstable). (Closes: #412333). + Fix incorrect formatting for an empty comment (Closes: #415565). * Added debian/patches/fix_for_gcc_4.3.dpatch, fixing the dependencies for gcc 4.3 (Closes: #413481). Thanks to Martin Michlmayr for the report and the patch. -- Margarita Manterola Sun, 15 Apr 2007 14:12:30 -0300 astyle (1.20.2-1) experimental; urgency=low * New upstream release. (Would close: #412333) * Changed copyright file, astyle is now LGPL. * Updated the manpage to the current version. -- Margarita Manterola Tue, 13 Mar 2007 00:23:12 -0300 astyle (1.18-1) unstable; urgency=low * New upstream release (Closes: #375760). + Doesn't remove leading spaces from multi-line comments. (Closes: #201655) + Fixed indentation problem with ending }; of class statements. (Closes: #270999) + Fixed extra space that was sometimes added when pad operators was used. (Closes: #118203) + Fixed problems detecting some keywords as "lock" or "get". (Closes: #355171) * Updated debhelper compatibility to level 5, no changes needed. * Updated Standards-Version to 3.7.2, no changes needed. * Updated the watch file. * Dropped 100_g++-3.4.dpatch, since it has been applied upstream. * Dropped 200_long_lines.dpatch, since it has been applied upstream. -- Margarita Manterola Sat, 15 Jul 2006 19:32:20 -0300 astyle (1.15.3-5) unstable; urgency=low * New upload to trigger a recompile due to the C++ transition. * Fixed debian/rules to comply better with policy. * Updated debian/control to the latest policy version. -- Margarita Manterola Tue, 4 Oct 2005 11:13:02 -0300 astyle (1.15.3-4) unstable; urgency=low * Added patch to support longer lines (closes: #187171). * Fixed typo in the manpage (closes: #238693). * Added patch to support g++-3.4 (closes: #266663). * Added dpatch to work with patches. * Fixed the watch and control files to match present policy. * New Maintainer - Adopting package (closes: #266457). -- Margarita Manterola Thu, 21 Oct 2004 12:09:00 -0300 astyle (1.15.3-3) unstable; urgency=low * built with latest g++ -- Luca Filipozzi Sat, 14 Jun 2003 11:27:20 -0700 astyle (1.15.3-2) unstable; urgency=low * the 'no new functionality' release * debian/watch: trivial change to handle sf.net brokeness -- Luca Filipozzi Sun, 2 Jun 2002 17:26:27 -0700 astyle (1.15.3-1) unstable; urgency=low * New upstream release * Note that the license has changed: was: (dual) GPL + Artistic is: GPL only -- Luca Filipozzi Sat, 23 Mar 2002 17:40:03 -0800 astyle (1.14.1-5) unstable; urgency=low * added a watch file -- Luca Filipozzi Wed, 26 Dec 2001 12:38:03 -0800 astyle (1.14.1-4) unstable; urgency=low * fixed html bug and used tidy on astyle.html (Closes: Bug#120184) -- Luca Filipozzi Mon, 19 Nov 2001 03:27:31 -0800 astyle (1.14.1-3) unstable; urgency=low * minor modification to copyright notice -- Luca Filipozzi Tue, 23 Oct 2001 08:14:02 -0700 astyle (1.14.1-2) unstable; urgency=low * Added a manpage for astyle (provided by "The Missing Man Pages Project") -- Luca Filipozzi Sat, 18 Aug 2001 13:11:50 -0700 astyle (1.14.1-1) unstable; urgency=low * New upstream release (Closes: #108992) -- Luca Filipozzi Sat, 18 Aug 2001 11:25:49 -0700 astyle (1.11.6-4) unstable; urgency=low * applied patch provided by Matthew Wilcox to allow astyle to be compiled with gcc 3.0 (Closes: #104406, #104683) -- Luca Filipozzi Sun, 15 Jul 2001 20:25:34 -0700 astyle (1.11.6-3) unstable; urgency=low * Adopting package (Closes: #86873). -- Luca Filipozzi Thu, 22 Feb 2001 11:02:34 -0800 astyle (1.11.6-2) unstable; urgency=low * Orphaning package -- Sean 'Shaleh' Perry Wed, 21 Feb 2001 08:01:35 -0800 astyle (1.11.6-1) unstable; urgency=low * New upstream release -- Sean 'Shaleh' Perry Mon, 22 May 2000 16:31:30 -0700 astyle (1.11.5-1) unstable; urgency=low * New upstream release * changes to meet current policy -- Sean E. Perry Thu, 11 Nov 1999 22:31:40 -0800 astyle (1.11.4-1) unstable; urgency=low * New upstream * supports FHS policy now -- Sean E. Perry Mon, 20 Sep 1999 15:05:39 -0700 astyle (1.11.1-1) unstable; urgency=low * New upstream release * New maintainer -- Sean E. Perry Fri, 3 Sep 1999 11:17:28 -0700 astyle (1.10.4-3) unstable; urgency=low * Rebuild with newer debhelper (Closes: #43208) -- Brian M. Almeida Thu, 19 Aug 1999 09:59:26 -0400 astyle (1.10.4-2) unstable; urgency=low * Make help print out to stdout instead of stderr (Closes: #42551) -- Brian M. Almeida Fri, 6 Aug 1999 09:05:29 -0400 astyle (1.10.4-1) unstable; urgency=low * New upstream release -- Brian M. Almeida Wed, 4 Aug 1999 11:03:36 -0400 astyle (1.10.1-1) unstable; urgency=low * New upstream release -- Brian M. Almeida Wed, 21 Jul 1999 11:13:01 -0400 astyle (1.8.2-1) unstable; urgency=low * New upstream release -- Brian M. Almeida Wed, 24 Mar 1999 18:46:15 -0500 astyle (1.8.1-1) unstable; urgency=low * New upstream release -- Brian M. Almeida Thu, 11 Mar 1999 01:16:11 -0500 astyle (1.7.6-1) unstable; urgency=low * Initial Release. -- Brian M. Almeida Mon, 22 Feb 1999 00:19:25 -0500 debian/copyright0000644000000000000000000000206412144606225011125 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: Artistic Style Upstream-Contact: Jim Pattee Source: http://astyle.sourceforge.net/ License: LGPL-3+ Files: * Copyright: 1998-2004 Tal Davidson 2005, 2006 Martin Baute 2006-2012 Jim Pattee License: LGPL-3+ Files: debian/* Copyright: 1999 Brian M. Almeida 1999-2001 Sean 'Shaleh' Perry 2001-2003 Luca Filipozzi 2004-2011 Margarita Manterola 2010-2012 Matteo Cypriani License: LGPL-3+ License: LGPL-3+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. . On Debian machines, the full text of the GNU Lesser General Public License can be found in the file /usr/share/common-licenses/LGPL-3. debian/compat0000644000000000000000000000000212144606225010366 0ustar 9 debian/NEWS0000644000000000000000000000424012144606225007667 0ustar astyle (2.03-1) unstable; urgency=low The usual warning applies again: With a new Artistic Style release some unchanged source files will be formatted. You may want to format your source before making program changes in order to bring it up to date. -- Matteo Cypriani Wed, 15 May 2013 00:13:01 -0400 astyle (2.02.1-1) experimental; urgency=low This Artistic Style release brings some important changes, especially in the definition of bracket styles and default indent size. Please have a look at /usr/share/doc/astyle/html/news.html to understand what changed and what will change in the future. -- Matteo Cypriani Thu, 17 May 2012 11:45:41 +0200 astyle (2.01-1) unstable; urgency=low Here is an extract from the release notes: With a new Artistic Style release some unchanged source files will be formatted because of changes to Artistic Style. You may want to format your source before making program changes in order to bring it up to date. -- Matteo Cypriani Mon, 21 Feb 2011 16:30:22 +0100 astyle (1.24-1) unstable; urgency=low Beware! This new astyle version once more fixes and improves many options, but your code could be re-indented even if you changed nothing. -- Matteo Cypriani Thu, 08 Apr 2010 20:40:00 +0200 astyle (1.23-1) unstable; urgency=low Beware! This much awaited version of astyle changes many options, and it is possible that some code gets re-indented with no changes done. You may want to format your source before making program changes in order to bring it up to date. Read /usr/share/doc/astyle/html/news.html for the whole list of new options and changes. -- Margarita Manterola Thu, 06 Aug 2009 22:16:10 +0000 astyle (2.03-1) experimental; urgency=low This Artistic Style release brings some important changes, especially in the definition of bracket styles and default indent size. Please have a look at /usr/share/doc/astyle/html/news.html to understand what changed and what will change in the future. -- Matteo Cypriani Wed, 15 May 2013 00:13:01 -0400 debian/control0000644000000000000000000000123712144606225010576 0ustar Source: astyle Section: devel Priority: optional Build-Depends: debhelper (>= 9) Maintainer: Margarita Manterola Uploaders: Matteo Cypriani Standards-Version: 3.9.4 Homepage: http://astyle.sourceforge.net/ Vcs-Git: git://git.debian.org/git/collab-maint/astyle.git Vcs-Browser: http://git.debian.org/?p=collab-maint/astyle.git Package: astyle Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Description: Source code indenter for C++/C/Java/C# source code Artistic Style is a source code indenter, formatter, and beautifier for the C, C++, C# and Java programming languages. . This package contains the command line tool. debian/astyle.doc-base0000644000000000000000000000041012144606225012063 0ustar Document: astyle Title: Artistic Style documentation Author: Tal Davidson Abstract: Documentation for the Artistic Style code reformatter. . Section: Programming Format: HTML Index: /usr/share/doc/astyle/html/index.html Files: /usr/share/doc/astyle/html/*.html debian/source/0000755000000000000000000000000012144606225010470 5ustar debian/source/format0000644000000000000000000000001412144606225011676 0ustar 3.0 (quilt) debian/watch0000644000000000000000000000012012144606225010212 0ustar version=3 http://sf.net/astyle/astyle_([\d.]+)_linux\.tar\.gz \ debian uupdate