Re: [Boost-docs] C++11 Quickbook

Subject: Re: [Boost-docs] C++11 Quickbook
From: Edward Diener (eldiener_at_[hidden])
Date: 2017-11-10 20:36:09

On 11/10/2017 2:19 PM, Daniel James via Boost-docs wrote:
> On 10 November 2017 at 18:25, Edward Diener via Boost-docs
> <boost-docs_at_[hidden]> wrote:
>>>
>>> I'm also thinking about using clang-format. Would anyone object to
>>> that? Of course I'll have to stop it formatting spirit grammars, so it
>>> can't be used everywhere.
>>
>>
>> How would you be using clang-format in quickbook ?
> 
> It's used to automatically format the C++ source code to have a
> consistent style. It lets you specify things like where braces are
> places, what indentation is used, how wide lines of code can be. I've
> been using it with unordered, and find it helps me develop faster. I
> think a consistent code layout also helps. I tried to create a format
> that isn't too different from existing code, although as different
> parts were written with different styles, and there are some things
> that it can't do.

If you are going to use it to automatically reformat inline code in 
quickbook before converting the quickbook to boostbook, I would guess 
that few would mind.

> 
> You can see the result here:
> 
> https://github.com/danieljames/quickbook/commit/580316c6a5cae1812341c76feb45582cecd44eb6
> 
> Although that version doesn't actually work on windows because it
> messes up the header ordering, so I've tweaked the configuration a
> little more since.
> 
> I've got a bash script I use to run it, so I'll probably check that
> in. But don't worry about it if you're creating a pull request, I'd
> just reformat after merging (it's possible to rewrite the history of
> the pull request so it's formatted correctly, but I think that would
> cause confusion).
>