[systemd-devel] [PATCH 1/2] tools: add script to detect repeating words in docs

[Zbigniew Jędrzejewski-Szmek]

On Wed, Jul 23, 2014 at 02:57:10PM +0200, Zbigniew Jędrzejewski-Szmek wrote:
> On Wed, Jul 23, 2014 at 12:40:06PM +0200, Karel Zak wrote:
> >  - all <programlisting> sections from input files are ignored
> >  - it's possible to white-list wanted repeats by KNOWN_REPEATS[] in the script
> >  - the script is based on checkmans.sh from util-linux project
> >  - it's integrated to build-sys, just type "make check-repwords", for example:
> Hi,
> 
> I think it would be nicer to simply incorporate the check into
> tools/make-directive-index.py. It already contains some checks on
Actually it's check_id() in make-man-index.py.

> <refentry> header correctness. Since it already parses all XML, you'd
> get this check basically for free run-time wise, and it should be much
> simpler to write and more robust, since you don't have to parse XML by hand [1].
> 
> Zbyszek
> 
> [1] http://lxml.de/api/lxml.etree-module.html#strip_tags

Zbyszek