glossary: fix overoptimistic automatic linking of defined terms
commitc816eb1784b324fcf3988253affac4d43bce78c9
authorJ. Bruce Fields <bfields@citi.umich.edu>
Mon, 5 Mar 2007 00:13:09 +0000 (4 19:13 -0500)
committerJ. Bruce Fields <bfields@citi.umich.edu>
Sun, 11 Mar 2007 04:05:01 +0000 (10 23:05 -0500)
treec9b957fa8718ad7eef0349f14833343e6d3d5e85
parentef203f08564c1c6d267fedf8e0357c56d477892f
glossary: fix overoptimistic automatic linking of defined terms

The script sort_glossary.pl turns each use of "term" into a link to the
definition of "term".  To avoid mangling links like

gitlink:git-term[1]

it doesn't replace any occurence of "term" preceded by "link:git-".
This fails for gitlink:git-symbolic-ref[1] when substituting for "ref".

So instead just refuse to replace anything preceded by a "-".
That could result in missing some opportunities, but that's a less
annoying error.

Actually I find the automatic substitution a little distracting; some
day maybe we should just run it once and commit the result, so it can
be hand-tuned.

Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
Documentation/sort_glossary.pl