You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@trafficserver.apache.org by Leif Hedstrom <zw...@apache.org> on 2015/03/20 23:19:27 UTC

[HEADS UP] clang-format is happening tonight

Hi,

we’re finally ready to branch for v5.3.0, and in prep for that, I’ll run clang-format on the entire source code. Going forward, it’s important that you adhere to the clang-format standards. There is a .clang-format file in our top source tree, that you should use together with clang-format v3.6 or later. I know that this is a version that’s generally not available in most distributions, so I have a couple of suggestions how you can use it:

1) On your Mac, if you use HomeBrew, a simple “brew install clang-format” will get you started. There is some emacs modes etc. for this as well, and a git script. 

2) I’ve prepared a tar-ball which includes the Emacs .el file, the git script, and a clang-format binary for Fedora 21. I’ll add more binaries as I have time to build on other platforms.


The tar-ball is available at

	http://people.apache.org/~zwoop/clang-format.tgz <http://people.apache.org/~zwoop/clang-format.tgz>


I will also work on updating the Wiki pages on the new indentation styles and tools. Finally, there are a few directories that should not be clang-formatted:

	lib/luajit
	lib/ck
	lib/tsconfig

The last one we can probably fix, but I didn’t want to touch it for now (it depends on generated files, and rewriting a file).

Cheers,

— leif

minotaur (20:45) 280/0 $ tar tvf clang-format.tgz
drwxr-xr-x leif/users        0 2015-03-20 20:39 clang-format/
-rwxr-xr-x leif/users    18073 2015-03-20 20:39 clang-format/git-clang-format
-rw-r--r-- leif/users     6124 2015-03-20 20:39 clang-format/clang-format.el
-rwxr-xr-x leif/users  1551800 2015-03-20 20:38 clang-format/clang-format.fc21


Re: [HEADS UP] clang-format is happening tonight

Posted by Leif Hedstrom <zw...@apache.org>.
> On Mar 20, 2015, at 6:19 PM, Leif Hedstrom <zw...@apache.org> wrote:
> 
> Hi,
> 
> we’re finally ready to branch for v5.3.0, and in prep for that, I’ll run clang-format on the entire source code. Going forward, it’s important that you adhere to the clang-format standards. There is a .clang-format file in our top source tree, that you should use together with clang-format v3.6 or later. I know that this is a version that’s generally not available in most distributions, so I have a couple of suggestions how you can use it:
> 
> 1) On your Mac, if you use HomeBrew, a simple “brew install clang-format” will get you started. There is some emacs modes etc. for this as well, and a git script. 
> 
> 2) I’ve prepared a tar-ball which includes the Emacs .el file, the git script, and a clang-format binary for Fedora 21. I’ll add more binaries as I have time to build on other platforms.


Ok, this happened! Please report any issues asap to the mailing list, so we can resolve that before 5.3.0 branch.

> 
> 
> The tar-ball is available at
> 
> 	http://people.apache.org/~zwoop/clang-format.tgz <http://people.apache.org/~zwoop/clang-format.tgz>

I’ve updated this with a static binary for linux. It *should* work on a pretty wide range of Linux distros. I will also keep this updated on a regular basis, and also add binaries for OS X and FreeBSD to this tar-ball. 

Cheers,

— Leif


> 
> 
> I will also work on updating the Wiki pages on the new indentation styles and tools. Finally, there are a few directories that should not be clang-formatted:
> 
> 	lib/luajit
> 	lib/ck
> 	lib/tsconfig
> 
> The last one we can probably fix, but I didn’t want to touch it for now (it depends on generated files, and rewriting a file).
> 
> Cheers,
> 
> — leif
> 
> minotaur (20:45) 280/0 $ tar tvf clang-format.tgz
> drwxr-xr-x leif/users        0 2015-03-20 20:39 clang-format/
> -rwxr-xr-x leif/users    18073 2015-03-20 20:39 clang-format/git-clang-format
> -rw-r--r-- leif/users     6124 2015-03-20 20:39 clang-format/clang-format.el
> -rwxr-xr-x leif/users  1551800 2015-03-20 20:38 clang-format/clang-format.fc21
>