home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1998 September / PCO_0998.ISO / filesbbs / dos / sbbs230b.exe / DOCS.LZH / BAJA_200.NEW < prev    next >
Encoding:
Text File  |  1995-08-31  |  15.9 KB  |  333 lines

  1. New features added in Baja Version 2
  2. ====================================
  3.  
  4. o Integer constants can be delcared as specific bit values (.x)
  5. o Integer contsants can be modified during compilation (345*12)
  6. o Compiler supports C-like macros (!define) for pre-processor definition of
  7.         integer and string constants
  8. o Compiler supports multi-file projects using a C-like pre-processor directive
  9.         (!include) for combining multiple source/include files
  10. o Enhanced functions:
  11.         SHIFT_STR [str_var] <#>
  12.                 Can shift any string variable (not just str)
  13.         SETLOGIC <TRUE or FALSE or GREATER or LESS>
  14.                 Supports new GREATER and LESS logic states
  15.         PRINT <"str" or any_var>
  16.                 Can print any variable as well as string constants
  17.         CHKFILE <"str" or str_var>
  18.                 Can check for file specified by string constant or variable
  19.         COMPARE_KEY <key>
  20.                 Now supports DIGIT, EDIGIT, ^x, and /x like CMDKEY
  21.         COMPARE_ARS <ars>
  22.                 Now supports WIP (Windows Interface Protocol) keyword
  23.         COMPARE_USER_MISC <attrs>
  24.                 and
  25.         TOGGLE_USER_MISC  <attrs>
  26.                 Now support WIP (Windows Interface Protocol) attribute
  27.         PRINTFILE <"str" or str_var> [mode]
  28.                 Optional mode (one or more):
  29.                         NOABORT   Disallows abortion of display with Ctrl-C
  30.                         SAVEATR   Retain attributes (colors) after display
  31.                         NOATCODES Don't expand @-code variables/actions
  32.                         OPENCLOSE Open and close immediately (before display)
  33.         GETSTR [str_var] [maxlen] [mode]
  34.                 Can read into any string variable (not just str)
  35.                 Optional mode (one or more):
  36.                         UPPER     Converts all letters to upper case
  37.                         UPRLWR    Upper/Lower case automatically
  38.                         NUMBER    Allow numbers only
  39.                         WRAP      Allows word wrap
  40.                         MSG       Allows ANSI, ^N ^A ^G
  41.                         SPIN      Spinning cursor
  42.                         LINE      Input line (inverse color)
  43.                         EDIT      Edit string passed
  44.                         NOCRLF    Don't print CRLF after string input
  45.                         ALPHA     Only allow alphabetic characters
  46.                         LOWPRIO   low priority input
  47.                         NOEXASC   No extended ASCII allowed
  48.                         E71DETECT Detect E-7-1 terminal type
  49.                         AUTODEL   Auto-delete text (used with EDIT)
  50.             NOECHO      Don't echo input to local or remote console
  51.         GETNUM [any_var] <#>
  52.                 Writes to any variable (not just str)
  53.         NODE_ACTION <action or #>
  54.                 Supported actions:
  55.                         MAIN    Main Prompt
  56.                         RMSG    Reading Messages
  57.                         RMAL    Reading Mail
  58.                         SMAL    Sending Mail
  59.                         RTXT    Reading G-Files
  60.                         RSML    Reading Sent Mail
  61.                         PMSG    Posting Message
  62.                         AMSG    Auto-message
  63.                         XTRN    Running External Program
  64.                         DFLT    Main Defaults Section
  65.                         XFER    Transfer Prompt
  66.                         DLNG    Downloading File
  67.                         ULNG    Uploading File
  68.                         BXFR    Bidirectional Transfer
  69.                         LFIL    Listing Files
  70.                         LOGN    Logging on
  71.                         LCHT    In Local Chat with Sysop
  72.                         MCHT    In Multi-Chat with Other Nodes
  73.                         GCHT    In Local Chat with Guru
  74.                         CHAT    In Chat Section
  75.                         SYSP    Sysop Activity
  76.                         TQWK    Transferring QWK packet
  77.                         PCHT    In Private Chat
  78.                         PAGE    Paging another node for Private Chat
  79.                         RFSD    Retrieving file from seq dev (aux=dev)
  80. o New String Manipulation functions:
  81.         STR <str_var> [str_var] [...]
  82.                 Define local string variable(s)
  83.         GLOBAL_STR <str_var> [str_var] [...]
  84.                 Define global string variable(s)
  85.         SET <str_var> <"str">
  86.                 Initialize string variable
  87.         COPY <str_var> <any_var>
  88.                 Copy from any variable to a string variable
  89.         SWAP <str_var> <any_var>
  90.                 Swap contents of any variable with string variable
  91.         STRCAT <str_var> <str_var or "str">
  92.                 Append string variable or constant to end of string variable
  93.         SPRINTF <str_var> <"str"> <any_var> [any_var] [...]
  94.                 Write text and formated variables to string variable
  95.         TIME_STR <str_var> <int_var>
  96.                 Convert time integer variable to date/time string
  97.         DATE_STR <str_var> <int_var>
  98.                 Convert time integer variable to MM/DD/YY string
  99.         SECOND_STR <str_var> <int_var>
  100.                 Convert time integer variable to HH:MM:SS string
  101.         FTIME_STR <str_var> <"str"> <int_var>
  102.                 Convert time integer variable to string in custom format
  103.         TRUNCSP [str_var]
  104.                 Truncate space off end of string variable
  105.     STRIP_CTRL [str_var]
  106.         Strips all control characters from string variable
  107.         STRUPR [str_var]
  108.                 Convert string variable to upper case
  109.         STRLWR [str_var]
  110.                 Convert string variable to lower case
  111.         LOAD_TEXT <"str">
  112.                 Loads an alternate TEXT.DAT into memory
  113.         REVERT_TEXT <# or ALL>
  114.                 Reverse effects of REPLACE_TEXT for specific line # or ALL
  115. o New Integer Manipulation functions:
  116.         INT <int_var> [int_var] [...]
  117.                 Define local integer variable(s)
  118.         GLOBAL_INT <int_var> [int_var] [...]
  119.                 Define global integer variable(s)
  120.         SET <int_var> <#>
  121.                 Initialize integer variable
  122.         ADD <int_var> <any_var or #>
  123.                 Add any variable or numeric constant to integer variable
  124.         SUB <int_var> <any_var or #>
  125.                 Subtract any variable or constant from integer variable
  126.         MUL <int_var> <any_var or #>
  127.                 Multiply any variable or constant with integer variable
  128.         DIV <int_var> <any_var or #>
  129.                 Divide integer variable by any variable or constant
  130.         MOD <int_var> <any_var or #>
  131.                 Modula (remainder after division)
  132.         AND <int_var> <any_var or #>
  133.                 Bit-wise AND integer with any constant or variable
  134.         OR  <int_var> <any_var or #>
  135.                 Bit-wise OR integer with any constant or variable
  136.         NOT <int_var> <any_var or #>
  137.                 Bit-wise NOT integer with any constant or variable
  138.         XOR <int_var> <any_var or #>
  139.                 Bit-wise XOR integer with any constant or variable
  140.         COPY <int_var> <any_var>
  141.                 Copy from any variable to an integer variable
  142.         SWAP <int_var> <any_var>
  143.                 Swap contents of any variable with integer variable
  144.         RANDOM <int_var> <#>
  145.                 Write random number between 0 and # to integer variable
  146.         TIME <int_var>
  147.                 Write current time (time_t format) to integer variable
  148.         STRLEN <int_var> <str_var>
  149.                 Put length of string variable into integer variable
  150.         DATE_INT <int_var> <str_var>
  151.                 Convert MM/DD/YY string variable to integer variable
  152.         CRC16 <int_var> <str_var>
  153.                 Put CRC-16 of contents of string variable into integer variable
  154.         CRC32 <int_var> <str_var>
  155.                 Put CRC-32 of contents of string variable into integer variable
  156.         CHKSUM <int_var> <str_var>
  157.                 Put CHKSUM of contents of string variable into integer variable
  158.         CHARVAL <int_var> <str_var>
  159.                 Put value of 1st char in string variable into integer variable
  160.         FLENGTH <int_var> <str_var>
  161.                 Put length of file pointed to by string variable into integer
  162. o New Logic/Control Flow functions:
  163.         COMPARE <any_var> <any_var or "str" or #>
  164.                 Compare any variable with another variable or constant
  165.         IF_EQUAL
  166.                 Same as IF_TRUE
  167.         IF_NOT_EQUAL
  168.                 Same as IF_FALSE
  169.         IF_GREATER
  170.                 If comparison resulted in GREATER-than
  171.         IF_GREATER_OR_EQUAL
  172.                 If comparison resulted in GREATER-than or EQUAL-to
  173.         IF_LESS
  174.                 If comparison resulted in LESS-than
  175.         IF_LESS_OR_EQUAL
  176.                 If comparison resulted in LESS-than or EQUAL-to
  177.         SWITCH <int_var>
  178.                 C-like switch { to replace multi if-else-if statements
  179.         CASE <#>
  180.                 C-like case: block header
  181.         DEFAULT
  182.                 C-like default: case block header
  183.         END_CASE
  184.                 Like C "break" statement, terminates a case block
  185.         END_SWITCH
  186.                 End of switch block (})
  187.         CMDKEYS <keylist>
  188.                 Skip block if current command key is not in keylist
  189.         COMPARE_KEYS <keylist>
  190.                 Logic state set to FALSE if current command key not in keylist
  191.         COMPARE_STRN <#> <str_var> <str_var or "str">
  192.                 Compare first # characters of two strings (strncmp())
  193.         COMPARE_SUBSTR <str_var> <str_var or "str">
  194.                 Find second string inside first (strstr())
  195. o New Display functions:
  196.         PRINTF <"str"> <any_var> [any_var] [...]
  197.                 C-like function to display text and formatted variables
  198.         PRINTTAIL <str_var> <mode> <lines>
  199.                 Print last x number of lines of file (mode same as PRINTFILE)
  200.         READ_SIF <"str">
  201.                 Read SIF/SOF file and display with user's answers filled in
  202.         SAVELINE
  203.                 Save the current display line to be redisplayed w/RESTORELINE
  204.         RESTORELINE
  205.                 Re-display last line saved with SAVELINE
  206. o New Input functions:
  207.         INKEY
  208.                 Set logic state to TRUE if the user hit a key (don't wait)
  209.         CREATE_SIF <"str">
  210.                 Create/overwrite SIF data file by asking user questions
  211. o New Miscellaneous functions
  212.         ONLINE
  213.                 Assume online execution (auto-halt if disconnected) - default
  214.         OFFLINE
  215.                 Assume offline execution (no carrier or no one online)
  216.         LOGIN <"str">
  217.                 Process login attempt using passed str for password prompt
  218.         LOGON
  219.                 Initiate logon procedure (auto-loads logon module)
  220.         LOGOUT
  221.                 This function to be used before re-logging a user in
  222.         NEWUSER
  223.                 Initiate new user procedure (auto-loads new user module)
  224.         RIOSYNC
  225.                 Synchronize remote output (wait for output buffers to flush)
  226.         PUT_NODE
  227.                 Force flush of current node information to disk
  228.         NODE_STATUS <status or #>
  229.                 Set node status to one of:
  230.                         WFC            Waiting for Call
  231.                         LOGON          At logon prompt
  232.                         NEWUSER        New user applying
  233.                         INUSE          In Use
  234.                         QUIET          In Use - quiet mode
  235.                         OFFLINE        Offline
  236.                         NETTING        Networking
  237.                         EVENT_WAITING  Waiting for all nodes to be inactive
  238.                         EVENT_RUNNING  Running an external event
  239.                         EVENT_LIMBO    Allowing another node to run an event
  240.         ADJUST_USER_MINUTES <# or -#>
  241.                 Add or subtract minutes from user's minute bank
  242.         USER_EVENT <event_type>
  243.                 Execute user event(s), one of:
  244.                         LOGON     All configured external logon events
  245.                         LOGOFF    All configured external logoff events
  246.                         NEWUSER   All configured external new user events
  247.                         BIRTHDAY  All configured external birthday events
  248.         TRASHCAN <"str">
  249.                 Searches file specified by "str" for current command string
  250.     SEND_FILE_VIA <prot> <"str" or str_var>
  251.         Immediately start the transfer of a file with specific protocol
  252.         GETTIMELEFT
  253.                 Checks the user's current time left online
  254.         MSWAIT <#>
  255.                 Suspends execution for # milliseconds (gives up time-slices)
  256. o New File Base functions:
  257.         FILE_BATCH_ADD_LIST
  258.                 Add list of files (current command str) to batch d/l queue
  259.     FILE_SEND
  260.         Same as FILE_GET, but doesn't require system password.
  261. o New Chat functions:
  262.         PAGE_GURU
  263.                 Page one of the configured online Gurus for chat
  264. o New File I/O functions:
  265.         FOPEN <int_var> <access> <"str" or str_var>
  266.                 Open/create a file for random access
  267.         FCLOSE <int_var>
  268.                 Close a file
  269.         FREAD <int_var> <any_var> [int_var or #]
  270.                 Read # of bytes from a file into integer or string variable
  271.         FWRITE <int_var> <any_var> [int_var or #]
  272.                 Write # of bytes from integer or string variable into a file
  273.         FGET_LENGTH <int_var> <int_var>
  274.                 Get current length of file and put in integer variable
  275.         FSET_LENGTH <int_var> <int_var or #>
  276.                 Set current length of file
  277.         FGET_TIME <int_var> <int_var>
  278.                 Get the current time stamp of file
  279.         FSET_TIME <int_var> <int_var>
  280.                 Set the current time stamp of file
  281.         FEOF <int_var>
  282.                 Set logic state to true if currently at end of file
  283.         FGET_POS <int_var> <int_var>
  284.                 Get current byte offset (position) in file
  285.         FSET_POS <int_var> <int_var or #> [BEG/SET or CUR or END or #]
  286.                 Set the current file position (seek)
  287.         FLOCK <int_var> <int_var or #>
  288.                 Lock a record of # bytes in length (retry for 10 seconds)
  289.         FUNLOCK <int_var> <int_var or #>
  290.                 Unlock a previously locked record
  291.         FPRINTF <int_var> <"str"> <any_var> [any_var] [...]
  292.                 Write text and formatted variables to file
  293.     FREAD_LINE <int_var> <any_var>
  294.         Read a single line from a file into a variable
  295.         FSET_ETX <#>
  296.                 Set end-of-text character for ASCII termination (default: 0)
  297. o New File System functions
  298. o New Directory System functions
  299.  
  300.  
  301. Incompatibilities with Baja Version 1 Source Code
  302. =================================================
  303.  
  304. PRINT function requires argument to be in quotes (if not a variable).
  305.  
  306. PRINTFILE function requires first argument to be in quotes (if not a variable).
  307.  
  308. NODE_ACTION function requires inclusion of NODEDEFS.INC and action parameters
  309.     (MAIN and XFER) where changed (to NODE_MAIN and NODE_XFER). Additional
  310.     action values were added. See Baja.DOC for details.
  311.  
  312. TOGGLE_NODE_MISC and COMPARE_NODE_MISC functions require the inclusion of
  313.     NODEDEFS.INC. Misc attribute syntax was changed. See Baja.DOC for
  314.     details.
  315.  
  316. TOGGLE_USER_MISC and COMPARE_USER_MISC functions require the inclusion of
  317.     USERDEFS.INC. The misc attributes were changed (prepended with UM_).
  318.     The syntax for combining multiple misc attributes was changed. See
  319.     Baja.DOC for details.
  320.  
  321. TOGGLE_USER_CHAT, COMPARE_USER_CHAT, TOGGLE_USER_QWK, and COMPARE_USER_QWK
  322.     functions require the inclusion of USERDEFS.INC. The attr parameters
  323.     were changed (from ECHO to CHAT_ECHO, for example). The syntax for
  324.     combining multiple misc attributes was changed. See Baja.DOC for
  325.     details.
  326.  
  327. SET_USER_STRING function requires the inclusion of USERDEFS.INC. The argument
  328.     syntax was changed (from ALIAS to USER_STRING_ALIAS, for example).
  329.  
  330. Label names may no longer contain spaces.
  331.  
  332. /* End of BAJA_V2.NEW */
  333.