summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--TODO16
1 files changed, 16 insertions, 0 deletions
diff --git a/TODO b/TODO
index 816d9d3..f92d0ec 100644
--- a/TODO
+++ b/TODO
@@ -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.