Option to start \begin and \end environment on new lines

[cmhughes]

Option to start \begin and \end environment on new lines

[cmhughes]

As of 8329629 this feature is on the way to being full implemented for environments.

Currently, the yaml looks like this:

modifyLineBreaks:
    everyBeginStartsOnOwnLine: 1
    everyBodyStartsOnOwnLine: 1
    everyEndStartsOnOwnLine: 1
    everyEndFinishesWithLineBreak: 1
    equation*:
        BeginStartsOnOwnLine: 1
        BodyStartsOnOwnLine: 1
        EndStartsOnOwnLine: 1
        EndFinishesWithLineBreak: 1

I think I'd prefer it to be:

modifyLineBreaks:
    environments:
        everyBeginStartsOnOwnLine: 1
        everyBodyStartsOnOwnLine: 1
        everyEndStartsOnOwnLine: 1
        everyEndFinishesWithLineBreak: 1
        equation*:
           BeginStartsOnOwnLine: 1
           BodyStartsOnOwnLine: 1
           EndStartsOnOwnLine: 1
           EndFinishesWithLineBreak: 1
     ifElseFi:
        everyBeginStartsOnOwnLine: 1
        everyBodyStartsOnOwnLine: 1
        everyEndStartsOnOwnLine: 1
        everyEndFinishesWithLineBreak: 1
        ifnum:
           BeginStartsOnOwnLine: 1
           BodyStartsOnOwnLine: 1
           EndStartsOnOwnLine: 1
           EndFinishesWithLineBreak: 1
   etc.....

This would allow the user to specify linebreak choices globally on a per-object basis (as well as a per-named object).

[cmhughes]

I'd also like to see:

-1: leave alone, don't change linebreaks (translates to `undef` in the perl code)
0: e.g `BodyStartsOnOwnLine: 0` means body does *not* start on own line, so remove line break if necessary
1: e.g `BodyStartsOnOwnLine: 1` means body *does* start on own line, so add line break if necessary (this is the only one of the three currently implemented, as of https://github.com/cmhughes/latexindent.pl/commit/8329629b9300d5dd906381bfb2a72475e3b9ba00) 

[cmhughes]

As of f29e867 this is now fully implemented. See test-cases/mand-args/mand-arg-test-cases.sh for samples.

The YAML interface is slightly different from that detailed above, as there is no need for 'every'.

Furthermore, each poly-switch can take the value of 2, which will add a comment symbol before adding a line break (if one is not already present) as appropriate.