<html>
    <head>
      <base href="https://bugs.llvm.org/">
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW - Preprocessor indentation in clang-format not well documented"
   href="https://bugs.llvm.org/show_bug.cgi?id=40461">40461</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>Preprocessor indentation in clang-format not well documented
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>Documentation
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>trunk
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>enhancement
          </td>
        </tr>

        <tr>
          <th>Priority</th>
          <td>P
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>General docs
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>unassignedbugs@nondot.org
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>rkasanmascheff@hotmail.com
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>llvm-bugs@lists.llvm.org
          </td>
        </tr></table>
      <p>
        <div>
        <pre>Current documentation of clang-format misses one detail for preprocessor
indentation.

Written there is:

PPDIS_AfterHash (in configuration: AfterHash) Indents directives after the
hash.

The full description of semantics is written down in the implementing 

<a href="https://reviews.llvm.org/D35955">https://reviews.llvm.org/D35955</a>

The following detail is missing in the documentation. Especially in which cases
a guard is detected.

Preprocessor indentation also attempts to ignore include guards with the
checks:

Include guards cover the entire file
Include guards don't have #else
Include guards begin with
#ifndef <var>
#define <var>

...</pre>
        </div>
      </p>


      <hr>
      <span>You are receiving this mail because:</span>

      <ul>
          <li>You are on the CC list for the bug.</li>
      </ul>
    </body>
</html>