[Valgrind-developers] FAQ rearrangement

[Nicholas N. <nj...@ca...>]

Hi,

Our FAQ file could do with some rearrangement in the CVS HEAD.  I propose
splitting it into sections, and removing some of the questions that no
longer apply.

Here's my suggestion for the sections, and which questions should go in
each one.


1. Trivia:  origins of the name 'Valgrind', pronunciation

2. Compiling, installing and configuring: 16

3. Valgrind aborts unexpectedly:  1, 3, (4), 8, (9), (11), (12), 13

4. Unexpected output and behaviour: (5), 6, (7), (10), 14, 15, mention
      lack of stack/static checking

5. misc: 17


The numbers in parentheses are the ones I think can be removed, as they
have been addressed in the CVS HEAD.

An extra possibility would be to use the script glibc uses for producing
its FAQ, which pulls out the section names and questions into a nice table
at the top, which makes it easier to find questions.  It also
automatically numbers the questions in order, which is nice but means the
numbers can change over time... I think I'd prefer to just remove old
questions and have gaps in the numbering.

N