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

 
 

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

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

Add a New Comment Rich Markup
   

Wed 02 Sep 2020 02:04:58 AM UTC, comment #1: 

I can't see how this can be fixed in PSPP by itself. It would require work in Texinfo, to add semantic markup to @example and other environments so that they could be marked as being in particular languages. I do not think it is practical to do this in PSPP. It does seem like a good idea to bring this up on the texinfo mailing list, and I would encourage anyone who thinks this is an important issue to do so.

Ben Pfaff <blp>
Group administrator
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>
Group administrator

 

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

Attach Files:
   
   
Comment:
   

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 blp (Posted a comment)
  • -email is unavailable- added by jmd (Submitted the item)
  • -email is unavailable- added by jmd
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2020-09-02 blp StatusNone Wont Fix
        Open/ClosedOpen Closed
    2012-03-18 jmd Carbon-Copy- Added -email is unavailable-

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code