perf_counter tools: Generate per command manpages (and pdf/html, etc.)

Import Git's nice .txt => {man/html/pdf} generation machinery.

Fix various errors in the Documentation/perf*.txt description as well.

Also fix a bug in builtin-help: we'd map 'perf help top' to 'perftop'
if only the 'perf' binary is in the default PATH - confusing the manpage
logic. I dont fully understand why Git did it this way - but i suppose
it's a migration artifact from their migration from standalone git-xyz
commands to 'git xyz' commands. The perf tools were always using the
modern form so it's not an issue there.

Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
Cc: Mike Galbraith <efault@gmx.de>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Corey Ashford <cjashfor@linux.vnet.ibm.com>
Cc: Marcelo Tosatti <mtosatti@redhat.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: John Kacur <jkacur@redhat.com>
LKML-Reference: <new-submission>
Signed-off-by: Ingo Molnar <mingo@elte.hu>

1 files changed, 61 insertions, 0 deletions

diff --git a/Documentation/perf_counter/Makefile b/Documentation/perf_counter/Makefile
index 8f725840477f..416ab11e9786 100644
--- a/Documentation/perf_counter/Makefile
+++ b/Documentation/perf_counter/Makefile
@@ -693,6 +693,21 @@ builtin-revert.o wt-status.o: wt-status.h
 $(LIB_FILE): $(LIB_OBJS)
         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIB_OBJS)
 
+doc:
+        $(MAKE) -C Documentation all
+
+man:
+        $(MAKE) -C Documentation man
+
+html:
+        $(MAKE) -C Documentation html
+
+info:
+        $(MAKE) -C Documentation info
+
+pdf:
+        $(MAKE) -C Documentation pdf
+
 TAGS:
         $(RM) TAGS
         $(FIND) . -name '*.[hcS]' -print | xargs etags -a
@@ -781,6 +796,31 @@ ifneq (,$X)
         $(foreach p,$(patsubst %$X,%,$(filter %$X,$(ALL_PROGRAMS) $(BUILT_INS) perf$X)), $(RM) '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/$p';)
 endif
 
+install-doc:
+        $(MAKE) -C Documentation install
+
+install-man:
+        $(MAKE) -C Documentation install-man
+
+install-html:
+        $(MAKE) -C Documentation install-html
+
+install-info:
+        $(MAKE) -C Documentation install-info
+
+install-pdf:
+        $(MAKE) -C Documentation install-pdf
+
+quick-install-doc:
+        $(MAKE) -C Documentation quick-install
+
+quick-install-man:
+        $(MAKE) -C Documentation quick-install-man
+
+quick-install-html:
+        $(MAKE) -C Documentation quick-install-html
+
+
 ### Maintainer's dist rules
 
 perf.spec: perf.spec.in
@@ -801,6 +841,26 @@ dist: perf.spec perf-archive$(X) configure
         @$(RM) -r $(PERF_TARNAME)
         gzip -f -9 $(PERF_TARNAME).tar
 
+htmldocs = perf-htmldocs-$(PERF_VERSION)
+manpages = perf-manpages-$(PERF_VERSION)
+dist-doc:
+        $(RM) -r .doc-tmp-dir
+        mkdir .doc-tmp-dir
+        $(MAKE) -C Documentation WEBDOC_DEST=../.doc-tmp-dir install-webdoc
+        cd .doc-tmp-dir && $(TAR) cf ../$(htmldocs).tar .
+        gzip -n -9 -f $(htmldocs).tar
+        :
+        $(RM) -r .doc-tmp-dir
+        mkdir -p .doc-tmp-dir/man1 .doc-tmp-dir/man5 .doc-tmp-dir/man7
+        $(MAKE) -C Documentation DESTDIR=./ \
+                man1dir=../.doc-tmp-dir/man1 \
+                man5dir=../.doc-tmp-dir/man5 \
+                man7dir=../.doc-tmp-dir/man7 \
+                install
+        cd .doc-tmp-dir && $(TAR) cf ../$(manpages).tar .
+        gzip -n -9 -f $(manpages).tar
+        $(RM) -r .doc-tmp-dir
+
 rpm: dist
         $(RPMBUILD) -ta $(PERF_TARNAME).tar.gz
 
@@ -819,6 +879,7 @@ clean:
         $(RM) -r $(PERF_TARNAME) .doc-tmp-dir
         $(RM) $(PERF_TARNAME).tar.gz perf-core_$(PERF_VERSION)-*.tar.gz
         $(RM) $(htmldocs).tar.gz $(manpages).tar.gz
+        $(MAKE) -C Documentation/ clean
         $(RM) PERF-VERSION-FILE PERF-CFLAGS PERF-BUILD-OPTIONS
 
 .PHONY: all install clean strip