home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / TGFAQ_A2.ZIP / FAQ_LANG.TXT < prev    next >
Text File  |  1998-08-01  |  5KB  |  119 lines
  1.                      10 STEP LANGUAGE RECOVERY PROGRAM
  2.  
  3.       
  4.     This is a 10 step program to recover the text for a Telegard language
  5.     file where the compiled .tgl is up-to-date but the original uncompiled 
  6.     .txt file has been deleted or damaged.
  7.     
  8.     This program does not require any tools that you don't already have at 
  9.     your disposal.
  10.  
  11.     THE 10 STEPS (+1) TO RECOVERY
  12.         
  13.         0. Make backups of your language files (.txt and .tgl)... (jic)
  14.  
  15.         1. Rename your lost .tgl file to 'recover.tgl'
  16.         
  17.         2. Open a text editor, start a new file 'emptylng.txt', add one 
  18.            line '; this is a blank language file' and save
  19.  
  20.         3. Execute 'makelang emptylng.txt' (if makelang is not in your
  21.            path, run '\tgpath\makelang emptylng.txt' instead)
  22.  
  23.         4. Unzip the release english.txt file;
  24.  
  25.            a) Change to a Telegard temp directory (\temp, \temp1, etc.)
  26.    
  27.            b) GAMMA/RELEASE VERSIONS: Extract the language.tws file into 
  28.               this directory ('pkunzip tg_309g1.zip install.tg', 'pkunzip 
  29.               install.tg -sREADYTOGO language.tws').  Unpack the .tws file 
  30.               into this directory ('unpack language.tws .'). 
  31.       
  32.               BETA VERSIONS: Unzip the english.txt file into this directory 
  33.               from the latest __update.zip file ('pkunzip __update.zip 
  34.               english.txt').
  35.         
  36.            c) Rename english.txt to release.txt, and copy to your languages 
  37.               directory.
  38.    
  39.         5. Execute 'makelang release.txt'
  40.  
  41.         6. Execute 'cmprlang emptylng recover'
  42.  
  43.         7. Open a text editor, open 'cmprlang.txt', and then delete the 
  44.            lines at the top of the file 'CMPRLANG results file:' to the 
  45.            0001 line (not including 0001 line), and at the end of the file 
  46.            'Checking for different strings' and the associated blank lines.
  47.  
  48.         8. Rename cmprlang.txt to recover.txt
  49.  
  50.         The language file recover.txt has all the lines from your original 
  51.         .tgl, recovered back to their text (uncompiled) form.  While this 
  52.         is sufficient recovery, it sure would be nice to get the comments 
  53.         of what variables are, etc. updated eh?  Sure, no problem....
  54.  
  55.         9. Execute 'makelang recover -M release'.
  56.         
  57.         Your language is now as good as new...
  58.  
  59.         10. Rename 'recover.NEW' to whatever your (lost) .tgl file was 
  60.             called.  Recompile and check things out...
  61.  
  62.         * * * IMPORTANT NOTE * * *   Depending on the last time you updated 
  63.         the text of the recovered language, you should also make the 
  64.         modifications to the language that occurred from the time you last 
  65.         updated the text to the date of the release language.  Grab all the 
  66.         appropriate LANGUAGE.* files, and make the appropriate changes 
  67.         (note, you should not have to add or remove any lines, since the -M 
  68.         merge automatically took care of that portion for you).
  69.         
  70.     
  71.     WHY DOES THIS WORK?
  72.         
  73.         The Telegard language tools are extremely powerful.
  74.           
  75.         When 'cmprlang' runs, it is checking an empty language against a 
  76.         complete, compiled language.  Each line that exists in the compiled 
  77.         language does not exist in the empty language, and is considered 
  78.         new.  Thus, the resulting cmprlang.txt file is all of the language 
  79.         lines from your original compiled language listed as 'new'.
  80.  
  81.         When 'makelang -M' runs, it is checking for new/removed lines, and 
  82.         also restoring all of the comments.  So your uncommented language 
  83.         file recover.txt becomes a commented language file recover.new.  
  84.         This file also has been updated with new (or missed entries; if 
  85.         they were blank entries) from the release language, and all deleted 
  86.         language id lines have also been removed.  So when your language 
  87.         file comes out of the makelang process, it's as good as new . . .
  88.         
  89.     
  90.     WHAT IS DIFFERENT FROM MY OLD LANGUAGE FILE AND THIS NEW ONE?
  91.     
  92.         If you added your own comments, those were lost.  Unfortunately the 
  93.         comments are not stored in the .tgl file, and thus could not be 
  94.         recovered.
  95.         
  96.         Lines that were removed since you last updated the language were 
  97.         removed.  Lines that were added now exist (check out the lines that 
  98.         the makelang -M returns--some of those lines might be blank lines 
  99.         that the compiled .tgl did not have, but it's quite possible that 
  100.         there are a couple of new lines too...).
  101.         
  102.         The comments in the language are up-to-date (so if you didn't add 
  103.         variable comments/descriptions/etc. from language change to 
  104.         language change, you'll be happy to know they've magically 
  105.         appeared).
  106.         
  107.         Otherwise, the file is as good as your old one.  Honest.  And all 
  108.         for less than a nickel.
  109.         
  110.     
  111.     CONTACTING THE AUTHOR
  112.  
  113.         The author of this document can be contacted as follows:
  114.  
  115.         Echomail                Tim Strike, TG_SUPPORT (fidonet)
  116.         Netmail                 Tim Strike @ 1:259/423 (fidonet)
  117.         Internet Email          tim@telegard.net
  118.         
  119.