kicad/Documentation/development
John Beard 89d198659c Format: Default to switch cases on separate lines by default
Currently, the format enforces single lines when possible, but does
not enforce readable column-based alignment (and, moreover, *removes*
such manually added alignment:

    switch( m_orientation )
    {
    case PIN_RIGHT: m_orientation = PIN_UP; break;
    case PIN_UP: m_orientation = PIN_LEFT; break;
    }

Change this to multi-line by default:

    switch( m_orientation )
    {
    case PIN_RIGHT:
        m_orientation = PIN_UP;
        break;
    case PIN_UP:
        m_orientation = PIN_LEFT;
        break;
    }

If the developer wishes for column-aligned single-line cases, this
is permitted, but much be done manually:

    switch( m_orientation )
    {
    case PIN_RIGHT: m_orientation = PIN_DOWN;  break;
    case PIN_UP:    m_orientation = PIN_RIGHT; break;
    }

CHANGE: the _clang-format file to reflect this, and add note about
manual override in the dev docs.

(cherry picked from commit 272c045c37)
2019-05-07 09:50:22 +01:00
..
Doxyfile Doxyfiles: Remove local debug lines 2019-02-13 17:22:07 -08:00
coding-style-policy.md Format: Default to switch cases on separate lines by default 2019-05-07 09:50:22 +01:00
commit-message-format.md Add explaining notes on when to use changelog tags 2017-11-29 17:36:03 +01:00
compiling.md Docs: Fix doxygen links 2019-01-02 09:53:29 -05:00
config-strings.md Remove MaxUndoItems, make devel option DevelMaxUndoItems 2016-05-12 12:51:32 -04:00
pcbnew-plugins.md Fixup documentation for macOS Python script plugins. Fixes #1789960. 2018-11-28 09:40:22 -05:00
road-map-r5.md Docs: Fix doxygen links 2019-01-02 09:53:29 -05:00
road-map-r6.md Minor developer's documentation fixes. 2017-01-24 10:14:27 -05:00
road-map.md Update stable release 5 road map. 2016-07-05 10:06:23 -04:00
stable-release-policy.md Add stable release policy to developers documentation. 2014-10-18 11:37:08 -04:00
testing.md Docs: Advanced config is explicity experimental 2019-02-11 09:47:13 +00:00
tool-framework.md Explained AF_ACTIVATE flag in the documentation 2018-11-13 09:36:26 +01:00
ui-policy.md Documentation: UI policy update about dialogs 2018-12-03 12:22:14 -05:00