Hi, Attaching a patch that adds more packages for the generation of man page using help2man during build. Since it works on the '--help' info, I noticed some package which gave warning with lintian does not have the required help info for help2man.
I could have easily added the flag '--no-discard-stderr' to avoid outputs to stderr and could have save the build from failing but I noticed that while generation of man page for 'llvm-PerfectShuffle', it took a really long time and when I checked the man page generated, it was not looking appropriate. Some part of it :- 2568390836U, // <0,4,5,3>: Cost 3 vext1 <3,0,4,5>, <3,0,4,5> 2568391990U, // <0,4,5,4>: Cost 3 vext1 <3,0,4,5>, RHS 2718715180U, // <0,4,5,5>: Cost 3 vext3 <5,6,7,0>, <4,5,5,6> 1618136374U, // <0,4,5,6>: Cost 2 vext3 <1,2,3,0>, RHS 2592281624U, // <0,4,5,7>: Cost 3 vext1 <7,0,4,5>, <7,0,4,5> 1618136392U, // <0,4,5,u>: Cost 2 vext3 <1,2,3,0>, RHS 2550480938U, // <0,4,6,0>: Cost 3 vext1 <0,0,4,6>, <0,0,4,6> 3826880801U, // <0,4,6,1>: Cost 4 vuzpl <0,2,4,6>, <6,0,1,2> 2562426332U, // <0,4,6,2>: Cost 3 vext1 <2,0,4,6>, <2,0,4,6> 3786190181U, // <0,4,6,3>: Cost 4 vext3 <4,6,3,0>, <4,6,3,0> 2718715252U, // <0,4,6,4>: Cost 3 vext3 <5,6,7,0>, <4,6,4,6> 3826881165U, // <0,4,6,5>: Cost 4 vuzpl <0,2,4,6>, <6,4,5,6> 2712669568U, // <0,4,6,6>: Cost 3 vext3 <4,6,6,0>, <4,6,6,0> 2657760081U, // <0,4,6,7>: Cost 3 vext2 <6,7,0,4>, <6,7,0,4> 2718715284U, // <0,4,6,u>: Cost 3 vext3 <5,6,7,0>, <4,6,u,2> 3654090854U, // <0,4,7,0>: Cost 4 vext1 <5,0,4,7>, LHS 3934229326U, // <0,4,7,1>: Cost 4 vuzpr <7,0,1,4>, <6,7,0,1> 3734156437U, // <0,4,7,2>: Cost 4 vext2 <7,2,0,4>, <7,2,0,4> 3734820070U, // <0,4,7,3>: Cost 4 vext2 <7,3,0,4>, <7,3,0,4> 3654094134U, // <0,4,7,4>: Cost 4 vext1 <5,0,4,7>, RHS So, I choose to put only those package which are producing appropriate man pages without affecting the build. Requesting your feedback and please correct me for any novice mistake. Best, Reshabh Sharma
Index: debian/rules =================================================================== --- debian.orig/rules +++ debian/rules @@ -341,8 +341,13 @@ build_doc: mkdir debian/man/ help2man --version-string=$(LLVM_VERSION) clang/tools/scan-view/bin/scan-view > debian/man/scan-view-$(LLVM_VERSION).1 help2man --version-string=$(LLVM_VERSION) clang/tools/clang-format/clang-format-diff.py > debian/man/clang-format-diff-$(LLVM_VERSION).1 + help2man --version-string=$(LLVM_VERSION) clang/tools/clang-format/git-clang-format > debian/man/git-clang-format-$(LLVM_VERSION).1 + help2man --version-string=$(LLVM_VERSION) clang/tools/extra/clang-tidy/tool/clang-tidy-diff.py > debian/man/clang-tidy-diff-$(LLVM_VERSION).1 + help2man --version-string=$(LLVM_VERSION) clang/tools/extra/clang-tidy/tool/run-clang-tidy.py > debian/man/run-clang-tidy-$(LLVM_VERSION).1 + help2man --version-string=$(LLVM_VERSION) compiler-rt/lib/asan/scripts/asan_symbolize.py > debian/man/asan_symbolize-$(LLVM_VERSION).1 + + CMDS="llvm-dwarfdump llvm-mc llvm-mcmarkup llvm-objdump llvm-rtdyld llvm-size llvm-ranlib lldb lldb-mi clang-format clang clang++ clang-tblgen clang-check clang-cpp clang-import-test clang-tidy clang-apply-replacements clang-rename clang-query pp-trace sancov lli modularize clang-include-fixer find-all-symbols clang-reorder-fields ld.lld llvm-tblgen clang-change-namespace clang-offload-bundler scan-build llvm-cxxdump llvm-dsymutil llvm-dwp llvm-lto llvm-split llvm-tblgen obj2yaml sanstats verify-uselistorder yaml2obj clang-tblgen yaml-bench FileCheck lldb lldb-argdumper lldb-mi"; \ - CMDS="llvm-dwarfdump llvm-mc llvm-mcmarkup llvm-objdump llvm-rtdyld llvm-size llvm-ranlib lldb lldb-mi clang-format clang clang++ clang-tblgen clang-check clang-cpp clang-import-test clang-tidy clang-apply-replacements clang-rename clang-query pp-trace sancov lli modularize clang-include-fixer find-all-symbols clang-reorder-fields ld.lld llvm-tblgen clang-change-namespace clang-offload-bundler"; \ for f in $$CMDS; do \ echo "Generating manpage of $$f"; \ LD_LIBRARY_PATH=$(DEB_INST)/usr/lib/llvm-$(LLVM_VERSION)/lib/:/usr/lib/*/libfakeroot help2man --version-string=$(LLVM_VERSION) $(TARGET_BUILD)/bin/$$f > debian/man/$$f-$(LLVM_VERSION).1; \
