home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / XBBS_118.ZIP / DOCS.ZIP / NEWCMDS.DOC < prev    next >
Encoding:
Text File  |  1992-03-21  |  11.7 KB  |  372 lines
  1. New commands:
  2.  
  3. @GG/A/S   ANSI-only top-line input
  4. ==================================
  5.  
  6. Syntax:
  7.  
  8. @GG<prompt,option 1,option 2,option3,...,option n>EOL
  9.   or
  10. @GG@<varnum>EOL
  11.  
  12.   Performs special ANSI-only top-line input.  Returns selected option
  13.   number in errorlevel.  0 indicates an abort (by ESCape or CTRL-K).
  14.  
  15.  Example:
  16.  
  17.     @GGRead msgs,Write msgs,Quit to Main
  18.  
  19. @GA<prompt,option 1,option 2,option3,...,option n>EOL
  20.   or
  21. @GA@<varnum>EOL
  22.   Performs rolling or top-line menu depending on user's settings.
  23.  
  24. @GS<number>
  25.   Set color for above to <number>
  26.  
  27.  
  28.  
  29. @^X<option>
  30. ===========
  31.  
  32. Invoke an automatic mode.  Possible values for <option>:
  33.  
  34. B...Bulls
  35. C...Configure user
  36. D...Doors
  37. F...Files
  38. f...File area list/pick
  39. L...Library
  40. M...Macros
  41. m...Message area list/pick
  42. N...Scan nodelist
  43. n...News
  44. S...Select a file (must follow with var num, directory and mask)
  45.     Example:  @^X0c:\files *.txt
  46. V...View archive (must follow with filename, d/l path assumed if none given)
  47. X...Ijit
  48. x...Ijit w/ pulldown menus
  49.  
  50. Note XBBS' Ijit defaults are used in all cases where defaults are
  51. applicable, except for Library and News which will accept the name
  52. of the directory (including trailing backslash) following, and file
  53. and message area list/pick:
  54.  @m<optional msgareas.xbs-style file filename>
  55.  @f<mandatory security level #, 0-9><optional flsearch.ctl-style file filename>
  56.  
  57.  
  58.  
  59. @^W   Escape ^a's
  60. =================
  61.  
  62. Escapes ^a's so they can be displayed if necessary
  63.  
  64.  
  65.  
  66.  
  67.  
  68. Revised commands:
  69.  
  70. @I   Scan nodelist
  71. ==================
  72.  
  73. Syntax:
  74.  
  75. @I<partial or complete address>
  76.  
  77. If the address is zone:0, all hosts (0-nodes) in the net will be listed.
  78. If the address is zone:net, all nodes in the net will be listed.  More
  79. than that and only one node gets listed.  All this assumes the nodes are
  80. there to be found and listed, of course...
  81.  
  82.  
  83. @'  @[  @{  @G
  84. ==============
  85.  
  86. The colors for these commands are now the same as those used for the *+
  87. metastring (see discussion below) instead of ANSI numbers.
  88.  
  89.  
  90.  
  91.  
  92.  
  93. Extended commands:
  94.  
  95. @||   Free hypertext buffers
  96. ============================
  97.  
  98. Frees some of the memory associated with a previously used hypertext
  99. file.  @|<anything else> invokes hypertext as usual.
  100.  
  101.  
  102.  
  103. @V    Variables
  104. ===============
  105.  
  106. Named variables (see *{ and @e=$<variable name>)
  107.        Assignment:
  108.         @VA<variable name>=<string>
  109.         @Va<variable name>=<converted string>
  110.        Delete variable:
  111.         @VD<variable name>
  112.        Free (remove) all variables:
  113.         @VF
  114.        Print variable:
  115.         @VP     (Unconverted)
  116.         @Vp     (converted)
  117.        Save variables:*
  118.         @Vk<filename>
  119.        Load variables:*
  120.         @VK<filename>
  121.  
  122.        Notes: Named variables must use only alpha and/or numeric
  123.               characters.
  124.               Internal errorlevel is set accordingly:
  125.                  NOERR       0           's cool, m'man
  126.                  NOVARS      1           No variables
  127.                  NOTVAR      2           Name given isn't a variable
  128.                  NOMEM       3           Out of memory
  129.                  NOFILE      4           Can't read, write or open a file
  130.                  SYNTAX      5           Syntax error
  131.                  IDIOT       65535
  132.  
  133.        * Saves and retrieves ALL variables: named, 0-9 and stored
  134.          errorlevels.  0-9 and stored errorlevels are overwritten
  135.          when loaded, as are existing named variables.  Nonexistent
  136.          named variables are created.  .VAR extension added to
  137.          <filename>.  <filename>.VAR is deleted before saving if it
  138.          exists.  You'll probably want to kill *.VAR during your recycle
  139.          batch. This can be used as a method to quickly preload
  140.          variables, or to store them before a restart. These commands
  141.          are new.
  142.  
  143.  
  144.  
  145.  
  146. New XBBS.TXT preceding char "commands":
  147. ======================================
  148.  
  149. ASCII 29 
  150.  
  151. Converts metastrings, is removed from front of line, then line continues
  152. to be processed for other preceding char "commands."  To get an idea how
  153. this might be of use, take a look at the filename passed back to XBBS
  154. from XBBS.TXT line #9.
  155.  
  156.  
  157. ASCII 30 
  158.  
  159. Line is not used if user does NOT have fancy menus turned on.
  160.  
  161.  
  162. ASCII 31 
  163.  
  164. Line is not used if user DOES have fancy menus turned on.
  165.  
  166.  
  167.  
  168.  
  169. New metastrings:
  170. ===============
  171.  
  172. *`
  173.  
  174. Metastrings have evolved past what they were originally intended for
  175. (parameter passing on command lines).  *` will be replaced by an
  176. asterick to allow "escaping."
  177.  
  178. *+number+
  179.  
  180. Converts number to an ANSI escape sequence if the user has his/her
  181. graphics bit on.  The number is the same as attributes used by IBM
  182. PCs:
  183.  
  184.    bit value:   (128)(64)(32)(16)(8) (4) (2) (1)
  185.                  ---  --  --  --  -   -   -   -
  186.    bit:           7   6   5   4   3   2   1   0
  187.                   -   -   -   -   -   -   -   -
  188.                   |   |       |   |   |       |
  189.                   |   |       |   |   |       |
  190.                   |   +---+---+   |   +---+---+
  191.                   |       |       |       |
  192.                   |       |       |   text color
  193.                   |       |       |
  194.                   |       |     bright text
  195.                   |       |
  196.                   |    background color
  197.                   |
  198.                 blink
  199.  
  200. Three bits can contain the numbers 0 to 7.  Here are what those values
  201. mean:
  202.  
  203.  0      black
  204.  1      blue
  205.  2      green
  206.  3      cyan
  207.  4      red
  208.  5      magenta
  209.  6      brown
  210.  7      gray  (i.e. non-intense white)
  211.  
  212. As an example, *+7+ sets the current text attribute to light grey text on
  213. a black background, and *+15+ sets the current text attribute to white
  214. text on a black background (or, more correctly, puts the ANSI sequence to
  215. accomplish that into the converted string if the user has his/her graphics
  216. bit on).
  217.  
  218. Add 256 to the attribute value to cause the screen to be cleared after
  219. the text attribute is set.
  220.  
  221. I've converted most of the coloring system to something that'll be easily
  222. compatible with Avatar, in case you were wondering...
  223.  
  224.  
  225.  
  226.  
  227. Revised metastrings:
  228. ===================
  229.  
  230. *{Variablename}
  231.  
  232. Now accepts the closing brace to indicate the end of a named variable.
  233. Variable lookup should be much faster, BTW.
  234.  
  235.  
  236.  
  237.  
  238. More special files:
  239. ==================
  240.  
  241. IJITHELP.XBS  Read if available when help requested in Ijit mode.
  242. XLOGOFF.XBS   Read if available when logoff selected from Ijit mode.
  243. MACROS.XBS    Read if available when macros selected from Ijit mode.
  244. NEWS.XBS      Read if available when news selected from Ijit mode.
  245. LIBRARY.XBS   Read if available when library selected from Ijit mode.
  246. LISTUSER.XBS  Read if available when userlist selected from Ijit mode.
  247. MACRO###.XBS  Read when extra command selected in macro mode.
  248. NEWS###.XBS   Read when extra command selected in news mode.
  249. LIBRY###.XBS  Read when extra command selected in library mode.
  250.  
  251.  
  252.  
  253. New command line arguments:
  254. ==========================
  255.  
  256. -M  On initial logon you can specifiy another parameter after the
  257.     nodenumber parameter:  multitasker # (0 = none, DesqView = 1,
  258.     DoubleDos = 2, MOS = 3, TV = 4, OS/2 = 5).  Some folks have had
  259.     trouble with DesqView timeslicing, so this lets you turn it off.  If
  260.     restarting with -R use -M#.  BTW, did you know that on initial logon
  261.     extra command line parameters are copied into the internal variables
  262.     0-9?
  263.  
  264. -W  You can start XBBS with the -W<nodenumber> argument to have it wait
  265.     for a caller.  At this time there are no provisions for events.
  266.     Exits from the wait-for-call state (via local ESCape or horrible
  267.     error, like no FOSSIL) are at errorlevel 252.
  268.  
  269.  
  270.  
  271.  
  272. New control file:
  273. ================
  274.  
  275. NOTIFY.CTL can contain names of people that you want XBBS to notify you
  276. about when they log on.  XBBS will read (by default) NOTIFY.XBS when they
  277. are detected.  A NOTIFY.CTL line has the following format (there may be
  278. multiple lines):
  279.  
  280.  User Name[,Q!][,File-to-read]<crlf>
  281.  
  282. Q!, if present, tells XBBS not to tell the user that you're being
  283. notified.  File-to-read is the name of an alternate .XBS file to read
  284. (instead of NOTIFY.XBS).  Note that if both Q! and file-to-read are
  285. included, they must be in the order shown.
  286.  
  287.  
  288.  
  289.  
  290. Miscellaneous:
  291. =============
  292.  
  293. This should time-slice for most multitaskers.
  294.  
  295. CTRL_HOME instead of HOME for sysop help prompt.
  296. CTRL_END instead of END for changing status line.
  297. HOME and END are free for local use.
  298.  
  299. F#.XBS, AF#.XBS, CF#.XBS and SF#.XBS files now.
  300.  
  301. Changed the nodelist format from QBBS to version 6 and significantly
  302. sped up nodelist lookups, still without loading the index into RAM.  I
  303. originally implemented the QBBS-style nodelist to ensure that at least
  304. one other program was using it.  There are now enough QBBS-clones around
  305. to take care of that.  This moves XBBS to be compatible with HeadEdit
  306. 1.19.
  307.  
  308. Netmail message entry has been simplified.  XBBS will support however
  309. many lines you care to run your BBS at (25,43,50,60), decrease memory
  310. required by text compression and decompression, and fix a few bugs, add
  311. a few things that got left out over the years, and improve some rough
  312. appearances in the automatic modes.
  313.  
  314. More "internationalization" has been added; you can define, in XBBS.TXT,
  315. things like what letters to use for YES and NO responses.
  316.  
  317. More sysop-friendliness.  For instance, when you update your XBBS.TXT
  318. and forget to reindex it, XBBS will now notice and run INDEXER for you.
  319. Don't do it anyway.  :-)  Added some logged warnings to XBBS.TXT to help
  320. in debugging; mainly of use to new sysops.  %% on blank line allowed for
  321. quote "separator" in quote file (the ?nix way, all hail).
  322.  
  323. Colors are configurable in most places; search XBBS.TXT for the word
  324. "color."  XBBS can now color quotes, kludges, tears and origins for
  325. you.
  326.  
  327. New command line argument when restarting with -R.  -D tells XBBS it's
  328. running as a Door, so it doesn't automatically drop DTR when exiting
  329. (though you can still tell it to do so in a .XBS file).
  330.  
  331. Ijit mode refined.  In fact there are two distinctly different
  332. interfaces now available to the users.
  333.  
  334. True global downloading with protocols that support "use @list".
  335. Downloading from the end-of-page prompt for ANSI users.  Downloading
  336. from a list.
  337.  
  338. The most important thing this version does is introduce more portable
  339. code for you hackers (in the good sense) out there to play with.
  340.  
  341.  
  342. Caveats:
  343. =======
  344.  
  345. This is still beta, so you might not want to trash all your old files
  346. yet...  Not all the utilties have been ported (config file changes a
  347. little), but I think I got all the important ones.  Notice that although
  348. QWK export is supported, there's no import utility.  I don't want to be
  349. the one who gets blamed with that...
  350.  
  351. Be sure to run the new XConfig, and there are a quite few prompts that
  352. were added to, deleted from or changed in XBBS.TXT, but naturally I
  353. didn't write them down.
  354.  
  355. As always, LOGON0.EXE is the overlaid version and LOGON0NO.EXE is the
  356. non-overlaid version.  LOGON0's memory profile should allow it to run in
  357. 200K partitions in a pinch.  The usual caveats regarding braindead
  358. overlay managers apply.  Thought I'd mention: be sure you move the old
  359. overlaid version off your PATH before running the new one; lockups are
  360. sure if it starts loading overlays from the wrong file.  *This has
  361. happened to more than a few people; check it if you get lockups!*
  362.  
  363. Be sure your recycle batch file deletes any leftover USERINFO.XB? files.
  364. Something that didn't work before works now; if a USERINFO.XB? file for
  365. the current node is found lying around, XBBS gets the username out of it
  366. and only asks for a password.  It's to make it easier to use XBBS as a
  367. Door from another BBS, but to be honest it's easier to use XLOG.
  368.  
  369.  
  370.  
  371. Mark
  372.