home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / JAGDEV_1.LZH / DEVELOP.JAG / VECTRONI.X! / DOCS / ADDENDUM.RDB < prev    next >
Text File  |  1994-10-19  |  8KB  |  209 lines
  1. This file contains all the new options for RDBJAG (PC/DOS & Atari/TOS versions)
  2. made since the PC version was released:
  3.  
  4. New command line options:
  5.  
  6. rdbjag [-...] <filename>
  7.     where filename is the name of a .COF file will perform an "aread"
  8.     operation on <filename>.
  9.     The .COF extension may be omitted.
  10.  
  11. rdbjag [-...] <filename>
  12.     where filename is the name of a .ABS file will perform an "aread"
  13.     operation on <filename>.
  14.     The .ABS extension may be omitted.
  15.  
  16. rdbjag [-...] <filename>.DB
  17.     where filename is a .DB file will perform an "read" operation
  18.     on <filename>.
  19.     Note that the .DB extension must be entered.
  20.  
  21. rdbjag -g
  22.     will perform auto go.
  23.     This is usually used with a program/script name, like:
  24.     rdbjag -g <myprog>
  25.  
  26. rdbjag -q
  27.     will perform auto quit.
  28.     This is usually used with -g, like:
  29.     rdbjag -g -q <myprog>
  30.  
  31. rdbjag -o
  32.     will perform auto gag on.
  33.     This is usually used with -g and -q, like:
  34.     rdbjag -o -g -q <myprog>.
  35.  
  36. For the PC/DOS version:
  37.     - By default, rdbjag.exe will test your parallel boards to find a
  38.     bidirectionnal one, and assume the first bidirectionnal port found
  39.     is the Jaguar one. Note that this test may garbage the configuration
  40.     of other parallel boards and could lead the printer to malfunction.
  41.     (This should not happen, but who knows..).
  42.     - The -p[1-3] witch allows user to specify a parallel port to be
  43.     used. 
  44.     - The -d switch, used with the -p switch, tells rdbjag.exe to not
  45.     test the parallel port at all, assuming the port is really
  46.     bidirectionnal. Use it to avoid problems with printer ports or if
  47.     your parallel board is not recognized well enough. (For instance I
  48.     use 'rdbjag -p1 -d turtdemo.abs').
  49.  
  50.  
  51. Line editing and Prompt:
  52.  
  53.     New line editing with arrows, delete, scrolling and history.
  54.     A prompt now appears on each line . 'Db:' for standard input,
  55.     'Proc:' for procedure input and 'Set:' for setting values input.
  56.     There is no history for the two last modes. The history size is
  57.     100 lines for standard input. Use up and down arrow keys to get
  58.     history. Line editing uses right and left arrow keys, DEL and BS.
  59.  
  60.     TAB now completes the expression in input from the cursor position.
  61.     If there is no space before the cursor position, it will try to
  62.     complete from the commands table, if there is a command before the
  63.     cursor position, it will complete the word under the cursor from
  64.     whatever the command is about (i.e: 'aread turt<TAB>' will expand in
  65.     'aread turtdemo.abs', and 'help are<TAB>' will expand in 'help aread').
  66.     TAB TAB show all occurences found if more than one ('a la' gdb).
  67.     If RDBJAG find debugging informations in the .ABS file read, TAB
  68.     and TAB TAB will also expand the symbols.
  69.  
  70.     Thus, no more key binding is allowed for BS, ^@ TAB and ESC as these 
  71.     keys are used for line editing purposes.
  72.  
  73.  
  74. New AREAD function:
  75.  
  76.     To avoid the FILEFIX step after linking is done, a new function is
  77.     provided. It loads a .ABS file directly from the command line. The
  78.     syntax is only 'aread filename'. Note that the .ABS extension may be
  79.     omitted. This function can also be called directly from the DOS (TOS)
  80.     command line simply by entering the filename of the .ABS file after
  81.     <rdbjag>. ABS files recognised can be of DRI absolute file format or
  82.     COFF file format.
  83.  
  84. New Z function:
  85.  
  86.     This will skip the next CPU instruction.
  87.     z <count> will skip the next <count> instructions.
  88.  
  89. New RESET and STOP functions:
  90.  
  91.     If your Alpine board supports it, this will either RESET or STOP the
  92.     Jaguar (as you can do with corresponding buttons). Only works on
  93.     PC/DOS.
  94.  
  95. New source-level handling:
  96.  
  97.     Four new functions have been added for source-level handling:
  98.  
  99.     - LS is the same function as L, but lists the source code instead of
  100.     disassembly.
  101.     Usage is:
  102.         ls <addr> prints the source corresponding to <addr>
  103.         ls :<#>    prints the current source file from line <#>
  104.         ls <fname>:<#> same as above for source file <fname>
  105.         ls <fname>: prints source file <fname> from current line #.
  106.  
  107.     - MLIST  prints a list of all source files loaded in memory
  108.  
  109.      - MPURGE unload source file(s) for small memory configurations.
  110.     Usage is:
  111.       mpurge <fname> will purge source file <fname> from memory.
  112.       mpurge * will purge all source files from memory.
  113.  
  114.     - N
  115.     This will step to the next source line.
  116.  
  117.     Everywhere an address can be entered in rdbjag, you now can also use
  118.     debug symbols. For example one can enter 'ls main' to list the
  119.     source code from the 'main' label, or 'l main' to disassemble from
  120.     the 'main' label.
  121.  
  122.     When rdbjag finds source-level informations in a .ABS file, some
  123.     functions will add source informations to their outputs:
  124.     - after registers display (eg: 'x' but also 't', 'g' etc...).
  125.       - the 'b' command recognizes the same syntax as 'ls'.
  126.      - in breakpoints list.
  127.  
  128.     The "tabstop" variable has been added. One can change it with
  129.     "set tabstop #" (# is the new tab value). This is used in source
  130.     level and disassembly displays (at least). Default value: 8.
  131.  
  132.     The "disaddr" variable has been added. It contains the current
  133.     disassembly address ('l' and 'l disaddr' do the same).
  134.  
  135.     The "dissize" variable has been added. It contains the current
  136.     disassembly size. (Useful mainly in scripts).
  137.  
  138.     The "dislab" variable has been added. 0 means old fashion labels
  139.     disassembly. (See below: Changes from old rdbjag). Default: 1.
  140.  
  141.     The "dislnb" variable has been added. It contains the disassembly
  142.     and source level lines number. Default: 10.
  143.  
  144.     The "srclevel" variable has been added. It forbids source level
  145.     management if set to 0. Default: 1. (Wish from Robert Dibley,
  146.     Rebellion Software).
  147.  
  148. New miscellaneous variables:
  149.  
  150.     The "pprot" variable has been added. It handles the time loop for
  151.     the new parallel protocol. May vary from -1 to 5. Default: 3.
  152.     -1 means "old" protocol (slow).
  153.      0 means new protocol (faster) handshaked version.
  154.      1 means new protocol (faster) half/handshaked version with delay 1.
  155.     2 to 5 means new protocol (faster) half/handshaked version with delay
  156.     2 to 5.
  157.  
  158. Various changes from the old rdbjag:
  159.  
  160.     - Breakpoints and checkpoints are now deleted from the Stub each time
  161.     Rdbjag is launched.
  162.  
  163.     - A pager has been added when more than one page is to be displayed.
  164.     Hitting 'Q' or 'Ctrl-C' will abort the command output.
  165.  
  166.     - A '>' has been added in disassembly mode. It shows the actual 68K
  167.     PC value. (It is also present in source level mode). It is switched
  168.     to '<' before a branch instruction if it will branch.
  169.  
  170.     - A '@' has been added in disassembly mode. It means that there is
  171.     a breakpoint at this address. (It is also present in source level mode).
  172.  
  173.     - Labels are now integrated into the disassembly. I.e:
  174.     move.l    $12345678,$87654321    LAB1, LAB2    ;old fashion
  175.     move.l    LAB1,LAB2                ;now
  176.     Set the variable <dislab> to 0 if you want old fashion.
  177.  
  178.     - Certainly some more I forgot. Find them and win a pack of beer :-)
  179.  
  180.  
  181. ! In order to have unrestricted label names (ie more than 8), you MUST use:
  182.   MADMAC with -fb
  183.   ALN with -e
  184.   (please see corresponding documentation for MADMAC and ALN).
  185.  
  186. ! In order to have the source level in your programs, you MUST use:
  187.   MADMAC with -fb -g
  188.   ALN with -e -g
  189.   (Be sure to have your sources in the partition where RDBJAG lives)
  190.   (please see corresponding documentation for MADMAC and ALN).
  191.  
  192. ! GPU/DSP source-level is now done. Of course there will be
  193.   always a problem if more than one ORG points to the same address. Maybe an
  194.   external mapping could resolve this problem, but it would be hard to
  195.   use.
  196.  
  197. ! In order to have rdbjag finding files in other directory than the current
  198.   one you must set DBPATH to the directory you want it to look at after the
  199.   current one. (I know this sentence is not in real english. I do my best:-))
  200.  
  201. ! Under PC/DOS, rdbjag can directly change the screen resolution.
  202.   Add the following line to your AUTOEXEC.BAT:
  203.   set GO32=TW xx TH yy
  204.   where xx is the columns number (e.g.: 132)
  205.   and yy is the lines number (e.g.: 43).
  206.   This has been disabled for the moment since it is not reliable! (29/04/94).
  207.  
  208. Brainstorm, 24/03/94
  209.