home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / golded / install.doc < prev    next >
Encoding:
Text File  |  1993-11-14  |  4.6 KB  |  113 lines
  1. ----------------------------------------------------------------------
  2. INSTALL.DOC                              How to install/upgrade GoldED
  3. ----------------------------------------------------------------------
  4.  
  5.  
  6. ----------------------------------------------------------------------
  7. First time, simple install:
  8. ----------------------------------------------------------------------
  9.  
  10. 1. Edit GOLDED.CFG to match your setup. (Use the AREAFILE's!)
  11. 2. Run GOLDNODE.EXE if you want nodelist lookup.
  12. 3. Run GOLDED.EXE.
  13.  
  14.  
  15. ----------------------------------------------------------------------
  16. First time, advanced (not for the fainthearted!):
  17. ----------------------------------------------------------------------
  18.  
  19. 1. Unpack ADVANCED.ARJ & XLAT.ARJ. Rename ADVANCED.CFG to GOLDED.CFG.
  20. 2. Edit GOLDED.CFG and GOLDAREA.CFG to match your setup.
  21. 3. Run GOLDNODE.EXE if you want nodelist lookup.
  22. 4. Run GOLDED.EXE.
  23. 5. Repeat 2. through 4. until it works ;-)
  24.  
  25.  
  26. ----------------------------------------------------------------------
  27. Upgrading, in general:
  28. ----------------------------------------------------------------------
  29.  
  30. Please keep a copy of your old version in a safe place, just in case.
  31.  
  32. You should always install the new version in a new directory, instead
  33. of on top of the old setup.
  34.  
  35. Setup a fresh simple config first, and verify that everything works
  36. okay. Then transfer your old configs to the new version, editing where
  37. it may be nescessary.
  38.  
  39. Check if you have set the GOLDED environment variable, if you are
  40. installing and testing the new version in a different directory.
  41.  
  42.  
  43. ----------------------------------------------------------------------
  44. Upgrading from 2.40 to 2.41
  45. ----------------------------------------------------------------------
  46.  
  47. The GoldED 2.41 exe files should be drop-in-able. I say "should" only
  48. because I haven't tried it myself. Read the manual addendum for a list
  49. of the new/changed keywords you can use in the configuration files.
  50.  
  51. The GRAND101.ARJ (cookie compiler utility for registered users) is no
  52. longer required for the cookie (template @random) feature. That
  53. functionality is now built-in using the COOKIEFILE keyword.
  54.  
  55.  
  56. ----------------------------------------------------------------------
  57. Upgrading from 2.30/2.31/2.31p to 2.40
  58. ----------------------------------------------------------------------
  59.  
  60. You are highly recommended to start over from scratch, using the new
  61. example configuration files. While 2.40 is generally backward com-
  62. patible to 2.30/2.31, there are *a lot* of new features and changes.
  63.  
  64. Most of the configuration files have been given more consistent names:
  65.  
  66. Rename: GOLDED.ARE to GOLDAREA.CFG  (also in GOLDED.CFG if INCLUDE'd)
  67. Rename: GOLDED.HLP to GOLDHELP.CFG
  68. Rename: GOLDED.KEY to GOLDKEYS.CFG
  69. Rename: GOLDED.LNG to GOLDLANG.CFG
  70. Rename: GOLDED.RAN to GOLDRAND.CFG  (but see note later !!!)
  71. Rename: COLOR*.COL to GEDCOL*.CFG   (also in GOLDED.CFG if INCLUDE'd)
  72. Rename: MONO*.COL  to GEDMON*.CFG   (also in GOLDED.CFG if INCLUDE'd)
  73.  
  74. Delete: GOLDED.DAT, GOLDED.HLX, GOLDED.KBD, GOLDED.LNX, GOLDED.RLN,
  75.         GOLDED.RDX, *.ESX, *.CHX and GOLDLANG.EXE.
  76.  
  77. In this new naming scheme, all compiled config files have the
  78. extension .GED. This makes it easy to identify which files can be
  79. safely deleted.
  80.  
  81. NOTE: The Random System no longer accepts the old syntax. Please see
  82. the example GOLDRAND.CFG and GOLDED.DOC for details on the new format.
  83.  
  84. Many configuration keywords have been renamed to more a consistent
  85. naming scheme. The old keywords will still be supported for a couple
  86. of versions more... GOLDED.DOC has a list of the old versus the new
  87. names, as well as a complete reference of all valid keywords.
  88.  
  89. Some keywords are no longer supported. Just remove them from the
  90. relevant .CFG when GoldED reports them.
  91.  
  92. The syntax of the CHARSET/ESCSET keywords have changed slightly: The
  93. filename extensions stated in GOLDED.CFG should now be .CHS instead of
  94. .CHX and .ESC instead of .ESX.
  95.  
  96. The @cookie template token is renamed to @random, and the default
  97. filenames are now RANDOM.*. The cookie/random file compiler
  98. (GOLDRAND.EXE) is not distributed in the archive, and this feature is
  99. generally undocumented. GOLDRAND.EXE is distributed separately in the
  100. archive GRAND101.ARJ (12k).
  101.  
  102. The external configuration compiler, GOLDLANG.EXE is now built-in.
  103.  
  104.  
  105. ----------------------------------------------------------------------
  106. Upgrading from 2.20 and earlier:
  107. ----------------------------------------------------------------------
  108.  
  109. Backup your old version and start from scratch with the new one :-)
  110.  
  111.  
  112. ----------------------------------------------------------------------
  113.