<html>
    <head>
      <base href="https://llvm.org/bugs/" />
    </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 --- - clang packages don't provide man pages"
   href="https://llvm.org/bugs/show_bug.cgi?id=26158">26158</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>clang packages don't provide man pages
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>Packaging
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>unspecified
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>PC
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>Linux
          </td>
        </tr>

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

        <tr>
          <th>Severity</th>
          <td>normal
          </td>
        </tr>

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

        <tr>
          <th>Component</th>
          <td>deb packages
          </td>
        </tr>

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

        <tr>
          <th>Reporter</th>
          <td>i.galic@brainsware.org
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>llvm-bugs@lists.llvm.org
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr></table>
      <p>
        <div>
        <pre>When installing clang-3.8 (or 3.7, or 3.6) I would expect the base package to
bring clang-3.8 man page (perhaps even update-alternatives to bind it to the
name clang)

However, this is not the case:

   ~> dpkg -L clang-3.8 | grep -w man
   /usr/share/man
   /usr/share/man/man1
   /usr/share/man/man1/scan-build-3.8.1.gz
   /usr/share/man/man1/clang-apply-replacements-3.8.1.gz
   /usr/share/man/man1/scan-view-3.8.1.gz
   /usr/share/man/man1/clang-tblgen-3.8.1.gz
   /usr/share/man/man1/pp-trace-3.8.1.gz
   /usr/share/man/man1/clang-check-3.8.1.gz
   /usr/share/clang/scan-build-3.8/man
   /usr/share/clang/scan-build-3.8/man/scan-build-3.8.1
   /usr/share/clang/scan-build-3.8/man/scan-build.1

nothing provides it:

    ~> man -k clang
    clang-apply-replacements-3.8 (1) - manual page for clang-apply-replacements
3.8
    clang-check-3.8 (1)  - manual page for clang-check 3.8
    clang-format-3.8 (1) - manual page for clang-format 3.8
    clang-format-diff-3.8 (1) - manual page for clang-format-diff.py 3.8
    clang-tblgen-3.8 (1) - manual page for clang-tblgen 3.8
    clang-tidy-3.8 (1)   - manual page for clang-tidy 3.8
    FcLangGetCharSet (3) - Get character map for a language
    FcLangNormalize (3)  - Normalize the language string
    FcLangSetAdd (3)     - add a language to a langset
    FcLangSetCompare (3) - compare language sets
    FcLangSetContains (3) - check langset subset relation
    FcLangSetCopy (3)    - copy a langset object
    FcLangSetCreate (3)  - create a langset object
    FcLangSetDel (3)     - delete a language from a langset
    FcLangSetDestroy (3) - destroy a langset object
    FcLangSetEqual (3)   - test for matching langsets
    FcLangSetGetLangs (3) - get the list of languages in the langset
    FcLangSetHash (3)    - return a hash value for a langset
    FcLangSetHasLang (3) - test langset for language support
    FcLangSetSubtract (3) - Subtract langsets
    FcLangSetUnion (3)   - Add langsets
    scan-build-3.8 (1)   - Clang static analyzer
    sclang (1)           - a real time audio synthesis programming language

and unlike clang-3.8-doc, which provides the documentation in html format,
there's also no clang-3.8-man equivalent:

    ~> apt-cache search clang 3.8
    clang-3.8 - C, C++ and Objective-C compiler (LLVM based)
    clang-3.8-doc - C, C++ and Objective-C compiler (LLVM based) -
Documentation
    clang-3.8-examples - Clang examples
    clang-format-3.8 - Tool to format C/C++/Obj-C code
    clang-tidy-3.8 - clang-based C++ linter tool
    libclang-3.8-dev - clang library - Development package
    libclang-common-3.8-dev - clang library - Common development package
    libclang1-3.8 - C interface to the clang library
    libclang1-3.8-dbg - clang library
    liblldb-3.8 - Next generation, high-performance debugger, library
    liblldb-3.8-dbg - Next generation, high-performance debugger, debugging
libraries
    liblldb-3.8-dev - Next generation, high-performance debugger - Header files
    lldb-3.8 - Next generation, high-performance debugger
    python-clang-3.8 - Clang Python Bindings
    python-lldb-3.8 - Next generation, high-performance debugger, python lib</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>