[PATCH/RFCv4 0/4] Moving gitweb documentation to manpages

[Jakub Narebski <jnareb@gmail.com>]

The original patch adding manpage for /etc/gitweb.conf was sent by
Drew Northup; I have added manpage for gitweb itself, inspired by his
patch.  Unfortunately Drew doesn't currently have time to work on this
patch (patch series), so that is why it is me resending this series.

It is closer to final version, but still is a bit work in progres.
The main improvement is that documentation now renders correctly as
HTML.

Note that we should probably add gitweb(1) and gitweb.conf(5) manpages
to the list in git(1) manpage.


Table of contents:
~~~~~~~~~~~~~~~~~~
1. The changes to Documentation/Makefile adding gitweb-doc target and
to gitweb/Makefile adding doc target are now upfront as a separate
patch, compared to previous version of this series:

  "[RFC/PATCHv3 0/5] Improving gitweb documentation, creating manpages"
  http://thread.gmane.org/gmane.comp.version-control.git/175140

This is mainly so that description of ideas, which is common for both
gitweb.conf.txt and gitweb.txt, is in a separate upfront commit
message.


2. The man page for /etc/gitweb.conf is modified, extended and
improved version of original patch by Drew Northup from

  "[PATCH/WIP] Starting work on a man page for /etc/gitweb.conf"
  http://thread.gmane.org/gmane.comp.version-control.git/173422

Drew version was mostly pulled directly from the README and INSTALL
files of gitweb.  I have tried to incorporate comments in mentioned
thread, and to group config variables by category.  This version
is also checked that it renders correctly as HTML and as manpage,
compared to version send earlier in

  "[RFC/PATCHv3 4/5] gitweb: Starting work on a man page for /etc/gitweb.conf (WIP)"
  http://thread.gmane.org/gmane.comp.version-control.git/175140/focus=175145

This version now moves, rather than copies, contents from
gitweb/README file.  It now has up-to-date commit message.

It was also updated to include new gitweb-comon.conf config file
(common system-wide config file, used *in addition to* per-instance
gitweb_config.perl config file).


3. The man page for gitweb is improved version of patch I have sent to
git mailing list as

  "[RFC/PATCHv3 5/5] gitweb: Starting work on a man page for gitweb (WIP)"
  http://thread.gmane.org/gmane.comp.version-control.git/175140/focus=175146
 
This version was fixed to render correctly as HTML and as manpage, and
has update commit message.


4. The addition of gitweb manpages to 'gitweb' subpackage in
gitweb.spec (via gitweb.spec.in) is new in this series.


Shortlog:
~~~~~~~~~
Drew Northup (1):
  gitweb: Add manpage for /etc/gitweb.conf (for gitweb documentation)

Jakub Narebski (3):
  Documentation: Preparation for gitweb manpages
  gitweb: Add manpage for gitweb
  gitweb: Add gitweb manpages to 'gitweb' package in git.spec

Diffstat:
~~~~~~~~~
 Documentation/Makefile        |    7 +-
 Documentation/gitweb.conf.txt |  789 +++++++++++++++++++++++++++++++++++++++++
 Documentation/gitweb.txt      |  703 ++++++++++++++++++++++++++++++++++++
 git.spec.in                   |    7 +
 gitweb/INSTALL                |   96 +-----
 gitweb/Makefile               |    7 +-
 gitweb/README                 |  411 ++--------------------
 7 files changed, 1540 insertions(+), 480 deletions(-)
 create mode 100644 Documentation/gitweb.conf.txt
 create mode 100644 Documentation/gitweb.txt

-- 
1.7.6