home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / fn132bin / conv / conv33d.doc < prev    next >
Text File  |  1991-09-02  |  6KB  |  125 lines

  1.  
  2.  Documentation for the STadel 3.3d to Fnordadel converter:
  3.  -----------------------------------------------------------
  4.  
  5.  [ Since conv33d.tos is a use-it-once, throw-it-away hack, I figure a nice
  6.    neat man page is a waste of time too, so here goes...  --aa ]
  7.  
  8.  What The Program Is For:
  9.  ------------------------
  10.  
  11.  Conv33d.tos will take an STadel 3.3d system and convert its data files
  12.  to formats acceptable to Fnordadel.  If you're using some other version
  13.  of STadel:
  14.  
  15.     o If it's 3.4a, then conv33d may work; if it doesn't, we can
  16.       probably arrange to hack it a bit to make it work.  I don't
  17.       know if 3.4a ever saw the light of day, so it may be that
  18.       nobody has a system running it.
  19.  
  20.     o If it's something else, then conv33d will almost certainly NOT
  21.       work.  If you're in this position, you can either (A) Find a
  22.       copy of an STadel 3.3d distribution and run whatever conversion
  23.       programs were in there to take users of previous versions up
  24.       to 3.3d, and THEN run conv33d, or (B) Beg and plead with us and
  25.       we'll see what, if anything, can be done.
  26.  
  27.  PLEASE NOTE:  You must use the version of conv33d that came with whatever
  28.  version of Fnordadel you'll be using; if data files have changed between
  29.  Fnordadel revisions (as often happens) then using a converter from a
  30.  different version of Fnordadel isn't going to help you very much.
  31.  
  32.  
  33.  Stuff You Must Do First:
  34.  -----------------------
  35.  
  36.  1) MAKE BACKUPS.  Conv33d munches on your BBS, and although it was well
  37.     behaved when I tested it, one never knows...
  38.  
  39.  2) Place a copy of conv33d.tos in the directory which contains the
  40.     ctdltabl.sys file from your STadel system.  Conv33d expects to be run
  41.     from this directory, just like all the normal STadel programs.
  42.  
  43.  THEN:
  44.  ----
  45.  
  46.  3) Run conv33d by double-clicking or, if you're a winner and use a shell,
  47.     by typing 'conv33d'.  The program will munch your sysfiles, producing
  48.     lots of noise.  Make sure that none of the noise looks threatening.
  49.  
  50.     When it's finished, it will have done the following in your #sysdir:
  51.  
  52.     o The STadel rooms file, 'ctdlroom.sys', will be renamed to
  53.       'ctdlroom.33d' and in its place will be the Fnordadel room
  54.       files, one per room, named "roomnnnn.sys" where 'nnnn' is a
  55.       number from 0000 to 0063.
  56.  
  57.     o The STadel log file, 'ctdllog.sys' will be replaced with the
  58.       new Fnordadel one; the old one will be renamed to
  59.       'ctdllog.33d'.  The new one will be slightly smaller.
  60.  
  61.     o The STadel floors file, 'ctdlflr.sys' will be replaced with
  62.       the new Fnordadel one; the old one is left as 'ctdlflr.33d'.
  63.       The new one will be slightly smaller.
  64.  
  65.     And the following will have happened in #netdir:
  66.  
  67.     o The STadel net list, 'ctdlnet.sys', will be replaced with the
  68.       new Fnordadel one, and the old one will be renamed to
  69.       'ctdlnet.33d'.  The new one should be a bit smaller.
  70.  
  71.  
  72.  Stuff You Must Do Afterwards:
  73.  -----------------------------
  74.  
  75.  4) You should delete the file "ctdlloop.zap" from your #netdir, if it
  76.     exists.  This file contains the data for the loop-zapper; Fnordadel
  77.     uses a different format for this data than does STadel.  If you wish
  78.     to recreate a loop-zapper database from your existing message base,
  79.     you can use the Fnordadel utility "makezt.tos"; refer to makezt.man
  80.     for details.  Otherwise you can just let the loop-zapper rebuild itself
  81.     over time.
  82.  
  83.  5) You MUST MUST MUST edit ctdlcnfg.sys!  Many things are different, so
  84.     the best idea is usually to print out a copy of your old ctdlcnfg.sys
  85.     file from your STadel system, or keep it in a second editor buffer,
  86.     for reference while you edit a copy of the Fnordadel ctdlcnfg.sys
  87.     file.  A fully commented version is distributed as "ctdlcnfg.doc".
  88.  
  89.     Please note especially that you MUST define the ctdlcnfg.sys variables
  90.     "maxrooms", "mailslots" and "sharedrooms" as 64, 58 and 16 respectively.
  91.     These values were fixed under STadel; they may be edited to anything
  92.     you like under Fnordadel, but since you already have a running system
  93.     based on those values (64, 58, and 16), you must use one of the
  94.     supplied utilities to change any of these values.  Do NOT simply edit
  95.     one of these values in ctdlcnfg.sys and attempt to reconfigure; it will
  96.     cause a rude message from configur at best, chaos at worst.
  97.  
  98.  6) You must delete your old ctdltabl.sys file, and then run the
  99.     Fnordadel configur.tos program to generate a new ctdltabl.sys.
  100.  
  101.  BE VERY CAREFUL not to mix up STadel and Fnordadel binaries!  Best thing
  102.  to do is nuke the old STadel ones and move the Fnordadel ones into their
  103.  places.
  104.  
  105.  Other Random Stuff You Should Do or Know:
  106.  -----------------------------------------
  107.  
  108.  o Your STadel help files directory should be replaced wholesale with the
  109.    Fnordadel help files.  A few files will need editing (some .blb files,
  110.    localbbs.hlp, and so on) and you can probably keep some of your old .blbs.
  111.  
  112.  o You should go through the net list and make sure that everything is as
  113.    you think you left it; maybe edit each of the nodes to make sure that
  114.    all is well.  For all systems in your net list who run Citadel-86 or
  115.    a direct variant (i.e. Citadel-68k for the Amiga), you should toggle
  116.    the "C-86" flag in their net entries; this is done by editing the node
  117.    and typing 'T'.  This helps Fnordadel network better with such systems.
  118.  
  119.  
  120.  If you have any problems with the conversion process or with the Fnordadel
  121.  system after conversion, drop us a line and we'll try to help.
  122.  
  123.     -Adrian Ashley (elim @ secret)
  124.      Royce Howland (Mr. Neutron @ RT)
  125.