git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[RFC/PATCHv2 0/2] Starting work on man pages for gitweb and gitweb.conf (WIP)

From
Jakub Narebski <jnareb@gmail.com>
Date
May 29, 2011, 19:50 UTC
Message-ID
<1306698626-32402-1-git-send-email-jnareb@gmail.com>
This is very much work in progress.  
1. The man page for /etc/gitweb.conf is modified, extended and
improved version of 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.

2. The man page for gitweb is slightly extended version of patch I
have sent to git mailing list as
  "[RFC/PATCH] gitweb: Starting work on a man page for gitweb (WIP)"
  http://thread.gmane.org/gmane.comp.version-control.git/173422/focus=173625

NOTE that I have only tested that both generated manpages _looks_ (halfway) reasonable. I didn't check HTML output.

The major part that is left (besides extending both manpages with new information) is actually de-duplicate contents, i.e. delete those parts of gitweb/README and gitweb/INSTALL that were copied to those new manpages.

Both of those are also available in 'gitweb/doc' branch in one of my repositories:

  git://repo.or.cz/git/jnareb-git.git
  git://github.com/jnareb/git.git
Shortlog:
~~~~~~~~~
Drew Northup (1):
  Starting work on a man page for /etc/gitweb.conf (WIP)
Jakub Narebski (1):
  gitweb: Starting work on a man page for gitweb (WIP)
Diffstat:
~~~~~~~~~
 Documentation/Makefile        |    4 +-
 Documentation/gitweb.conf.txt |  436 +++++++++++++++++++++++++++++++++++++++++
 Documentation/gitweb.txt      |  334 +++++++++++++++++++++++++++++++
 git.spec.in                   |    3 +
 gitweb/Makefile               |   14 ++
 5 files changed, 789 insertions(+), 2 deletions(-)
 create mode 100644 Documentation/gitweb.conf.txt
 create mode 100644 Documentation/gitweb.txt
-- 
1.7.5
Next: Jakub Narebski
Message 1 of 5 in “[RFC/PATCHv2 0/2] Starting work on man pages for gitweb and gitweb.conf (WIP)”
  1. Jakub NarebskiMay 29, 2011
  2. 1/2 Starting work on a man page for /etc/gitweb.conf (WIP)Jakub Narebski, May 29, 2011
  3. Junio C HamanoMay 29, 2011
  4. Jakub NarebskiMay 29, 2011
  5. 2/2 gitweb: Starting work on a man page for gitweb (WIP)Jakub Narebski, May 29, 2011

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.