Noissue - clang-format configuration file for C++

c++/clang-format/README.md

+clang-format-eyeo
+=================
+
+A file containing style configuration for [`clang-format`](http://clang.llvm.org/docs/ClangFormat.html)

[Vasily Kuznetsov, 2017/09/11 10:44:33]

We are generally trying to keep the lines under 80 characters in README files in
this repo. It would be nice to reformat this README as well unless you think it
would hurt readability. In cases of long links, one possible option is to
convert them to footnote-like links like this:

    Lorem ipsum [dolor][1] sit amet...
    ...anim id est laborum.

    [1]: https://en.wiktionary.org/wiki/dolor

[Eric, 2017/09/15 13:09:01]

Fixed in patch set 3.
Number-footnotes are kind of awful for maintenance unless
automatically-generated. I did discover, however, that numeric identifiers are
not necessary; text identifiers are also permitted. I used that syntax.

+that formats according to the [Adblock Plus coding style guide](https://adblockplus.org/coding-style#cpp)
+for C++.
+
+Installation
+------------
+
+When `clang-format` receives its style configuration from a file, it searches
+for style configuration in the directory of each input file and then each parent
+directory. Copy the format file to the parent directory of the working
+directory. In this way it will `clang-format` will find the format file and
+the version control system will not.
+
+The configuration file must be named either "`.clang-format`" or "`_clang-format`".
+At the present time there's no command line option to specify the file name.
+
+Usage  
+-----
+
+    clang-format -style=file [...]
+    
+The option "-style=file" (note that this is the word "file", not a file name)
+says to perform a directory search for the configuration. For the rest of the 
+command line, see the `clang-format` documentation link above.