home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RALDMP10.ZIP / RALDUMP.DOC < prev    next >
Encoding:
Text File  |  1993-11-07  |  5.4 KB  |  150 lines
  1.  
  2.                                 RALDUMP 1.0
  3.                   Remote Access Language File Dump to Text
  4.  
  5.              (C)Copyright 1993, Rand Nowell - RaLin Enterprises
  6.  
  7.  
  8.   RALDUMP.EXE is distributed as FREEWARE! Registration is not required.
  9.   You may freely distribute and use RALDUMP.
  10.  
  11.   If you find the program useful, a postcard, letter, netmail, echo message,
  12.   stating this fact would be appreciated.
  13.   Of course if you want to send money, I would not refuse it! <smile>
  14.  
  15.   ┌────────┐
  16.   │WARRANTY│
  17.   └────────┘
  18.     NONE!  Program is supplied "AS IS" and the author assumes no liability
  19.     whatsoever for any damages. You use it at your own risk!  Test results
  20.     here at RaLin have shown NO problems, but if one develops, we are not
  21.     responsible. If a problem is reported, we will attempt to fix it, and
  22.     release a modified version of the program.
  23.  
  24.     But.... the author is not obligated to produce any further version of the
  25.     program.
  26.  
  27.     By using this program, you state your agreemnet to the above terms,
  28.     warranties and conditions.
  29.  
  30.   ┌─────────────┐
  31.   │WHAT IT DOES:│
  32.   └─────────────┘
  33.   RALDUMP reads the specified language file, and dumps it to a formatted
  34.   text file, which you may then view or print.
  35.   If you are wanting to find a specified prompt, and you cannot remember
  36.   what the text is, the RALDUMP file will ease your search somewhat.
  37.  
  38.   It would be a good idea to create a Dump of the standard ENGLISH file, to
  39.   reference your custom files with.
  40.  
  41.   RALDUMP does NOT modify your language file, only reads it.
  42.  
  43.   The program has been tested on RA ver 1.11 and 2.0 language files.
  44.   It will probably work on earlier versions, but not tested.
  45.  
  46.   ┌────────────┐
  47.   │LIST FORMAT:│
  48.   └────────────┘
  49.   The format of the output is as such:
  50.  
  51.   Prompt Number - Hot Keys - Prompt Color - Prompt Text
  52.   Example....
  53.  
  54.   603. [YN=TVE] (10) More(Y/n/=/(T)ag/(V)iew/(E)dit)? 
  55.  
  56.   This is prompt # 603
  57.   Hotkeys are displayed in square brackets []
  58.   Prompt color, displayed in parantheses is (10) "bright green"
  59.   And then the text.
  60.  
  61.   If a color has not been specified for the prompt, RALDUMP will show it as
  62.   zero (0).
  63.  
  64.   If a prompt text is not defined, RALDUMP will write a message entry to
  65.   that fact, for that prompt's text.
  66.  
  67.   NOTE: Prompt #0 is always the File "Title", be it the default, from when
  68.   the RAL file format was originaly created, or one that has been modified
  69.   by you or another, to reflect the NEW/MODIFIED language file.
  70.  
  71.   ┌────────────────┐
  72.   │RUNNING RALDUMP:│
  73.   └────────────────┘
  74.   Simple.....  RALDUMP <RAL_file>
  75.  
  76.   If you do not specify a language file, ENGLISH.RAL is processed.
  77.   If you do not supply the extension .RAL with the filename, RALDUMP will
  78.   add the proper extension, thus RALDUMP english, is a proper command.
  79.  
  80.   The Language File dump, will be given the same name as the language file,
  81.   with the extension of .LST.
  82.  
  83.   RALDUMP cowpoke, will result in COWPOKE.LST
  84.  
  85.   BTW: COWPOKE.RAL was developed here at RaLin, and seems to be enjoying
  86.   some popularity!
  87.  
  88.   If RALDUMP cannot find the specified file, it will abort with an error.
  89.  
  90.   When the program starts, it clears the screen, displays a Program Title
  91.   and Copyright Notice, then displays a message telling what file its
  92.   dumping to what list, as such:  Dumping COWPOKE.RAL => COWPOKE.LST
  93.  
  94.   RALDUMP is pretty quick, it does not use a buffers for writing, but still
  95.   does not take long. On a 486/33 with a fairly fast disk, it takes about
  96.   1/2 second to dump the file to a list.
  97.   On a slower XT system, it may take up to a minute. Usually less.
  98.  
  99.   ┌────────────────┐
  100.   │LANG/FILE FORMAT│
  101.   └────────────────┘
  102.  
  103.   If your language file has any undefined prompts, the resulting list entry
  104.   for that prompt, "may" be a little out of position. This is not a problem
  105.   for viewing, but should you wish to print the list, it may result in a
  106.   wrapped line, which will look bad.
  107.  
  108.   This usually only happens in the newer RAL files, 2.0+ where the PRO
  109.   version prompts have not been filled in. Somewhere up on the 500 number
  110.   range.
  111.  
  112.   You can either edit the list and remove the leading blanks in those lines,
  113.   or, what I reccomend, fire up RACONFIG and edit the Language text, and on
  114.   blank prompts, press ALT-D to assign the DEFAULT prompt. Then save the
  115.   file.
  116.  
  117.   ┌────────┐
  118.   │SUPPORT │
  119.   └────────┘
  120.  
  121.     Questions may be directed to the author, Rand Nowell, via the following:
  122.  
  123.     Net Mail - 1:161/710 - PVT, you can modifiy FDNODE.CTL to call by
  124.     inserting the line PHONE 1:161/710 1-510-651-0253,,3322 then recompile
  125.     the nodelist.
  126.     The commas represent a required 4 second pause, then send code.
  127.  
  128.     BBS: The RaLin BBS, same number as Net Mail.
  129.  
  130.     VOICE: 1-510-651-0253  - RaLin Enterprises... Fremont, Ca.
  131.  
  132.     FIDO ECHOS:  Shareware - RA_UTIL - RA_SUPPORT
  133.  
  134.     Snail Mail:     Rand Nowell
  135.                     RaLin Enterprises
  136.                     40728 Sundale Dr.
  137.                     Fremont, Ca. 94538
  138.    ┌─────┐
  139.    │KUDOS│
  140.    └─────┘
  141.      Code for accessing the Remote Access language file was derived from
  142.      Public Domain source, released by P.H. Hankin Hansen, AKA Ping Hansen,
  143.      code released into PD Feb-24-1992
  144.  
  145.      RemoteAccess BBS software, the RemoteAccess Language File Format,
  146.      Copyright Andrew Milner - Wantree Software.
  147.  
  148.      RALDUMP compiled under Turbo Pascal v7.0
  149.  
  150.