English Breakfast Network

Almost, but not quite, entirely unlike tea.

Home >  DocBook Sanitizer >  kde-4.0 >  kdegraphics >  kolourpaint

Other kdegraphics/kolourpaint reports: [API Documentation] [Krazy Code Checker]

Results for kolourpaint

...as of January 05 2008 00:57:12 (SVN revision 757448)

  1. Checking for well-formed XML... okay!
  2. Checking for proper DOCTYPE declaration... okay!
  3. Scanning for multiple root elements... okay!
  4. Looking for proper translator markers... OOPS! 1 issue found!
    The markup doesn't seem to contain a TRANS:CREDIT_FOR_TRANSLATORS marker. This is required, please add it.

    People who spent time on translating your document should be given credit appropriately. To do this, you need to specify two special comments in your markup:

    <!-- TRANS:ROLES_OF_TRANSLATORS -->
    This special comment must appear exactly once in your markup; you should put it at the end of your <authorgroup> element.

    <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
    There must only be one DocBook file in the directory which has this marker. It needs to be placed at the end of your document, right before the &underFDL; entity.

  5. Verifying that preferred words of phrases were used... okay!
  6. Testing for applicable entities... OOPS! 3 issues found!

    Note:It is not guaranteed that the document is still valid after applying these suggestions! If you happen to see a suggestion which would break the document, please send Frerich Raabe a mail about it.

    • Entity could be used in line 26: 
      -<email>thurston_dang@users.sourceforge.net</email>
+&Thurston.Dang.mail;
    • Entity could be used in line 45: 
      -<holder>Thurston Dang</holder>
+<holder>&Thurston.Dang;</holder>
    • Entity could be used in line 1403: 
      -Danny Allen <email>dannya40uk@yahoo.co.uk</email>
+&Danny.Allen; <email>dannya40uk@yahoo.co.uk</email>

    There are a lot of entities available to authors of KDE manuals which make it easy to keep the spelling of applications and abbreviations consistent. Using them makes sure that application names are capitalized and marked up correctly, licensed terms get proper 'trademark' and 'copyright' signs, keys which are labelled differently in different countries (such as the 'Ctrl' key which is labelled 'Strg' on german keyboards) get automatically translated and more. To make a long story short - you don't lose anything when using entities as much as possible, but you gain a lot.

  7. Checking for invalid image references... okay!