There is a basic bug in the code that the
pseudo-XML-ish tags are
*case-sensitive*. Currently, each entry must be listed as:
<c>category name
<q>question text
<a>answer text
or some variation upon that, given that whitespace is
insignificant.
It would be nice if case did not matter for the tags,
i.e. you could
use <C> as well as <c>.
The problem can be seen starting at line 810 in the
current version (1.18.2.5, the current version of the
2.3 branch that is being prepared for release 2.4) of
makefaq.py:
all = input.read()
# split into blocks on category delimiter (default
is <c>)
blocks = split(all,cfg.cdelim)
for line in blocks[1:]:
try:
a = split(line, cfg.qdelim)
b = split(a[1], cfg.adelim)
I just do a series of splits based on the configured
delimiters. While this works fine, it does not take
into account case-sensitivity. The issue
needs to be explored, although I'm not sure if there is
any easy solution, given that the program allows you to
define your own delimiter tags, which may or may not
even contain letters.