[PATCH/RFCv4 1/4] Documentation: Preparation for gitweb manpages

Gitweb documentation currently consist of gitweb/README, gitweb/INSTALL and comments in gitweb source code. This is harder to find, use and browse that manpages ("man gitweb" or "git help gitweb") and HTML documentation ("git help --web gitweb").

The goal is to move documentation out of gitweb/README to gitweb.txt and gitweb.conf.txt manpages, reducing its size 10x from around 500 to around 50 lines (two pages), and move information not related drectly to building and installing gitweb out of gitweb/INSTALL there.

The idea is to have gitweb manpage sources reside in AsciiDoc format in Documentation/ directory, like for gitk and git-gui. Alternate solution would be to have gitweb documentation in gitweb/ directory, perhaps in POD format (see perlpod(1)).

This patch adds infrastructure for easy generating gitweb-related manpages. It adds currently empty 'gitweb-doc' target to Documentation/Makefile, and 'doc' proxy target to gitweb's Makefile.

This way to build gitweb documentation one can use

  make -C gitweb doc

or

  cd gitweb; make doc

The gitweb.conf(5) and gitweb(1) manpages will be added in subsequent commits.

Signed-off-by: Jakub Narebski <jnareb@gmail.com>
---
This changes were part of patch adding first gitweb manpage in
previous version of this series.

Compared to v3 series it lacks the following hunk (at the very end of Documentation/Makefile):

  @@ -334,4 +337,4 @@ quick-install-man:
   quick-install-html:
   	'$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(HTML_REF) $(DESTDIR)$(htmldir)
  
  -.PHONY: FORCE
  +.PHONY: FORCE gitweb-doc

This is because it would introduce inconsistency, as 'gitweb-doc' would be only one of many phony targets in Documentation/Makefile that is explicitly marked .PHONY

So this is something left for other commit.

 Documentation/Makefile |    3 +++
 gitweb/Makefile        |    7 ++++++-
 2 files changed, 9 insertions(+), 1 deletions(-)