diff options
| -rw-r--r-- | TODO | 16 |
1 files changed, 16 insertions, 0 deletions
@@ -1,5 +1,21 @@ General +* Make damn certain our Docbook markup is both _CORRECT_ and + _CONSISTANT_. There's many places where the <screen> sections + are very different. They should all be of this form. + +<screen> + <prompt>darkstar:~$ <prompt><userinput>_EVERYTHING_ the user types</userinput> + Anything the screen prints that the user doesn't type. +</screen> + + I've found several cases where the <command> tag was used inside of a + <screen> section. This is wrong and must be avoided. When the book + goes to the publisher, all of those <command> tags will be formatted + one way for printing and the <userinput> tags could be formatted + another. Also, wrapping only applications in <command> tags could + make the reader wonder just how much they are supposed to type. + * Aim to update references to kernel versions and Slackware versions to those used in the most recent release of Slackware. I've seen kernel 2.6.29.4 and Slackware 12.0.0 for instance. |