Bug#846269: man clang-format: deceptive link to texinfo

Joachim Wuttke j.wuttke at fz-juelich.de
Tue Nov 29 18:18:33 UTC 2016


Package: clang-format-3.9
Version: 1:3.9-6

The "SEE ALSO" section of the man page says:
"The full documentation for clang-format is maintained as a Texinfo ...
  the command info clang-format should give you access to the complete manual."

This is deceptive, since "info clang-format" only prints a verbatim copy of
the man page (even including the "SEE ALSO" section).

The "SEE ALSO" section should therefore be rewritten. The redirection to
Texinfo should be deleted unless the Texinfo page is substantially enhanced.
Instead, the "SEE ALSO" section should point to a full documentation
of the clang-format style options. Since such documentation seems not to
be available offline, I suggest to point to the web page
http://llvm.org/releases/3.9.0/tools/clang/docs/ClangFormatStyleOptions.html

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5110 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-llvm-team/attachments/20161129/2ccac2ca/attachment.bin>


More information about the Pkg-llvm-team mailing list