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

Zbigniew Jędrzejewski-Szmek zbyszek at in.waw.pl
Wed Jul 23 05:57:10 PDT 2014


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
<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


More information about the systemd-devel mailing list