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:  Wont Fix Assigned to:  None
Open/Closed:  Closed 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.

 

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>
Project 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>
Project 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
  •  

    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.

     

     

     

    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 elianasemail2@gmail.com

    Back to the top


    Powered by Savane 3.5