home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / mtlk0920.lha / ASI / doc / MTalkEditor.doc < prev   
Text File  |  1992-06-14  |  4KB  |  103 lines
  1. =====================================================================
  2. NOTE1: Please read MTalk.doc before this file.
  3. NOTE2: Copyright notices and disclaimer are same as that of MTalk.doc
  4. =====================================================================
  5.  
  6. =====================================================================
  7. INTRODUCTION
  8. ============
  9.  
  10. MTalkEditor is an editor for Multi-Talk's built-in command user
  11. levels, as well as door utilities.  On future versions, other things
  12. will be editable with this editor, such as logging ("/log") specific
  13. activities.
  14.  
  15.  
  16. =====================================================================
  17. INSTALLATION
  18. ============
  19.  
  20. MTalkEditor should be put in DOOR:ASI/bin/.  It will manipulate
  21. DOOR:ASI/config/MTalk.LVLTAB and DOOR:ASI/config/MTalk.DOORTAB.
  22.  
  23.  
  24. =====================================================================
  25. LIMITATIONS
  26. ===========
  27.  
  28. Door names are limited to 16 characters (including null).  The
  29. command line length for a door must be limited to 128 (including
  30. null).  The user levels must be between 0 and 32767.  Currently, only
  31. 30 doors are allowed to be configured.  If 30 is too little for you,
  32. you can make several door files and concatenate them (eg. "join
  33. <file1> <file2> ... as DOOR:ASI/config/MTalk.DOORTAB").
  34.  
  35.  
  36. =====================================================================
  37. USER MANUAL
  38. ===========
  39.  
  40. To start, simply type "MtalkEditor" inside DOOR:ASI/bin/, unless you
  41. have that directory already pathed.  Now you should see the main menu.
  42. The options are:
  43. [C] Edit Built-in Command Levels      [D] Edit Door Commands
  44. [Q] Quit                              [?] Display This Menu
  45.  
  46. Edit Built-in Command Levels
  47. ----------------------------
  48. After pressing [C] you will be asked to enter user levels for each
  49. command.  By default, all SYSOP commands are level 255, while others
  50. are level 0.  Press control-C when you want to abort the editing
  51. process.
  52.  
  53. Edit Door Commands
  54. ------------------
  55. After pressing [D] you will be asked to enter data for each door
  56. command.  Items you will be asked are:
  57. 1. Name of the door command
  58. 2. User level to access that door
  59. 3. DOS command to execute for the door.
  60.  
  61. Enter a blank line on a door name to delete that door.  Press
  62. control-C anytime to break.  The only item that requires great
  63. attention is item 3.  Arguments to pass to the door command can be
  64. achieve in two ways:
  65. 1. Pass from MTalk's command line arguments
  66. 2. Pass from the user's conference command line.
  67.  
  68. Example:
  69.  
  70. Enter door name => page
  71. Enter door user level => 0
  72. Enter door command line => DOOR:ASI/bin/TelePage $NAME $0 $1+
  73.  
  74. Let's suppose MTalk had been invoked by "MTalk NAME John".
  75. Let's suppose further that John had typed the following on his
  76. command line:
  77. John> /page Bob This is a test...
  78.  
  79. The command "DOOR:ASI/bin/TelePage $NAME $0 $1+" will be translated
  80. to "DOOR:ASI/bin/TelePage John Bob This is a test..."
  81.  
  82. The "$" symbol introduces a variable or an conference command line
  83. argument.  They are defined as follows:
  84. $<variable> - will simply be replaced with <variable>'s actual value.
  85.               This is passed as an argument when executing MTalk.
  86.               For example, $NAME is a variable, $LEVEL is a variable,
  87.               but $10 is not.
  88. $<num> - will be replaced with argument number <num> of the user's
  89.          command line.
  90. $<num>+ - will be replace with arguments from the user's command
  91.           line starting at <num>.
  92.  
  93. Note that internal environment variables will not replace $<variable>.
  94. That is, only ones that are included when executing MTalk are passed
  95. to the doors.  These values must be passed by executing MTalk.
  96. User's command line arguments start at 0.
  97.  
  98. Quit
  99. ----
  100. Any change you have made you will be asked if you want to save them.
  101. Press return or type "y" to save, or "n" otherwise.
  102.  
  103.