On Tuesday 09 August 2005 07:51 am, Frerich Raabe wrote: > Moin, > > Philip Rodrigues made me aware of the new KSmiletris manual available at > http://users.ox.ac.uk/~chri1802/stuff/ksmiletris-index.docbook and I agreed > to see whether I could improve anything about it. Indeed, I could find > a few things: > > - a bunch of typos and grammar problems were solved > - entities have been used for 'Ctrl' and 'Tetris'. The latter is marked as > a <trademark> for now, I don't know what the exact status is on that. > Does anybody know? > - a few words were added which mention that as the leve increases, more > tiles are added which makes it more challenging to find fits. > - key combos are now marked up correctly. > - I added myself as a reviewer. :-)
I generated a diff from the two files and agree with the changes made to the handbook. > > Yet, a few things are left: > > - I think an <informaltable> is a poor choice for listing the default key > bindings. Unfortunately I couldn't find anything about how to mark that > up in the KDE DocBook guide, so before I make things even worse I decided > to leave things as they are and ask here (a <variablelist> maybe?). > - The descriptions of the menu entries of the Settings->Pieces menu are > quite useless IMHO. I think a screenshot for each menu item would be a > lot, so that one immediately sees what effect any of those options has. - > ...there was something else, but I forgot it now and unfortunately I > spilled coffee over my note. :-( > > In any case, you can find the updated manual at > http://ktown.kde.org/~frerich/ksmiletris-index.docbook > > - Frerich I am not sure what would be a better solution for the key bindings. This was my first try on documentation for KDE, so I am not sure where or how it goes from here. John Hayes
