bugPSPP - Bugs: bug #35882, Syntax examples in documentation...


bug #35882: Syntax examples in documentation should be marked as CODE.

Submitted by:  John Darrington <jmd>
Submitted on:  Sun 18 Mar 2012 08:15:37 AM UTC  
Category:  Documentation Severity:  5 - Average
Status:  None Assigned to:  None
Open/Closed:  Open Release:  None
Effort:  0.00

Add a New Comment (Rich Markup)

You are not logged in

Please log in, so followups can be emailed to you.


Sun 18 Mar 2012 08:15:37 AM UTC, original submission:  

 Eliana <elianasemail2@gmail.com> reports:

Sorry, the web interface is too hard for me to use.

Add html  CODE tags to html versions of the  manual.   Those are html tags that tell translation engines not to translate the text indicated.

Without those tags, translation engines happily translate commands into the foreign language, totally disregarding their sanctity and rendering the translation very confusing and possibly erroneous in some cases

Adding these tags is not a  trivial project, but
requires no knowledge of any foreign language, and I believe would render the online manual a meaningful document for a larger portion of the international community without requiring  translating separate manuals for each language.

But it will require proofing of the translated pages to spot any items that needed code tags which have not been generated - translation engines definitely also translate   abbreviations and special characters. and add unexpected punctuation marks inappropriately.

Proofing is easier if someone knows the foreign language, but if you know the manual contents, you will see things that look wrong even if you do not know the foreign language.

John Darrington <jmd>
Project Administrator


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by jmd (Submitted the item)
  • -email is unavailable- added by jmd

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.




    Follows 1 latest change.

    Date Changed by Updated Field Previous Value => Replaced by
    2012-03-18 jmd Carbon-Copy- => Added elianasemail2@gmail.com

    Back to the top

    Powered by Savane 3.5