[PATCH 1/6] glossary: fix overoptimistic automatic linking of defined terms
- From
- J. Bruce Fields <bfields@citi.umich.edu>
- Date
- Mar 11, 2007, 04:35 UTC
- Message-ID
- <11735877321525-git-send-email-bfields@citi.umich.edu>
- In-Reply-To
- <11735877311383-git-send-email-bfields@citi.umich.edu>
From: J. Bruce Fields <bfields@citi.umich.edu>
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 | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-)
diff --git a/Documentation/sort_glossary.pl b/Documentation/sort_glossary.pl index e0bc552..05dc7b2 100644 --- a/Documentation/sort_glossary.pl +++ b/Documentation/sort_glossary.pl @@ -48,7 +48,7 @@ This list is sorted alphabetically: '; @keys=sort {uc($a) cmp uc($b)} keys %terms; -$pattern='(\b(?<!link:git-)'.join('\b|\b(?<!link:git-)',reverse @keys).'\b)'; +$pattern='(\b(?<!link:git-)'.join('\b|\b(?<!-)',reverse @keys).'\b)'; foreach $key (@keys) { $terms{$key}=~s/$pattern/sprintf "<<ref_".no_spaces($1).",$1>>";/eg; print '[[ref_'.no_spaces($key).']]'.$key."::\n"
-- 1.5.0.gb75812-dirty