From: Nicholas N. <nj...@ca...> - 2004-01-31 03:57:30
|
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 |