AStyle Supplemental Documentation

> > # Artistic Style Supplemental Documentation

> > ### Problems with Break Header Blocks, Break All Blocks

> > The following are known problems with the break header blocks and break all blocks options (`--break-blocks, --break-blocks=all`).

> > - If a statement is NOT part of a block, the following statements are all double spaced. Statements enclosed in a block are formatted correctly.

> >   > This:

> >   >     visStatusHeight = rcStatus.bottom - rcStatus.top;
> >   >     if(!opt.bViewStatus)
> >   >         visStatusHeight = 0;
> >   >     GetClientRect(hwnd, &rcEdit);
> >   >     iEditLeft = rcEdit.left;
> >   >     iEditRight = rcEdit.right - iEditLeft;

> >   > Becomes this (with extra lines added where they shouldn't be):

> >   >     visStatusHeight = rcStatus.bottom - rcStatus.top;

> >   >     if (!opt.bViewStatus)
> >   >         visStatusHeight = 0;

> >   >     GetClientRect(hwnd, &rcEdit);

> >   >     iEditLeft = rcEdit.left;

> >   >     iEditRight = rcEdit.right - iEditLeft;

> > - Comments are broken from the block.

> >   > This:

> >   >     // line numbers and select must be done after SCI_STYLECLEARALL
> >   >     if(setDialog)
> >   >         skip = true;

> >   > Becomes this (with a line added after the comment):

> >   >     // line numbers and select must be done after SCI_STYLECLEARALL

> >   >     if(setDialog)
> >   >         skip = true;