Documentation: complete config list from other manpagest/doc-config-extraction
commit451c2efa2f32f1d52d5397215a6a42309c770aca
authorThomas Rast <trast@student.ethz.ch>
Tue, 21 Jun 2011 22:20:30 +0000 (22 00:20 +0200)
committerJakub Narebski <jnareb@gmail.com>
Tue, 21 Jun 2011 22:20:30 +0000 (22 00:20 +0200)
treea6afc06a648d03ea0de4d52b5eee9ba74d6bb25d
parent5a4964a879dba8a86995e49ed9f2abd9fae36a17
Documentation: complete config list from other manpages

Add an autogeneration script Documentation/make-config-list.perl
that complete list of config variables with missing variables
from other manpages.

This script generates minimal documentation for those missing config
variables at appropriate place in Documentation/config-vars.txt,
using the following form:

    foo.bar::
    foo.baz::
        See linkgit:git-foo[1].

It does that as follows:

* parse config-vars-src.txt (was config-vars.txt, which is now generated)
  to find out config variables it contains

* parse each manpage source (following includes) for config variable
  headers

* assemble a new config-vars.txt that completes the original list with
  "See linkgit:git-foo[1]" entries for all variables that were not in
  it config-vars-src.txt

Because config-vars.txt is now generated, and as a result can change
if any of examined files change, there was added automatically
generated dependency for this file (using the same script, but with
'--deps' option).

Signed-off-by: Thomas Rast <trast@student.ethz.ch>
Signed-off-by: Jakub Narebski <jnareb@gmail.com>
Documentation/Makefile
Documentation/config-vars-src.txt [moved from Documentation/config-vars.txt with 100% similarity]
Documentation/make-config-list.perl [new file with mode: 0755]