home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 60 / af060sub.adf / dostrace.lha / DOSTrace / DT.doc < prev    next >
Text File  |  1994-01-23  |  23KB  |  834 lines

  1.  
  2.  
  3.                         DOSTrace v2.13 User Manual                   1
  4.  
  5.  
  6.                               DOSTrace v2.13
  7.  
  8.                         Copyright © 1993 Peter Stuer
  9.                             All rights reserved
  10.  
  11.                       Release date December 14, 1993
  12.  
  13.                                  FREEWARE
  14.  
  15.                                 User Manual
  16.  
  17.  
  18.      COPYRIGHT NOTICE 
  19.  
  20.      DOSTrace software and documentation are Copyright © 1993 by Peter
  21.      Stuer. All rights reserved.  
  22.  
  23.  
  24.      DISCLAIMER 
  25.  
  26.      DOSTrace has proven to be stable in everyday use. The author is
  27.      not responsible for any loss of data, damages to software or
  28.      hardware that may result directly or indirectly from the use of
  29.      this program. The author reserves the right to make changes to
  30.      the software or documentation without notice.  
  31.  
  32.  
  33.      PREFACE 
  34.  
  35.      This program is freeware, this means that you can copy it freely
  36.      as long as you don't ask any more money for it than a nominal
  37.      fee for copying. If you want to distribute this program you
  38.      should keep this document with it. This program cannot be used
  39.      for commercial purposes without written permission from the
  40.      author.  
  41.  
  42.      None of the files of the DOSTrace package may be modified or
  43.      left out without permission of the author. Crunching or
  44.      archiving is allowed only if none of the DOSTrace files get
  45.      modified by it.  
  46.  
  47.      Special permission is hereby granted to include DOSTrace in
  48.      Public-Domain collections such as Fred Fish's Amiga Library.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      
  65.  
  66.  
  67.                         DOSTrace v2.13 User Manual                   2
  68.  
  69.  
  70.      Chapter 1 Introduction      
  71.  
  72.      1.1 What is DOSTrace ?    
  73.  
  74.          DOSTrace is a program that allows you to monitor what
  75.      AmigaDOS is doing while you are working with your Amiga. You can
  76.      watch which files your programs use, if they find all the files
  77.      they require, where they are looking for them and much other
  78.      activity of that kind.  
  79.  
  80.      If this sounds familiar to you, you must be one of the many
  81.      SnoopDos users in the Amiga community. This tool was written to
  82.      replace SnoopDos. It shows you a lot more information than
  83.      SnoopDos and it does this in a verbose way. SnoopDos is written
  84.      by Eddy Carroll and freely distributable.  
  85.  
  86.  
  87.      1.2 Features of DOSTrace     
  88.  
  89.          DOSTrace monitors a lot more AmigaDOS activity than
  90.      SnoopDOS.  Currently the following functions can be monitored: 
  91.  
  92.              AddBuffers      LoadSeg (InternalLoadSeg, NewLoadSeg) 
  93.              Close           Lock 
  94.              CreateDir       MakeLink 
  95.              CurrentDir      Open 
  96.              DeleteFile      ParentDir 
  97.              DeviceProc      Read 
  98.              ExAll           Rename 
  99.              Examine         SetComment 
  100.              ExamineFH       SetOwner 
  101.              Execute         StartNotify 
  102.              FRead           SystemTagList 
  103.              FWrite          UnLock 
  104.              GetDeviceProc   Write 
  105.              Info 
  106.  
  107.      You can specify which functions DOSTrace should monitor.  
  108.  
  109.      DOSTrace saves the trace information it gathers as session
  110.      history. It provides a scrollbar which enables you to scroll
  111.      through the session history.  
  112.  
  113.      DOSTrace is also a commodity. You can specify a hotkey to show
  114.      or hide the output window.  
  115.  
  116.      DOSTrace can open on any public screen.  
  117.  
  118.      DOSTrace can trace a single task specified by the user.  
  119.  
  120.  
  121.      1.3 System requirements      
  122.  
  123.          DOSTrace should run on any Amiga system with at least 512K
  124.      RAM and one disk-drive. DOSTrace requires KickStart v2.04 or
  125.      higher to run. Special care has been taken in the program design
  126.  
  127.  
  128.      
  129.  
  130.  
  131.                         DOSTrace v2.13 User Manual                   3
  132.  
  133.  
  134.      to make the program work with 68020, 68030 and 68040 processors
  135.      without sacrificing 68000 compatibility.  
  136.  
  137.      DOSTrace also requires the ReqTools.library v38 or higher.
  138.      ReqTools is copyright © 1992, 1993 by Nico François.  
  139.  
  140.      DOSTrace is KickStart 3.0 compatible and aware. It will show you
  141.      some of the new features available with this version of the
  142.      operating system.  
  143.  
  144.      Should you have any trouble running DOSTrace on your machine,
  145.      please contact me with the full specifications of your machine,
  146.      that is KickStart version, model, expansion boards etc...  
  147.  
  148.  
  149.      1.4 About the author and the program  
  150.  
  151.          DOSTrace has been created using the Macro68 Assembler and
  152.      CygnusEd Professional 3 on an Amiga A3000 25/100 with 10MB
  153.      memory. The DOSTrace documentation was formatted with PRoff.  
  154.  
  155.      If you have suggestions or remarks about this program, or if you
  156.      find any bugs, please let me know.  
  157.  
  158.      When sending in bug reports, please state exactly under what
  159.      circumstances the bug occurred, what equipment was used and what
  160.      happened. If possible also try to give me enough information to
  161.      reproduce the bug. It is very difficult to find bugs when you
  162.      don't know exactly what happened.  
  163.  
  164.      Write to the following address: 
  165.  
  166.              Fido     :  2:292/603.7 (Peter Stuer)
  167.              AmigaNet : 39:120/102.7 (Peter Stuer)
  168.              NLA Net  : 14:200/101.7 (Peter Stuer)
  169.  
  170.              UUCP     : Peter.Stuer@p7.f603.n292.z2.FidoNet.Org
  171.  
  172.              SnailMail: Peter Stuer
  173.                         Beatrijslaan 2 bus 13
  174.                         B-2050 Antwerpen L.O.
  175.                         Belgium - Europe
  176.  
  177.      I will also try to put the latest available version of DOSTrace
  178.      on the following BBS (this may change without further notice): 
  179.  
  180.              Great Balls Of Fire BBS 
  181.              ReqTools Support BBS 
  182.              Herman Stevens 
  183.              Lubbeek 
  184.              ADS Distribution HUB 
  185.              ABC Host Belgium 
  186.              AFN Host Belgium 
  187.              Tel. +32-(0)16-64.09.12 
  188.              ZyXEL U1496+ 16800 BPS (N.8.1) v32bis v42bis 
  189.              24-24 h.  
  190.  
  191.  
  192.      
  193.  
  194.  
  195.                         DOSTrace v2.13 User Manual                   4
  196.  
  197.  
  198.              Fido Node  2:292/603 
  199.              NLA Node  14:200/101.0 
  200.              AmyNet    39:120/102.0 
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.      
  257.  
  258.  
  259.                         DOSTrace v2.13 User Manual                   5
  260.  
  261.  
  262.      Chapter 2 Using DOSTrace     
  263.  
  264.          You can be start DOSTrace from the CLI/Shell or the
  265.      Workbench.  DOSTrace will always check to make sure it is not
  266.      already running.  If so, the copy of DT that is already running
  267.      will be notified and its window will open or come to the front.
  268.      The second copy will exit quietly.  
  269.  
  270.  
  271.      2.1 Starting DOSTrace from the Shell   
  272.  
  273.          To start DOSTrace from the Shell simply type: 
  274.  
  275.              1> DOSTrace 
  276.  
  277.      followed by a return. If you want to continue using the Shell
  278.      while DOSTrace is running, you need to prepend the Run command
  279.      before DOSTrace as follows: 
  280.  
  281.              1> run DOSTrace 
  282.  
  283.      If DOSTrace is succesful in initializing itself, you see the
  284.      DOSTrace window and will start monitoring AmigaDOS.  
  285.  
  286.  
  287.      2.2 Shell Startup Options     
  288.  
  289.          DOSTrace can be started with various options. If you run
  290.      DOSTrace with a questionmark (?) as argument you'll get the
  291.      argument template.  
  292.  
  293.  
  294.      HISTORY 
  295.  
  296.        This option tells DOSTrace how many lines of session history
  297.        it should keep. Use 0 to disable the history feature. The
  298.        default number of history lines is 256.  
  299.  
  300.      OUTPUT 
  301.  
  302.        With this option you can direct the trace information to some
  303.        other AmigaDOS device of file in addition or in place of the
  304.        information being displayed in the window.  
  305.  
  306.        If you have a debugging terminal attached to the serial port
  307.        you could use 'DOSTrace OUTPUT=AUX:' to have all trace
  308.        information appear at the terminal.  
  309.  
  310.        A special symbol is DEBUG. 'OUTPUT=DEBUG' will output all
  311.        trace information to the serial port at 9600 baud.  
  312.  
  313.      LEFT 
  314.  
  315.        This option specifies the left position of the DOSTrace output
  316.        window in pixels. By default, the leftedge will be zero (0).  
  317.  
  318.  
  319.  
  320.      
  321.  
  322.  
  323.                         DOSTrace v2.13 User Manual                   6
  324.  
  325.  
  326.      TOP 
  327.  
  328.        This option specifies the top position of the DOSTrace output
  329.        window in pixels. By default, DOSTrace will open its window 1
  330.        pixel under the screen title bar.  
  331.  
  332.      WIDTH 
  333.  
  334.        This option specifies the width of the DOSTrace output window
  335.        in pixels. By default, DOSTrace will open a window that is as
  336.        wide as the visible width of the public screen it is appearing
  337.        on.  
  338.  
  339.      HEIGHT 
  340.  
  341.        This option specifies the height of the DOSTrace output window
  342.        in screen lines. By default, DOSTrace will open a window that
  343.        is as high as the visible height of the public screen it is
  344.        appearing on, without overlapping the title bar.  
  345.  
  346.      SCREEN 
  347.  
  348.        If you do not use this option, DOSTrace will open on the
  349.        default public screen which is most of the times the Workbench
  350.        screen.  DOSTrace will try to open on the public screen whose
  351.        name is specified after this argument.  
  352.  
  353.      TRACE/DONTTRACE 
  354.  
  355.        By specifying a trace mask using the TRACE parameter you can
  356.        determine which AmigaDOS functions DOSTrace will actually
  357.        trace.  The trace mask consists of a string of characters. The
  358.        function corresponding to the character will be traced. Use
  359.        the following characters (case sensitive): 
  360.  
  361.              A: AddBuffers      M: LoadSeg 
  362.              B: CreateDir       N: Lock 
  363.              C: CurrentDir      O: MakeLink 
  364.              D: DeleteFile      P: NewLoadSeg 
  365.              E: DeviceProc      Q: Open 
  366.              F: ExAll           R: ParentDir 
  367.              G: Examine         S: Rename 
  368.              H: ExamineFH       T: SetComment 
  369.              I: Execute         U: SetOwner 
  370.              J: GetDeviceProc   V: StartNotify 
  371.              K: Info            W: SystemTagList 
  372.              L: InternalLoadSeg X: Close 
  373.                                 Y: UnLock 
  374.  
  375.              a: Read            c: FRead 
  376.              b: Write           d: FWrite 
  377.  
  378.        For example, TRACE=CDMNQI will only trace the AmigaDOS
  379.        functions that SnoopDOS 1.7 traces. By default, DOSTrace
  380.        monitors all AmigaDOS functions it knows about.  
  381.  
  382.  
  383.  
  384.      
  385.  
  386.  
  387.                         DOSTrace v2.13 User Manual                   7
  388.  
  389.  
  390.        Specifying a trace mask for DONTTRACE will make DOSTrace
  391.        ignore the functions that you specify here. For example,
  392.        DONTTRACE=abcd will cause the many read/write operations some
  393.        programs make not to be shown.  
  394.  
  395.        The DONTTRACE trace mask always takes precedence over the
  396.        TRACE trace mask.  
  397.  
  398.      TASK 
  399.  
  400.        If you want to trace the dos operations of a particular task,
  401.        this option will allow you to specify the address of that
  402.        task.  For example, DT TASK=$0786ecc8 will only show the
  403.        activity of the program that has its Task/Process structure at
  404.        address $0786ECC8.  The dollar sign ($) is optional and the
  405.        number is case-insensitive.  
  406.  
  407.        When DOSTrace is already running, you can use the "Task"
  408.        menuitem of the "Project" menu.  
  409.  
  410.        The name of the task currently being traced will be shown in
  411.        the title bar of the DOSTrace window.  
  412.  
  413.        To stop tracing a particular task, select the "Task" menuitem
  414.        of the "Project" menu and clear the address shown there. If
  415.        you then select "Ok", the title bar will reset and DOSTrace
  416.        will continue to trace all tasks.  
  417.  
  418.      CX_PRIORITY 
  419.  
  420.        This option allows you to specify priority relative to the
  421.        other Commodities programs. Default priority is 0.  
  422.  
  423.      CX_POPKEY 
  424.  
  425.        This option allows you to change the default hot key for
  426.        DOSTrace.  The default hot key is 'ralt d' (right Alt key
  427.        pressed with 'd').  
  428.  
  429.      CX_POPUP 
  430.  
  431.        If you do not want DOSTrace to open its window, you can
  432.        specify the CX_POPUP switch like this: DT CX_POPUP=NO. By
  433.        default, the DOSTrace window will open.  
  434.  
  435.      CX_ACTIVE 
  436.  
  437.        By specifying CX_ACTIVE=NO, DOSTrace start without its tracing
  438.        code enabled. By default, tracing starts immediately.  
  439.  
  440.  
  441.      2.3 Starting DOSTrace from the Workbench   
  442.  
  443.          To start DOSTrace from the Workbench, simply double-click on
  444.      the DOSTrace icon to start the program or use the 'Execute
  445.      Command' item from the 'Workbench' menu.  
  446.  
  447.  
  448.      
  449.  
  450.  
  451.                         DOSTrace v2.13 User Manual                   8
  452.  
  453.  
  454.  
  455.  
  456.      2.4 Workbench Startup Options     
  457.  
  458.          You can specify the same options as explained in the
  459.      paragraph "Shell Startup Options" by adding tooltypes to the
  460.      DOSTrace icon.  
  461.  
  462.                                    NOTE
  463.  
  464.           If you use the CX_POPUP and/or the CX_ACTIVE tooltype
  465.           you must specify them with '=YES' appended to them.
  466.           For example, 'CX_POPUP=YES'. Not using them defaults
  467.           to CX_POPUP=YES and CX_ACTIVE=YES.  
  468.  
  469.  
  470.      To change the task priority of DOSTrace you can add the TOOLPRI
  471.      tooltype to the DOSTrace icon. For example, adding TOOLPRI=5 will
  472.      start running DOSTrace with task priority 5.
  473.  
  474.  
  475.      2.5 Stopping DOSTrace     
  476.  
  477.          You can stop DOSTrace at any time by sending it a break signal. If
  478.      you started DOSTrace from the Shell, you can do this by pressing
  479.      Ctrl-C.
  480.  
  481.      Since DOSTrace is a commodity you can use the Exchange utility to
  482.      control it.
  483.  
  484.        'Show Interface' will open the DOSTrace output window
  485.  
  486.        'Hide Interface' will close the DOSTrace output window
  487.  
  488.        The 'Active/Inactive' cycle gadget will toggle DOSTrace's
  489.        activation status. When DOSTrace is active it will update it's
  490.        internal history even when the output window is closed; when it is
  491.        inactive, no tracing will occur.
  492.  
  493.        'Remove' will tell DOSTrace to quit.
  494.  
  495.                                    NOTE
  496.  
  497.           DOSTrace will try to quit immediately. If any of the
  498.           patches are still in use, it will wait until no
  499.           program uses the DOSTrace patches anymore.  
  500.  
  501.  
  502.      2.6 The Project menu    
  503.  
  504.          The Project menu gives you some control over DOSTrace's behaviour
  505.      while it is running.
  506.  
  507.      2.6.1 The Active menu item   
  508.  
  509.        DOSTrace is 'active' when it is allowed to monitor AmigaDOS
  510.  
  511.  
  512.      
  513.  
  514.  
  515.                         DOSTrace v2.13 User Manual                   9
  516.  
  517.  
  518.        operations. When this menu item is checked, DOSTrace is active.
  519.  
  520.      2.6.2 The Task menu item   
  521.  
  522.        This menu item will cause a requester to pop up that asks you to
  523.        enter the address of the Task/Process structure of the program you
  524.        want to trace. If you enter an address that does not point to a
  525.        Task structure, DOSTrace will beep the display. See also the To Do
  526.        list and the TASK startup option.
  527.  
  528.      2.6.3 The Clear menu item   
  529.  
  530.        Clears the session history and the window.
  531.  
  532.      2.6.4 The Hide menu item   
  533.  
  534.        Does the same as the Hide gadget of the Exchange program. DOSTrace
  535.        stays in memory and, depending on its activation status, continues
  536.        to trace AmigaDOS.
  537.  
  538.      2.6.5 The Quit menu item   
  539.  
  540.        This causes DOSTrace to try to quit. See also 'Stopping DOSTrace'.
  541.  
  542.  
  543.      2.7 About the trace output   
  544.  
  545.          The information shown depends on which function is being traced
  546.      but all messages have 3 components in common:
  547.  
  548.              Process Name    The name of the process calling the
  549.                              AmigaDOS function.
  550.  
  551.              Trace Info      Verbose information about the function
  552.                              being executed.
  553.  
  554.              Result          Whether the call was succesfull or not
  555.                              (if applicable)
  556.  
  557.  
  558.      2.8 To do wishes suggestions...   
  559.  
  560.      · A listrequester to select the task that should be monitored
  561.  
  562.      · Auto-detach from the CLI
  563.  
  564.      · Keeping the same position in the session history after a resize
  565.  
  566.      · An ARexx port
  567.  
  568.      · Prefs panel
  569.  
  570.      · An alternative, less verbose output mode
  571.  
  572.  
  573.  
  574.  
  575.  
  576.      
  577.  
  578.  
  579.                         DOSTrace v2.13 User Manual                  10
  580.  
  581.  
  582.      :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  583.      ::::::::::::::::::::::: DOSTRACE HISTORY ::::::::::::::::::::::::
  584.      :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  585.  
  586.      ::: Version 2.13 ::: December 14, 1993 ::::::::::::::::::::::::::
  587.  
  588.      - BUG FIX: Fixed a small bug that caused high-ASCII characters
  589.        in filenames to disappear. Thanks to Stefan Ottosson for
  590.        reporting this.
  591.  
  592.      - BUG FIX: The session history was not redrawn if there were less
  593.        lines in the session history than could be displayed. Thanks
  594.        to David Nouls & Bart van Assche for reporting this.
  595.  
  596.      ::: Version 2.12 ::: December 6, 1993 :::::::::::::::::::::::::::
  597.  
  598.      - NEW: Added trace code for Read(), Write(), FRead() and FWrite().
  599.        Thanks to Preben Nielsen for suggesting this.
  600.  
  601.      - NEW: LEFT and TOP options let you specify the left and top
  602.        position of the DOSTrace window. Thanks to Preben Nielsen for
  603.        suggesting this.
  604.  
  605.      - NEW: DOSTrace remembers the position and dimensions of its
  606.        window when it shows it window again after a 'Hide'.
  607.  
  608.      - NEW: You can use the following keys to control the position of
  609.        the session history:
  610.              Cursor Up/Cursor Down           1 line up/down
  611.              Shift Cursor Up/Cursor Down     1 page up/down
  612.              Control Cursor Up/Cursor Down   top/bottom
  613.        Thanks to Magnus Holmgren for suggesting this.
  614.  
  615.      - NEW: To avoid using a ridiculously long TRACEMASK parameter
  616.        if you DON'T want to see the trace results of a function, I
  617.        replaced the TRACEMASK parameter with the TRACE and DONTTRACE
  618.        parameter. For more information, see the documentation.
  619.  
  620.      - NEW: Brought the manual up to date and added more links in the
  621.        AmigaGuide file.
  622.  
  623.      - BUG FIX: Due to register leaking DOSTrace would exit sometimes
  624.        when it reopened its window after another copy of DOSTrace woke
  625.        the original up. Thanks to Rafael D'Halleweyn and Magnus Holmgren
  626.        for reporting this.
  627.  
  628.      - BUG FIX: DOSTrace ignored the CX_PRIORITY argument. Thanks to
  629.        Rafael D'Halleweyn for reporting this.
  630.  
  631.      - BUG FIX: The broker name of DOSTrace did not fit completely in
  632.        the provided space by Exchange. Thanks to Rafael D'Halleweyn
  633.        for reporting this.
  634.  
  635.      - BUG FIX: Fixed a bug that could cause a lock-up of the console
  636.        device during a refresh of the history. Thanks to Bart van
  637.        Assche for helping me to track it down.
  638.  
  639.  
  640.      
  641.  
  642.  
  643.                         DOSTrace v2.13 User Manual                  11
  644.  
  645.  
  646.  
  647.      ::: Version 2.11 ::: Not released :::::::::::::::::::::::::::::::
  648.  
  649.      - This version accidentally leaked out as ßeta.
  650.  
  651.      ::: Version 2.10 ::: November 15, 1993 ::::::::::::::::::::::::::
  652.  
  653.      - NEW: Added trace code for Close and UnLock.
  654.  
  655.      - NEW: Removed the annoying delay when quitting DOSTrace. Thanks
  656.        to Rafael D'Halleweyn for the suggestion.
  657.  
  658.      - NEW: Added up/down gadgets to scroll up/down line by line.
  659.  
  660.      - NEW: Added the TASK option and Task menu item (requested by
  661.        Jan Dujardin)
  662.  
  663.      - NEW: Added Clear menu item to clear the history buffer while
  664.        DOSTrace is running.
  665.  
  666.      - NEW: Added an Active menu item to make activating and
  667.        deactivating DOSTrace on the fly easier.
  668.  
  669.      - IMPROVED: Optimized some of the core routines.
  670.  
  671.      - IMPROVED: DOSTrace starts active and with the output window
  672.        open when run from the CLI.
  673.  
  674.      - IMPROVED: Removed inner border to make DOSTrace more conform to
  675.        the Style Guide.
  676.  
  677.      - IMPROVED: Execute() and SystemTagList() now show which program
  678.        they are trying to run before the program starts running.
  679.  
  680.      - IMPROVED: When DOSTrace is unable to determine the filename of
  681.        the object a DOS function is acting on it will use the name
  682.        "Unknown Object" instead.
  683.  
  684.        You will notice this especially when closing or unlocking
  685.        objects that do not or incompletely support a file system like
  686.        CON:, PRT: or NIL:.
  687.  
  688.      - BUG FIX: Removed a bug that caused a signal to stay allocated.
  689.  
  690.      - BUG FIX: Fixed a display bug.
  691.  
  692.      ::: Version 2.00 ::: August 21, 1993 ::::::::::::::::::::::::::::
  693.  
  694.      - Complete rewrite.
  695.  
  696.      - NEW: Added monitoring code for InternalLoadSeg and NewLoadSeg.
  697.  
  698.      - IMPROVED: Made trace code smaller and faster.
  699.  
  700.      - BUG FIX: Suppressing Workbench's background DOS operations did
  701.        not work always.
  702.  
  703.  
  704.      
  705.  
  706.  
  707.                         DOSTrace v2.13 User Manual                  12
  708.  
  709.  
  710.  
  711.      - BUG FIX: I forgot (again) that some programs still wrongly
  712.        expect that D0 and D1 are equal when returning from LoadSeg.
  713.        This should fix problems with programs that use old overlay
  714.        managers.
  715.  
  716.      ::: Version 1.00 ::: June 22, 1993 ::::::::::::::::::::::::::::::
  717.  
  718.      - First release
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.      
  769.  
  770.  
  771.      
  772.  
  773.  
  774.                              Table Of Contents
  775.  
  776.                               DOSTrace v2.13
  777.  
  778.      Chapter 1 Introduction     ................................    2
  779.         1.1 What is DOSTrace ?   ...............................    2
  780.         1.2 Features of DOSTrace    ............................    2
  781.         1.3 System requirements     ............................    2
  782.         1.4 About the author and the program ...................    3
  783.      Chapter 2 Using DOSTrace    ...............................    5
  784.         2.1 Starting DOSTrace from the Shell  ..................    5
  785.         2.2 Shell Startup Options    ...........................    5
  786.         2.3 Starting DOSTrace from the Workbench  ..............    7
  787.         2.4 Workbench Startup Options    .......................    8
  788.         2.5 Stopping DOSTrace     ..............................    8
  789.         2.6 The Project menu    ................................    8
  790.            2.6.1 The Active menu item   ........................    8
  791.            2.6.2 The Task menu item   ..........................    9
  792.            2.6.3 The Clear menu item   .........................    9
  793.            2.6.4 The Hide menu item   ..........................    9
  794.            2.6.5 The Quit menu item   ..........................    9
  795.         2.7 About the trace output   ...........................    9
  796.         2.8 To do wishes suggestions...   ......................    9
  797.  
  798.      Copyright © 1993 DOSTrace v2.13 written by Peter Stuer
  799.  
  800.  
  801.      Thanks to Nico François, Johan van Houtven, Hermans Stevens, Jan
  802.      Dujardin, Rafael D'Halleweyn, Bart van Assche, Stu Churchill,
  803.      Magnus Holmgren and Per-Anders Josefsson for testing DOSTrace.
  804.                   _
  805.                _ //
  806.      Thanks to \X/ Amiga for being the best computer ever!
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.      
  833.  
  834.