tests/test-gendoc
author Martin Geisler <mg@lazybytes.net>
Sun, 13 Dec 2009 23:49:53 +0100
changeset 10065 a1ae0ed78d1a
parent 9485 7d6ac5d7917c
child 10282 08a0f04b56bd
permissions -rwxr-xr-x
minirst: improve layout of field lists Before, we used the padding following the key to compute where to wrap the text. Long keys would thus give a big indentation. It also required careful alignment of the source text, making it cumbersome to items to the list. We now compute the maximum key length and use that for all items in the list. We also put a cap on the indentation: keys longer than 10 characters are put on their own line. This is similar to how rst2html handles large keys: it uses 14 as the cutoff point, but I felt that 10 was better for monospaced text in the console.

#!/bin/sh

"$TESTDIR/hghave" rst2html || exit 80
RST2HTML=$(which rst2html 2> /dev/null || which rst2html.py)

HGENCODING=UTF-8
export HGENCODING

for PO in C $TESTDIR/../i18n/*.po; do
    LOCALE=$(basename $PO .po)
    echo
    echo "% extracting documentation from $LOCALE"
    echo ".. -*- coding: utf-8 -*-" > gendoc-$LOCALE.txt
    echo "" >> gendoc-$LOCALE.txt
    LC_ALL=$LOCALE python $TESTDIR/../doc/gendoc.py >> gendoc-$LOCALE.txt || exit

    # We run rst2html over the file without adding "--halt warning" to
    # make it report all errors instead of stopping on the first one.
    echo "checking for parse errors with rst2html"
    $RST2HTML gendoc-$LOCALE.txt /dev/null
done