Skip to content
C++ C D Objective-C Shell Python Other
Find file
Pull request Compare This branch is 28 commits behind uncrustify:master.
Latest commit 321fc5a Mar 18, 2016 @bengardner Merge pull request #466 from bengardner/log_flags
Add and use functions to log changes to chunk.flags
Failed to load latest commit information.
documentation index,html: move tags to the top of the page, add travis-ci tag Mar 15, 2016
etc update sun/oracle config for C/C++/Java Mar 7, 2016
man Introduce some more MS calling conventions. Mar 10, 2016
osx Add missing osx directory. Oct 25, 2009
scripts Introduce some more MS calling conventions. Mar 10, 2016
src Use the new flags logging functions Mar 18, 2016
tests add the bug_631.cfg Mar 16, 2016
uncrustify.xcodeproj Added fix for issue #124:… Dec 18, 2014
win32 Run uncrustify on itself using etc/ben.cfg, with a few manual fixes. Feb 18, 2015
.gitignore Ignore some more files. Mar 15, 2016
.travis.yml travis.yml: fix typeo Mar 15, 2016
AUTHORS Import r1644 from subversion Oct 17, 2009
BUGS Update BUGS a bit Oct 14, 2014
COPYING Import r1644 from subversion Oct 17, 2009
ChangeLog Better descriptions for options (Issue #444) Mar 16, 2016
HELP Import r1644 from subversion Oct 17, 2009
INSTALL Bugfix for # 637 Mar 10, 2016 Use silent rules instead of nostdinc May 28, 2010
NEWS Import r1644 from subversion Oct 17, 2009 Updated build steps Mar 14, 2016
TESTING Tweaks to the TESTING how-to Aug 26, 2011 Import r1644 from subversion Oct 17, 2009
commit.log Update ChangeLog and commit.log Feb 2, 2016
compile Re-run on Ubuntu 14.04 Aug 21, 2014
config.guess Import r1644 from subversion Oct 17, 2009
config.sub Import r1644 from subversion Oct 17, 2009 Update version, config files, run, etc Feb 2, 2016
extras.vpj Add a few files to the workspace Jan 1, 2013
install-sh Re-run on Ubuntu 14.04 Aug 22, 2014 Remove the date from token_names.h/ Dec 28, 2012 no need to split lines of Aug 21, 2014 Rework to build outside of the source tree. Feb 2, 2016
missing Re-run on Ubuntu 14.04 Aug 22, 2014
package.json Added package.json for npm Feb 18, 2015
release-steps.txt Update release steps Feb 1, 2016 Import r1644 from subversion Oct 17, 2009
test-driver Re-run on Ubuntu 14.04 Aug 22, 2014
uncrustify.vpj Add ability to get config from UNCRUSTIFY_CONFIG env var to win32 Dec 29, 2011
uncrustify.vpw Update SlickEdit project files Oct 8, 2011
working.txt save off work in the freebsd branch Dec 5, 2009

README for Uncrustify

Post any bugs to the issue tracker found on the project's Sourceforge page:

Please include the following with your issue:

  • a description of what is not working right
  • input code sufficient to demonstrate the issue
  • expected output code
  • configuration options used to generate the output

If the issue cannot be easily reproduced, then it isn't likely to be fixed.

Building the program

Quick start:

$ ./
$ ./configure
$ make

The executable is src/uncrustify. Copy that to your ~/bin/ folder or wherever you want.

Building the program using Xcode on Mac OS X

You can of course just open the Xcode project and build uncrustify using the default 'Debug' configuration but if you want to install it the 'Install' configuration will not work from within Xcode.

For that you will have to use the Xcode command line tool 'xcodebuild'.

To do that, cd into the uncrustify project folder where uncrustify.xcodeproj resides and enter the following command:

$ sudo xcodebuild -configuration 'Install'

You will be prompted for the root level password. By doing this you will install uncrustify into /usr/local/bin. The install location can be changed by editing the Build Settings for the uncrustify target. The setting you need to change is called, surprisingly enough, 'Installation Directory'.

Configuring the program

Examine the example config files in etc (such as ben.cfg) and/or read configuration.txt. Copy the existing config file that closely matches your style and put in ~/.uncrustify/. Find complete configuration file options in this file. Modify to your liking.

Running the program (and refining your style)

As of the current release, I don't particularly trust this program to not make mistakes and screw up my whitespace formatting.

Here's how to run it:

$ uncrustify -c ~/.uncrustify/mystyle.cfg -f somefile.c > somefile.c.unc

The -c option selects the configuration file. The -f option specifies the input file. The output is sent to stdout. Error messages are sent to stderr.

Use a quality side-by-side diff tool to determine if the program did what you wanted. Repeat until your style is refined.

Running the program (once you've found your style)

Write a script to automate the above. Check out etc/ for an example. That script is used as follows:

  1. navigate one level above your project
  2. make a list of file to process $ find myproj -name "*.[ch]" > files.txt
  3. $ sh etc/ files.txt
  4. Use your favorite diff/merge program to merge in the changes $ xxdiff out/myproj myproj
Something went wrong with that request. Please try again.