home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 612a.lha / PowerVisor_v1.13 / PowerVisor_v1.13.lzh / ReadThisFirst < prev    next >
Text File  |  1992-02-14  |  60KB  |  1,214 lines
  1.  
  2.  
  3.         ###     ##   #     # #### ###   #     # ###   ##    ##   ###
  4.         #  #   #  #  #     # #    #  #  #     #  #   #  #  #  #  #  #
  5.         #   # #    # #     # #    #   # #     #  #  #     #    # #   #
  6.         #   # #    # #     # #    #   # #     #  #  #     #    # #   #
  7.         #   # #/¯¯¯#¯#¯¯¯¯¯#¯#¯¯¯¯#¯¯¯#¯#¯¯¯¯¯#¯¯#¯¯#¯¯¯¯¯#¯¯¯\# #   #
  8.         #  #  #    # #     # #    #  #  #     #  #   #    #    # #  #
  9.         ###  /#    # #     # ###  ###   #     #  #    #   #    #\###
  10.         #   / #    # #     # #    #  #  #     #  #     #  #    # #  #
  11.         #  /  #    #  #   #  #    #   #  #   #   #      # #    # #\  #
  12.         # /   #    #  # # #  #    #   #  #   #   #      # #    # # \ #
  13.         #/    #    #  # # #  #    #   #  #   #   #      # #    # #  \#
  14.         #      #  #   ## ##  #    #   #   # #    #  #  #   #  #  #   #
  15.        /#       ##    #   #  #### #   #    #    ###  ##     ##   #   #\
  16.       /                                                                \
  17.      /                                                                  \
  18.     /                                                                    \
  19.    /                                                                      \
  20.   /                                                                        \
  21.  /                                                                          \
  22. |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|
  23. | Introduction and general information              Fri Feb 14 10:12:50 1992 |
  24. |____________________________________________________________________________|
  25.  
  26.  
  27.  
  28.  
  29.  
  30. PowerVisor V1.13ß    CopyRight © Jorrit Tyberghein (feb 92)
  31. -----------------
  32.  
  33.    PowerVisor is a powerful debugger designed to do almost everything
  34.    you can think of. Even if you can't think of it it will probably still be
  35.    possible :-)
  36.  
  37.    What I meant to say with the above is that PowerVisor is
  38.    rather complex to use. I recommend that you read the tutorial sections
  39.    even if you think you can cope. Once you have mastered the program
  40.    you will probably be able to debug your programs in a very short
  41.    time.
  42.  
  43.    Note that I TRY to make PowerVisor as user friendly as possible (look
  44.    at the emphasis on the word 'try'). In this new version for example,
  45.    menus have been added (at least for the AmigaDOS 2.0 version) and some
  46.    of the errormessages are better.
  47.  
  48.    Read the tutor files and execute each command as mentioned
  49.    there. All lines you have to type are preceded by a '<'. Some special
  50.    keys are notated as <key>. <enter> is used for the return key.
  51.    All output from PowerVisor is preceded by a '>'.
  52.    If you must press two keys together there is a '+' between them:
  53.    <alt>+<enter>.
  54.  
  55.    All input and output in this tutorial is for the AmigaDOS 2.0
  56.    version. In most cases this does not matter. If there are
  57.    differences between the two versions it is mentioned in the tutorial
  58.    in the following form: (1.3 : .......)
  59.  
  60.  
  61. Shareware and disclaimer
  62. ------------------------
  63.  
  64.    PowerVisor is shareware. This means that you can copy it and give
  65.    to everybody. If you like the program and/or use it, I'd appreciate
  66.    it if you send me a contribution. If you send $25 US or more
  67.    you automatically get the next major release when one is available
  68.    (I will also add you to the list of registered users).
  69.    PLEASE send money by international money order, EuroCheck (in Belgian
  70.    Francs (BEF) !) or cash, because it's very difficult for me to cash
  71.    in other checks !
  72.    If you want an update please state your current version.
  73.  
  74.    Note that PowerVisor may only be redestributed with ALL FILES
  75.    PRESENT (especially this file). Below follows a list of all files
  76.    in the PowerVisor distribution.
  77.  
  78.    NOTHING in the PowerVisor distribution may be redistributed seperatelly
  79.    or used in any commercial product without prior permission from
  80.    the author.
  81.  
  82.    Note that the quickhelp utilities ('MakeHelp', 'ArcFiles', 'Help',
  83.    'MakeHelp13', 'ArcFiles13' and 'Help13') are considered seperate
  84.    from PowerVisor. You may redistribute the quickhelp utilities
  85.    without the rest of PowerVisor if you really want to (read the
  86.    'Help.doc' and 'Help13.doc' files for possible restrictions).
  87.  
  88.    This is in fact a BETA VERSION. This means that there are still
  89.    some bugs to be solved. If you use this program you are
  90.    betatesting PowerVisor. Don't worry too much about this. I think
  91.    PowerVisor is rather stable. I use it a lot and I have not
  92.    yet crashed with the current version. Note that as long as PowerVisor
  93.    is in beta state, it is better to delete the PowerVisor-config file
  94.    for each new version you get.
  95.  
  96.    I (THE AUTHOR) TAKE NO RESPONSIBILITY FOR DAMAGES INFLICTED BY
  97.    POWERVISOR AND THE OTHER PROGRAMS IN THIS DISTRIBUTION. YOU ARE
  98.    COMPLETELY RESPONSIBLE FOR ALL EFFECTS OF USING POWERVISOR
  99.    AND ANY OF THE OTHER PROGRAMS. USE AT YOUR OWN RISK !
  100.  
  101.  
  102. I'm sorry
  103. ---------
  104.  
  105.    I'm sorry for the bad English. I speak Dutch and English is
  106.    only my second language. The tutorial files as they are in
  107.    the current distribution are NOT corrected at all. I didn't
  108.    even reread everything. I'd very much appreciate corrections of the
  109.    online help and the tutorial files.
  110.  
  111.  
  112. Compatibility with PowerVisor V1.10ß to V1.12ß
  113. ----------------------------------------------
  114.  
  115.    PowerVisor is still in beta release. This means that big changes
  116.    are unavoidable. Here follow all things that have changed.
  117.    If you have made ARexx programs, scripts or ML-scripts you will
  118.    probably have to change some things :
  119.  
  120.       - The 'ScreenBase' structure (see 'TheWizardCorner') has changed.
  121.         You will probably have to change and recompile all scripts
  122.         using 'ScreenBase'
  123.       - The 'PowerVisor-config' file is not compatible
  124.  
  125.  
  126. Compatibility with PowerVisor V1.00ß and V1.01ß
  127. -----------------------------------------------
  128.  
  129.       - 'refresh' ALWAYS expects two arguments. The second
  130.         argument (command) is no longer optional
  131.       - New 'pvcall 17' and other pvcall commands
  132.       - New strong quote operator (·)
  133.       - The '#' operator is removed. Replace it with the '\' operator :
  134.                #<var>     ---->     \(<var>,%s)
  135.       - The 'eval' function expects a string pointer instead of a string
  136.       - The 'libfunc' command expects a negative argument instead of
  137.         a positive one
  138.       - The <maximum number of functions> argument is removed from
  139.         the 'loadfd' command
  140.       - 'memory', 'view' and 'unasm' work differently when another
  141.         number of bytes is used (see documentation)
  142.       - All error numbers have changed because the obsolete error
  143.         numbers are removed
  144.       - The 'PVSD' fileformat ('loadtags', 'savetags') has changed.
  145.         There is no way to convert. You need the original source
  146.         (.struct file)
  147.       - 'why' command is gone and is replaced with an alias in
  148.         the standard PowerVisor-startup file
  149.       - Many fields described in 'TheWizardCorner' have changed. Some
  150.         pvcall functions have become obsolete and DO NOT work anymore.
  151.         Some pvcall functions have been REPLACED with others
  152.       - The PowerVisor expression evaluator is more strict. You MUST
  153.         close ALL brackets (also {} brackets)
  154.       - PowerVisor commands called from ARexx are not interruptable anymore
  155.         with <esc>
  156.       - Important change in the logical window system. (See the changes
  157.         section for more details)
  158.       - Major change in the history buffer mechanics. The history
  159.         buffer list has changed (see 'TheWizardCorner')
  160.       - The File format of s:PowerVisor-config has changed !
  161.         Please delete this file first before you start the new version of
  162.         PowerVisor !!!
  163.       - Commandline options for PowerVisor are removed since they were
  164.         not very useful
  165.       - 'scan' works differently. You don't need to free the string
  166.         allocated with 'scan'. The pointer to the input string is
  167.         NOT returned in 'rc' but in the predefined constant 'INPUT'
  168.       - The number of pens in the pentable has changed from 16 to 24
  169.  
  170.  
  171. The development cycle
  172. ---------------------
  173.  
  174.    I started development of PowerVisor (February 1989) on an Amiga
  175.    500 with two diskdrives and one megabyte of memory. (except for
  176.    holidays, I only programmed in the weekends since I was at my
  177.    university for the rest of the week)
  178.    PowerVisor (at that time called 'PowerBase') was going to be a
  179.    structure viewer. The 'list' and 'info' commands are in fact the
  180.    most ancient commands in PowerVisor (except maybe the 'quit'
  181.    command :-)
  182.    At that time I did not think about writing a debugger. I could
  183.    not even write one if I wanted to. After all, PowerVisor was
  184.    only my second machinelanguage program on Amiga and I was still
  185.    learning machinelanguage.
  186.    (my first program in machinelanguage was a little program to
  187.    blink the powerled, I made this program together with someone
  188.    else :-)
  189.    (In fact PowerVisor is also my last machinelanguage program, I
  190.    normally program in C)
  191.  
  192.    I bought my first harddrive about five months later (30 megs).
  193.  
  194.    In September 1990 I bought my Amiga 3000/16/40! Needless to say
  195.    this was a great development boost. I almost immediatelly expanded
  196.    my Amiga to 4 megabytes of memory.
  197.  
  198.    In August 1991 I bought a second harddrive (52 megs) for my Amiga 3000.
  199.  
  200.    At this moment (February 1992) the PowerVisor source is
  201.    approximatelly 34000 lines long and all other ascii files
  202.    (help files, scripts, ...) are also approximatelly 34000 lines.
  203.  
  204.    Conclusion : If I were to start all over again, I would not use
  205.    machinelanguage (or perhaps only for the exception handling and
  206.    other special code). It is too much work. At this moment I don't
  207.    regret my choice of machinelanguage, but this is only because I
  208.    already have programmed all support routines and making some new
  209.    PowerVisor command or other feature is simply a matter of calling
  210.    the right routines (more or less).
  211.  
  212.  
  213. Bugs
  214. ----
  215.  
  216.    PowerVisor was programmed on an Amiga 3000 with AmigaDOS 2.0.
  217.    I have tested the program on AmigaDOS 1.3 and everything seemed
  218.    to work. I have not been able to test PowerVisor on any other
  219.    Amiga configuration.
  220.  
  221.    PowerVisor is a big program. This means that bugs are unavoidable.
  222.    If you find some bugs, or have some suggestions please write.
  223.    I'd like PowerVisor to be as bug free as possible.
  224.    In this distribution there is a file 'pv.bugs' describing all bugs
  225.    in the current version. Consult this file if you discover some
  226.    weird behaviour.
  227.  
  228.    Give (at least) the following information when you report a bug :
  229.  
  230.       - Hardware configurations you have used (if a bug occurs
  231.         on one hardware configuration but not on another one, please
  232.         give both hardware configurations)
  233.         Hardware configurations includes :
  234.                Processor (68000, 68010, 68020, 68030, 68040, ...)
  235.                Coprocessor (68881, 68882, ...)
  236.                MMU (68851, ...)
  237.                Amiga model (500, 1000, 2000, 2500/20, 2500/30, 3000/16,
  238.                   3000/25, 3000UX, 3000T, CDTV, ...)
  239.                Available memory (chip ram, fast ram, other, ...)
  240.                Harddisk information
  241.                Other hardware expansions (graphics card, sound card, ...)
  242.       - Software configuration you used
  243.         Software configuration includes :
  244.                Operating system (AmigaDOS 1.2, 1.3, 2.0, ...)
  245.                   If you can run more than one operating system on
  246.                   your Amiga, test the bug in the different versions
  247.                Version of KickStart and WorkBench (in Workbench
  248.                   about menu or with 'version' cli command)
  249.                Other programs running while the bug occurs (screen
  250.                   blankers, popup programs, ...)
  251.       - Describe the bug and the sequence of commands needed to
  252.         get the bug
  253.         Describe all output (including flashing lights, strange sounds,
  254.         noises, ...)
  255.  
  256. History
  257. -------
  258.  
  259.    V1.00 :
  260.       - first release (on tapserv and ab20.larc.nasa.gov)
  261.    V1.01 :
  262.       - Bug fix : when 'mode fancy', 'mode nofancy', 'mode lace'
  263.         or 'mode nolace' failed (for example, because there is
  264.         a visitor window open on the PowerVisor screen) we didn't
  265.         restore the current mode. This means that when you
  266.         tried again later (after closing the visitor window) PowerVisor
  267.         would ignore the command
  268.       - Bug fix : when the 'mode' command failes because there is
  269.         not enough memory, we first try again with the old mode
  270.         settings before quitting PowerVisor
  271.       - New feature : new 'stack' command and 'getstack' function to
  272.         monitor stack usage for a specific task. 'stack' uses the
  273.         timer.device for very fast respons
  274.       - We removed an obsolete feature from 'refresh'. The optional
  275.         command argument is no longer optional
  276.       - The standard logical window commands have an extra optional
  277.         argument. With this you can specify the number of lines for a
  278.         logical window
  279.       - The previous new feature is also included in the 'openlw' command
  280.       - Bug fix :Logical windows are much more stable with big fonts and
  281.         small visible sizes. No more crashes when the logical window is
  282.         too small
  283.       - Bug fix : parsing of [<x>] operator in alias strings was not
  284.         completely correct. Because we did not ignore the operator
  285.         if <x> was no digit we could not quote the operator. This is
  286.         solved
  287.       - New PowerVisor debug mode accessible with 'pvcall 17'. This
  288.         debug mode is useful if you want to debug aliases, scripts,
  289.         key attachements or other special things in PowerVisor. Every
  290.         command is printed on the screen before it is executed
  291.       - Bug fix : 'if' function now always correctly parses the
  292.         arguments. Because of some very obscure bug it could happen
  293.         that the 'if' function parsed to much characters from the
  294.         string
  295.       - Added strong quote operator in strings because I needed it
  296.         in the 'salias' alias
  297.       - The '#' operator is removed because the same functionality
  298.         is already present in the quote operator '\'. Just use
  299.         \(<x>,%s) instead of #<x>
  300.       - Behaviour of the 'eval' function has changed ! 'eval' now
  301.         expects a string pointer (or normal pointer) instead of
  302.         a string. This turned out to be more useful
  303.       - Limitation removed in 'colrow' and 'fit' commands. It is
  304.         now possible to size the 'debug' logical window
  305.       - Bug fix : The 'colrow' and 'fit' commands are now very stable.
  306.         When an out of memory error occurs, they simply try again for
  307.         the old values. If this also fails PowerVisor will quit
  308.         (in the previous version a command like 'colrow 30000 30000'
  309.         would crash your amiga)
  310.       - Behaviour changed for 'libfunc' command : the offset argument
  311.         must be negative and only the 16 least significant bits
  312.         are used. Thus something like $ff30 is a valid offset (this
  313.         is also the format given by the disassembler)
  314.       - Bug fix : The 'loadfd' command now handles multiple ##bias
  315.         statements in fd-files correctly. In V1.00 all functions
  316.         where correctly loaded but not correctly counted. The effect
  317.         of this was that 'info <fd node>' did not show all functions
  318.         in the fd-file
  319.       - Removed a completely useles feature from 'loadfd' : it is
  320.         no longer possible to specify the maximum number of functions
  321.         to load. 'loadfd' always loads the complete fd-file
  322.       - Added workbench startup
  323.       - Startup is cleaner. We don't crash anymore if the wrong
  324.         PowerVisor is used on the wrong operating system.
  325.         We are also a lot more stable in low memory conditions and
  326.         other wierd environments
  327.       - We didn't close dos.library
  328.       - New 'Aliases' reference file explaining all aliases defined
  329.         in s/PowerVisor-startup and s/pv/ExtraAliases
  330.       - New aliases in s/PowerVisor-startup (salias and fdebug)
  331.       - The 'db' script is better. Opens a fixed size logical window
  332.         so you don't need to size it everytime you use the fullscreen
  333.         debugger. 'db' also redefines 'fdebug' to clean up the
  334.         fullscreen debugger
  335.       - New 'ExtraAliases' script to define some extra aliases
  336.       - Created flexible install script
  337.    V1.10 :
  338.       - Bug fix : PowerVisor no longer crashes when a logical window
  339.         is made too small
  340.       - Removed incorrect statement in 'CommandReference' about 'fit'
  341.         and 'colrow' not suitable for the 'debug' logical window
  342.       - Incorrect statement in 'Screen' removed. The 'debug' logical
  343.         window is 90 columns instead of 82
  344.       - New function 'lastbytes'. This function returns the last number
  345.         of bytes used with the 'memory' or 'view' command
  346.       - New function 'lastlines'. This function returns the last number
  347.         of lines used with the 'unasm' command
  348.       - 'memory', 'view' and 'unasm' remember the number of bytes or lines
  349.         viewed (see the previous functions) and will continue with this
  350.         number at a later time
  351.       - New aliases 'cm', 'cv' and 'cu' to continue 'memory', 'view'
  352.         and 'unasm' respectivelly without setting a new address. You
  353.         can set the number of bytes or lines though
  354.       - Bug fix : we don't allow illegal variable names any more
  355.       - Finally all obsolete errors are removed
  356.       - Bug fix : 'LoadTags' and 'SaveTags' correctly handle structures.
  357.         When you try to load previously saved tags, PowerVisor will check
  358.         if the structure exists and will use this pointer instead of
  359.         the old one. If the structure does not exist, PowerVisor will
  360.         change the type of the tag to Long/Ascii and give a warning
  361.         at the end of the loading
  362.       - Behaviour changed : 'LoadTags' no longer clears the current tag
  363.         list but adds the tags from the file to the current tag list
  364.       - Note that the PVSD file format has changed (used for 'LoadTags'
  365.         and 'SaveTags'). PowerVisor does NOT understand the format
  366.         used by PowerVisor V1.00 and V1.01
  367.       - Install script is better. We check if the files exist before
  368.         we try to copy them. If a file doesn't exist we ask another
  369.         pathname to the user. This means that you can distribute
  370.         PowerVisor on different disks (in fact you will have to
  371.         distribute PowerVisor on different disks if you don't compress
  372.         the files). The installation script won't give errors because
  373.         of non existant files. Simply put the other disk in the drive
  374.       - We print more information in the cli structure (with the 'info'
  375.         command)
  376.       - New glossary file for explaining some specific PowerVisor
  377.         terminology
  378.       - 'Why' command is gone. It is more efficient to define an
  379.         alias for 'why' in s/PowerVisor-startup
  380.       - Some optimizations, PowerVisor is a bit shorter. This has
  381.         some effect on some internal fields. See the
  382.         'TheWizardCorner' file for more info about the format of
  383.         the commands in the routine table
  384.       - Because of the previous optimization there are no more commands
  385.         working in ARexx but not in PowerVisor and vice versa. You can
  386.         now use the 'front', 'hide', 'sync', ... commands in PowerVisor
  387.         too. And the 'clip' and 'remclip' commands work in ARexx
  388.       - Some new 'pvcall' functions for logical windows
  389.       - Bug solved in 'salias' alias. This alias loosed memory everytime
  390.         we runned it
  391.       - The 'co' function (or 'GetCode' ML-script) will not crash anymore
  392.         if used in AmigaDOS 1.3 with a non special key. The function will
  393.         return 0 instead
  394.       - A complete new directory 'PVDevelop' for the PowerVisor Wizards.
  395.         This subdirectory contains include files and libraries useful
  396.         to make ML-scripts in C or machinelanguage
  397.       - New assign : 'pv' to the root of the PowerVisor subdirectory.
  398.         This assign is only used by the develop files
  399.       - 'openlw', 'openpw', 'xwin', 'rwin', 'owin', 'awin' and 'dwin'
  400.         give an error when there is not enough memory. In the previous
  401.         version, the memory failure was simply ignored
  402.       - No more ugly flickering of the BUSY prompt when executing
  403.         ARexx scripts
  404.       - Bug solved in 'unasm' with very long instructions. The hexadecimal
  405.         words would overwrite the instruction
  406.       - New 'bin' alias in s/PowerVisor-startup to show the binary
  407.         representation of a number
  408.       - New 'asm' alias and s:pv/assem.pv ARexx program for a simple
  409.         assembler. See s:pv/assem.pv for more info about the assembler
  410.       - Two new 'pvcall' functions to disassemble one line of memory
  411.         in a string (s:pv/assem.pv uses this)
  412.       - The PowerVisor expression evaluator is more strict. You
  413.         MUST always close all brackets. I have done this because there were
  414.         some problems (especially in 'alias') if badly formed expressions
  415.         are used
  416.       - The same is true for the group operator
  417.       - New 'cmd' alias and ARexx script to execute Cli commands from
  418.         within PowerVisor
  419.       - Bug solved in strong quote parsing
  420.       - PowerVisor commands called from ARexx are not interruptable anymore
  421.         with <esc>
  422.       - Important change in the logical window system. Input is now local
  423.         to a logical window. This means that when a command waits for
  424.         input (either a line of input or a key (-MORE- for example)) all
  425.         other logical windows will be locked. This means that accidently
  426.         hitting a key will not have undesirable results. All input is
  427.         redirected to the active logical window (the one with the full
  428.         (blue) titlebar)
  429.       - <esc> and <ralt>-<help only work for the output appearing on the
  430.         'ACTIVE' logical window, so you have to use <tab> to interrupt a
  431.         command running on another logical window (also see the previous
  432.         item)
  433.       - Note that the stringgadget still behaves weird in AmigaDOS 1.3
  434.         If anyone out there knows a legal way to UNSELECT (UnActivate)
  435.         a stringgadget I would appreciate it very much. In AmigaDOS 2.0
  436.         simply removing the gadget and adding it again is enough to
  437.         unselect the gadget, but this does not seem true in AmigaDOS 1.3.
  438.       - New 'event' command to add an input event to the main handler.
  439.         This is useful for macros (key attachements)
  440.       - The AmigaDOS 1.2/1.3 version of PowerVisor doesn't need arp.library
  441.         anymore (I needed it only for the 32 bit multiply and divide. I
  442.         have now put these two routines in pv13)
  443.       - Fixed yet another bug in the structure viewing and the 'info'
  444.         command. If the list item in a structure was a string, there would
  445.         be some strange characters after the string
  446.       - Many bugs and errors are corrected in the online help and tutor
  447.         files
  448.       - AT LAST ! Mstruct is converted to AmigaDOS 1.2/1.3 ! Now you can
  449.         make your own structures and use them in PowerVisor even if you
  450.         don't use AmigaDOS 2.0
  451.       - Major change in the history buffer mechanics. The history buffer
  452.         now works like in the AmigaDOS 2.0 shell. It is no longer a
  453.         circular list (how coud I ever have such a bad idea :-)
  454.         This means of course that s:pv/PrintHist.pv, s:pv/SearchHist
  455.         and Source/SearchHist.asm have changed a bit. I hope you had not
  456.         written anything using the internal structure of the history
  457.         buffer, because you will have to change your programs if you did
  458.       - At last ! The autorepeat bug in the AmigaDOS 1.2/1.3 version of
  459.         PowerVisor is solved. You can now scroll in the history buffer and
  460.         in the logical windows with autorepeat
  461.       - Although it was already possible to set a font for a logical window,
  462.         this could not be done automatically and the stringgadget and
  463.         logical window size bars remained in topaz 8. Now it is possible to
  464.         set the default font for PowerVisor (with 'prefs font'). This font
  465.         is used for all new logical windows (you can of course still change
  466.         this font when the logical window is already open), for the
  467.         stringgadget, for the logical window size bars and for the screen.
  468.       - WARNING !!! The File format of s:PowerVisor-config has changed !
  469.         Please delete this file first before you start the new version of
  470.         PowerVisor !!!
  471.       - Commandline options for PowerVisor are removed since they were
  472.         not very useful
  473.       - All the 'prefs' commands have a more readable output. I use decimal
  474.         output when decimal is more appropriate than hexadecimal
  475.       - Some pvcall functions are removed because they were obsolete (Signal
  476.         command and IDCMP command)
  477.       - MAJOR ! The AmigaDOS 2.0 version of PowerVisor finally supports
  478.         menus. You can make your own menus with your favorite commands in
  479.         it. I'm very sorry, but this is only for the AmigaDOS 2.0 version
  480.       - When 'reqtools.library' (© Nico François) is available, PowerVisor
  481.         will use this library for requesters with the new commands :
  482.             'reqload', 'reqsave', 'request' and 'getstring'
  483.         Otherwise, simple PowerVisor constructions are automatically used :
  484.             'scan', 'key()'
  485.       - There is a new predefined constant 'input'. This constant contains
  486.         the pointer to the last input string (with 'scan', 'getstring',
  487.         'reqload' and 'reqsave'). You don't have to worry anymore about
  488.         freeing all the strings allocated with 'scan'
  489.       - Bug fix in 'debug l' and 'debug n'. We did loose some memory when
  490.         the loading failed or when 'debug n' was interrupted by the user
  491.       - More predefined pens (24 instead of 16), 19 of these pens are used
  492.       - Four new pens for the colours of the stringgadget (only AmigaDOS 2.0)
  493.       - Bug fixed in 'symbol' command. PowerVisor sometimes said there were
  494.         no symbols even if it previously loaded them. This bug was harmless
  495.         but I fixed it anyway :-)
  496.    V1.11 :
  497.       - We look at PROGDIR: in AmigaDOS 2.0 to see where our files are
  498.         This means that the following path is used for the
  499.         PowerVisor-startup, PowerVisor-menus, PowerVisor-help,
  500.         PowerVisor-ctrl and PowerVisor-errors files :
  501.             First check PROGDIR: (only AmigaDOS 2.0)
  502.             Check S:
  503.             Check current directory
  504.         In practice this means that you can keep this files together
  505.         with PowerVisor
  506.       - PowerVisor1.0.task is renamed to PowerVisor.task
  507.       - intuition.struct is expanded to handle almost all Intuition
  508.         structures
  509.       - Bug fix in 'trace c' (conditional trace) command. This command only
  510.         occasionally worked. In most cases this command would return an
  511.         error. This is fixed
  512.       - 'break c' is also fixed (the same bug as in 'trace c')
  513.    V1.12 :
  514.       - Some errors fixed in the include files. dbn_LoadedSegment is
  515.         a BPTR and not an APTR
  516.       - Bug in 'tags' command solved. This command was broken in V1.11 (and
  517.         maybe earlier)
  518.       - Bug in include files solved. We don't use absolute pathname anymore
  519.         in the .i include files for the PVMemory.i include file. If you have
  520.         any problems with this you should include this file first in your
  521.         source before you include any of the other include files. This should
  522.         solve all possible problems
  523.       - ScreenBase.i and ScreenBase.h contained a double declaration of
  524.         'LockPrompt'. The second 'LockPrompt' has been changed to
  525.         'PtrLockPrompt'
  526.       - Floating point debugging is fixed for AmigaDOS 2.04 (V37.175)
  527.       - Primitive support for floating point debugging with the 'fregs'
  528.         command. This command displays the 8 floating point registers for
  529.         a task (only if the task uses floating point) in the internal
  530.         format (the format used on the Exec stackframe). Wait for future
  531.         releases for more and better floating point support
  532.       - New 'debug u' command. Use this command instead of 'debug r' when
  533.         you have used 'debug l'. If you have used 'debug n' it is often
  534.         better to use the old 'debug r'
  535.       - Little change in assembler (assem.pv). Addressing mode (4) will
  536.         default to (4).l (for example)
  537.       - PowerVisor uses the Exec CacheClearU function to clear the cache
  538.         (after setting breakpoints for example) instead of own routines
  539.         if AmigaDOS 2.0 is used
  540.    V1.13 :
  541.       - Bug solved in 'GeneralBase.h'
  542.       - Bug solved in 'debug', 'break' and 'symbol' if no arguments were
  543.         given to the command
  544.       - You can now use the '@sr' register in register assignment and
  545.         you can also use the value of '@sr'
  546.       - '@a7' is now equivalent to '@sp'
  547.       - Bug solved in the changing of the stackpointer '@sp=xxx'
  548.       - New 'scratch' option for the 'addfunc' command. This option makes
  549.         the scratch registers ('d1', 'a0' and 'a1') illegal
  550.       - The 'mmuregs' command should work with an 68020/68851 (I hope)
  551.       - New option added to the 'debug' command ('c'). With this option
  552.         you can catch the next task in the system (not the next process
  553.         like 'debug n')
  554.       - Powerful new command to track the usage of resources for a
  555.         task or process ('track'). Note that this command is not
  556.         completely ready. In future I plan more extensive checking.
  557.         There should also be a easy way to let a program run and
  558.         stop it before it quits. That way you can better examine
  559.         what went wrong
  560.       - Symbols are correctly loaded in all cases (I hope). Previously
  561.         PowerVisor would load incorrect symbols if there were hunks
  562.         without symbols in the file. This is solved
  563.       - Bug in the window system solved. Autoscale (-1,-1) did not
  564.         work as described in the manual
  565.       - Bug solved in 'prefs pens' command. It was not possible to set
  566.         a pen number greater than 32
  567.       - Two new pens defined for hilighting. There is also support
  568.         for hilighted text
  569.       - Source level debugging implemented for 'Macro68'. New 'source'
  570.         command. This source level debugging is still rather primitive.
  571.         In future more features and easier ways to scroll will be added
  572.       - Source level debugging implemented for SAS/C. Compile C program
  573.         with '-d1' option (must be 1 !) to use
  574.       - The fullscreen debugger also uses hilighting instead of the '|'
  575.         character to indicate the program counter
  576.       - The 'refresh' command does not require the 'Refresh' logical window
  577.         to be open. If this window is not open, the output will be send to
  578.         the current logical window
  579.       - New 'Source' logical window (with corresponding 'swin' command) for
  580.         the source level debugger. Note that this means that you have
  581.         to delete the old 'PowerVisor-config' file before you run the new
  582.         PowerVisor
  583.       - There are more menus in the PowerVisor-menus file
  584.       - The 'icopy' script and the 'CopyLogWin' and 'GetLogWin' programs have
  585.         been recompiled because the internal 'ScreenBase' structure has
  586.         changed
  587.       - New arguments for 'mode' command: 'intui' and 'nointui'. When 'intui'
  588.         is set all standard window command ('xwin', 'awin', 'dwin', ...) will
  589.         open a new physical window (Intuition window) that contains the
  590.         standard logical window
  591.       - When a physical window opens, PowerVisor no longer activates this
  592.         window
  593.       - 's:pv/PrintMode.pv' has been changed to incorporate the new 'mode'
  594.         variables
  595.       - Bug solved in the handling of requesters with ReqTools. When you
  596.         changed the PowerVisor screen, PowerVisor would sometimes prevent
  597.         requesters from appearing. This is now solved
  598.       - 'prefs startup' and 'prefs window' have been removed. 'SaveConfig'
  599.         will automatically look at the current window size and position
  600.         and use the information from that. This approach is much more
  601.         userfriendly
  602.       - You can scroll in the source with the mouse (source level debugging)
  603.       - Source level debugging seems to work for Devpac3 too
  604.       - Bug solved in the scroll routine (bug was not visible)
  605.       - The MMU commands should work on a 68020/68851. Previously this was
  606.         not the case
  607.       - The 'mmuregs' command shows a 68851 only register: 'DRP' if you
  608.         have a 68851. I have not been able to test this feature (I have
  609.         a 68030)
  610.       - 'mmuregs' will print '(na)' (not available) for all registers
  611.         not available on your Amiga
  612.       - The 'debug' command is MUCH better if you have AmigaDOS 2.0 (I'm
  613.         sorry for all the 1.3 users). 'debug' does not loose any memory
  614.         (as far as I have been able to test) and you can use 'debug u'
  615.         with a program loaded with 'debug n'.
  616.         I used the new 'CreateNewProc' function in AmigaDOS 2.0 to achieve
  617.         these results
  618.       - If you have AmigaDOS 2.0, 'debug l' will create a CLI structure
  619.         for the process. Previously this was not the case, making it almost
  620.         impossible to use 'debug l' on programs supporting the Workbench
  621.         (The startup code would assume the program was started from
  622.         Workbench because there was no CLI, and would wait in vain for the
  623.         Workbench message)
  624.  
  625.  
  626. All files
  627. ---------
  628.  
  629.      PowerVisorLib (dir)      This subdirectory contains files needed
  630.                               to use to powervisor.library in your programs
  631.  
  632.        pv_lib.fd              fd-file containing function definitions for
  633.                               the powervisor.library functions
  634.        pv_lib.h               C header file containing pragmas for the
  635.                               powervisor.library functions. This file
  636.                               is written for Lattice C 5.0. If you use
  637.                               another compiler (like Aztec) you may
  638.                               need to rewrite this file. If you use a
  639.                               C compiler with no support for pragmas you
  640.                               must make stubs to call the library functions
  641.        pv_lib.i               Machinelanguage header file.
  642.  
  643.      c (dir)                  This subdirectory contains all executable
  644.                               files. All files ending with '13' are for
  645.                               AmigaDOS 1.3.
  646.  
  647.        ArcFiles               The QuickHelp utilities for AmigaDOS 2.0
  648.        Help                   Read docs/help.doc for more info
  649.        MakeHelp
  650.  
  651.        ArcFiles13             The QuickHelp utilities for AmigaDOS 1.3
  652.        Help13                 Read docs/help13.doc for more info
  653.        MakeHelp13
  654.  
  655.        MStruct                Program to convert pseudo include files to pvsd
  656.                               files.
  657.                               This program will be enhanced in future
  658.                               to support full include files.
  659.        MStruct13              AmigaDOS 1.3 version of MStruct
  660.        pv                     AmigaDOS 2.0 version of PowerVisor
  661.        pv13                   AmigaDOS 1.3 version of PowerVisor
  662.        Input                  Little program needed for the installation
  663.                               script. 'Input' prints the first argument
  664.                               on the screen and waits for input. The input
  665.                               is put in the specified file (second argument).
  666.                               Syntax : Input <prompt line> <file name>
  667.        DevName                Little program needed for the installation
  668.                               script. 'DevName' reads the first line from
  669.                               a file and replaces the same file with another
  670.                               file containing only this first line altered
  671.                               in the following way :
  672.                                  if the first line ends with a ':' nothing
  673.                                  happens
  674.                                  If the first line ends with a '/' nothing
  675.                                  happens
  676.                                  Otherwise a '/' is appended to the first
  677.                                  line
  678.                               Syntax : DevName <file name>
  679.        DirName                Little program needed for the installation
  680.                               script.  'DirName' is equivalent to 'DevName'.
  681.                               'DirName' removes the last character of the
  682.                               first line if it is a '/'.
  683.                               Syntax : DirName <file name>
  684.  
  685.      libs (dir)               All libraries needed by PowerVisor
  686.  
  687.        powervisor.library     This library is needed by PowerVisor
  688.  
  689.      docs (dir)               All documents for PowerVisor
  690.  
  691.        GettingStarted         Read this file if you are a first-time user
  692.        Aliases                This file explains everything about the
  693.                               aliases defined in s/PowerVisor-startup
  694.                               and s/pv/ExtraAliases
  695.        Expressions            All about expression evaluation in PowerVisor
  696.        Screen                 Everything about screens and windows
  697.        InstallingPowerVisor   How to install PowerVisor
  698.        Scripts                Everything about scripts (ARexx, ...)
  699.        LookingAtThings        How to look at memory, disassemble, ...
  700.        Debug                  How to debug programs
  701.  
  702.        CommandReference       All PowerVisor commands explained
  703.        Functions              All PowerVisor functions explained
  704.        Lists                  All lists
  705.  
  706.        Glossary               The PowerVisor glossary, reading this file is
  707.                               a very good way to learn all (or most)
  708.                               PowerVisor terminology
  709.  
  710.        TechnicalInfo          Some technical information
  711.        TheWizardCorner        Only for VERY experienced users. Using this
  712.                               file you can customize PowerVisor to enormous
  713.                               degrees. Look in the 'Source' directory for
  714.                               examples using information from this file.
  715.                               Also look at the 'PVDevelop' directory useful
  716.                               for making your own powerful scripts (and
  717.                               ML-scripts)
  718.  
  719.        Global.index           The index for all above files
  720.  
  721.        GettingStarted.idx     The individual index files for all tutor
  722.        Expressions.idx        and reference files
  723.        Screen.idx
  724.        Aliases.idx
  725.        InstallingPowerVisor.idx
  726.        Scripts.idx
  727.        LookingAtThings.idx
  728.        Debug.idx
  729.        CommandReference.idx
  730.        Functions.idx
  731.        Lists.idx
  732.        TechnicalInfo.idx
  733.        TheWizardCorner.idx
  734.  
  735.        Screen.contents        The contents files for all tutor files
  736.        GettingStarted.contents
  737.        Aliases.contents
  738.        Expressions.contents
  739.        InstallingPowerVisor.contents
  740.        Scripts.contents
  741.        LookingAtThings.contents
  742.        Debug.contents
  743.        CommandReference.contents
  744.        Functions.contents
  745.        Lists.contents
  746.        TechnicalInfo.contents
  747.        TheWizardCorner.contents
  748.  
  749.        Help.doc               Manual for QuickHelp
  750.        Help13.doc             Manual for QuickHelp 1.3
  751.  
  752.        CancelDouble           This program cancels all double lines in
  753.                               a file. This program is used by
  754.                               'MakeGlobalIndex'
  755.        CancelDouble.c         The source for 'CancelDouble'. You should
  756.                               be able to compile this program on any
  757.                               C-compiler
  758.        ExtractIndex.rexx      This rexx script is used by 'MakeIndex' to
  759.                               construct the index file for one individual
  760.                               tutor file
  761.        ExtractIndexSE.rexx    This rexx script is used by 'MakeIndex.se' to
  762.                               construct the index file for one individual
  763.                               tutor file
  764.        MakeGlobalIndex        This script file combines all index files
  765.                               made by 'MakeIndex' to make the global index
  766.        MakeIndex              Make the index and contents file for one
  767.                               tutorial file.
  768.                               This version uses the 'egrep' (or 'gnugrep')
  769.                               command by 'Free Software Foundation, Inc.'
  770.                               This version is faster than 'MakeIndex.se'
  771.                               but you need 'egrep' of course ('egrep'
  772.                               is not distributed with PowerVisor)
  773.        MakeIndex.se           Make the index and contents file for one
  774.                               tutorial file. This version uses the
  775.                               standard AmigaDOS 'search' command, but it
  776.                               is slower
  777.  
  778.      Source (dir)             This subdirectory contains sources for
  779.                               various scripts and example programs
  780.                               included with PowerVisor
  781.  
  782.        FreeError.asm          These two programs crash your Amiga,
  783.        stackovf.asm           except when PowerVisor is running (I hope)
  784.                               Executables for these files are in the
  785.                               'Examples' subdirectory
  786.  
  787.        BuggyProgram.asm       Example programs used in the 'debug' tutorial
  788.        BuggyProgram2.asm      file. Executables for these files are in the
  789.                               'Examples' subdirectory
  790.  
  791.        CheckBrackets.c        Program to check brackets. Executable file
  792.                               is in 's/pv'. Source is for Lattice C 5.0
  793.                               only
  794.        GetCode.c              Program to compute the keycode for a named
  795.                               key. Executable file is in 's/pv'. Source is
  796.                               for Lattice C 5.0 only
  797.        GetQual.c              Program to compute the keyqualifier for a
  798.                               named qualifier. Executable file is in 's/pv'.
  799.                               Source is for Lattice C 5.0 only
  800.  
  801.        Exec.struct            PowerVisor source for 'Exec' structure
  802.                               definitions.
  803.                               pvsd file is in 's/pv'
  804.        intuition.struct       PowerVisor source for 'Intuition' window
  805.                               structure definition.
  806.                               pvsd file is in 's/pv'
  807.  
  808.        mkeys.explained        Same script file as 's/pv/mkeys' but with
  809.                               a lot of comments
  810.  
  811.        pptest.asm             Program to test the powervisor.library.
  812.                               Use as an example. Executable file is in
  813.                               the 'Examples' subdirectory
  814.        takeme.asm             Program to test 'debug t'
  815.                               Executable file is in the 'Examples'
  816.                               subdirectory
  817.        SearchHist.asm         Source for history search program. Executable
  818.                               file is in 's/pv'
  819.  
  820.  
  821.      PVDevelop (dir)          This subdirectory contains include files and
  822.                               libraries useful for PowerVisor Wizards. There
  823.                               are include files for C and machinelanguage
  824.  
  825.        include (dir)          Subdirectory containing all include files
  826.                               for PowerVisor (except for the
  827.                               powervisor.library include files because these
  828.                               are in another subdirectory)
  829.  
  830.           PV (dir)            The recomended place for the include files
  831.  
  832.             ARexxBase.h       The ARexx Base structures
  833.             ARexxBase.i
  834.             DebugBase.h       The Debug Base structures
  835.             DebugBase.i
  836.             EvalBase.h        The Eval Base structures
  837.             EvalBase.i
  838.             FileBase.h        The File Base structures
  839.             FileBase.i
  840.             GeneralBase.h     The General Base structures
  841.             GeneralBase.i
  842.             ListBase.h        The List Base structures
  843.             ListBase.i
  844.             MainBase.h        The Main Base structures
  845.             MainBase.i
  846.             MemoryBase.h      The Memory Base structures
  847.             MemoryBase.i
  848.             ScreenBase.h      The Screen Base structures
  849.             ScreenBase.i
  850.             PVCallRoutines.h  Protos for the PVCall routines
  851.             PVCallTable.h     Table with PVCall routine numbers
  852.             PVCallTable.i
  853.             PVMemory.h        PowerVisor memory allocation structures
  854.             PVMemory.i
  855.  
  856.           Lib (dir)           All the C libraries (for SAS/C) to make
  857.                               calling PVCall functions from C easier
  858.  
  859.             PVCallStub.lib    The library for small code
  860.             PVCallStubNB.lib  The library for large code
  861.  
  862.             Source (dir)      The source for these libraries
  863.  
  864.               README          A README explaining some things. If you
  865.                               'execute' this file, the two libraries
  866.                               will be build again
  867.  
  868.               PVCallStub.i    Include file needed for all functions
  869.  
  870.               makefile        makefile used by 'README'
  871.  
  872.               PVCBeep.asm     All sources for all PVCall functions
  873.               PVCError.asm
  874.               PVCAddAutoClear.asm
  875.               PVCAddGlobalAutoClear.asm
  876.               PVCAddStringToHist.asm
  877.               PVCAdvanceHistory.asm
  878.               PVCAllocPVBlock.asm
  879.               PVCAppendString.asm
  880.               PVCCallMLScript.asm
  881.               PVCClosePVHandle.asm
  882.               PVCCompareStrings.asm
  883.               PVCComputeGadgetSignal.asm
  884.               PVCConvertAlias.asm
  885.               PVCCopyString.asm
  886.               PVCCreateConstant.asm
  887.               PVCCreateFunction.asm
  888.               PVCErrorHandler.asm
  889.               PVCEvaluate.asm
  890.               PVCFreePVBlock.asm
  891.               PVCGetARexxBase.asm
  892.               PVCGetDebugBase.asm
  893.               PVCGetEvalBase.asm
  894.               PVCGetExecLevel.asm
  895.               PVCGetFileBase.asm
  896.               PVCGetGeneralBase.asm
  897.               PVCGetHistoryLine.asm
  898.               PVCGetListBase.asm
  899.               PVCGetMainBase.asm
  900.               PVCGetMemoryBase.asm
  901.               PVCGetModeRoutines.asm
  902.               PVCGetRexxList.asm
  903.               PVCGetRoutines.asm
  904.               PVCGetScreenBase.asm
  905.               PVCGetSnapBuffer.asm
  906.               PVCGetStringGadget.asm
  907.               PVCGetStringGBuf.asm
  908.               PVCGetStringInfo.asm
  909.               PVCGetVarAddress.asm
  910.               PVCInstallPostCmd.asm
  911.               PVCInstallPreCmd.asm
  912.               PVCInstallQuitCmd.asm
  913.               PVCInstallSnapCmd.asm
  914.               PVCLowerHistory.asm
  915.               PVCParseString.asm
  916.               PVCPrint.asm
  917.               PVCPrintNum.asm
  918.               PVCReAllocPVMemoryBlock.asm
  919.               PVCReAllocPVQuickBlock.asm
  920.               PVCRefreshLogWin.asm
  921.               PVCRefreshStringG.asm
  922.               PVCRemoveGlobalAutoClear.asm
  923.               PVCRemVar.asm
  924.               PVCSetCursorPos.asm
  925.               PVCSetDebugMode.asm
  926.               PVCSkipSpaces.asm
  927.               PVCSnapWord.asm
  928.               PVCDisassemble.asm
  929.               PVCCmdDisassemble.asm
  930.               PVCPutChar.asm
  931.  
  932.      s (dir)                  Online help and scripts
  933.  
  934.        PowerVisor-menus       Only for the AmigaDOS 2.0 version. This
  935.                               file contains the description of the menus
  936.                               used in PowerVisor. The format is not
  937.                               difficult. You can change this file if
  938.                               you'd like other menus
  939.        PowerVisor-help        Online help file. This file contains all
  940.                               online help and the templates. You can't
  941.                               use 'help' and 'why' when this file is
  942.                               not present. Note that the online help
  943.                               file is not the good place to start learning
  944.                               PowerVisor. Use the tutorial files in the
  945.                               'docs' subdirectory for that purpose.
  946.        PowerVisor-ctrl        Online help control file. Use the QuickHelp
  947.                               utilities to update this file when you
  948.                               have changed something in the PowerVisor-help
  949.                               file. You need this file if you want
  950.                               online help
  951.        PowerVisor-errors      All error messages for PowerVisor. You need
  952.                               this file if you want to make errors :-)
  953.                               No, you need this file if you want to see
  954.                               a sensible error message.
  955.                               Each line in this file must be 70 bytes
  956.        PowerVisor-startup     The startup script for PowerVisor. This
  957.                               script installs various new commands and
  958.                               keys
  959.  
  960.           pv (dir)            This subdirectory contains all scripts you
  961.                               can use
  962.  
  963.             db                PowerVisor script to install the fullscreen
  964.                               debugger. This script also assigns some
  965.                               keys to useful debugging commands
  966.             ExampleSetting    PowerVisor script to show an other window
  967.                               configuration posibility. Use as an example
  968.                               for more useful settings
  969.             ExtraAliases      This file contains some extra useful
  970.                               aliases not defined in the s/PowerVisor-startup
  971.                               file
  972.             icopy             PowerVisor script to install a logical window
  973.                               copy feature. Press 'Shift-PrtSc' to store
  974.                               the active logical window in an internal
  975.                               buffer. Press 'PrtSc' to retrieve this buffer
  976.                               into another active logical window.
  977.                               This script uses 'GetLogWin' and 'CopyLogWin'
  978.             CheckBrackets     ML script to check for brackets in the
  979.                               commandline. Source is in the 'Source'
  980.                               subdirectory. See the 's/Powervisor-startup'
  981.                               file for an example of how to install this
  982.                               feature
  983.             GetCode           ML script to compute the code of a named
  984.                               key. Source is in the 'Source' subdirectory.
  985.                               Note that if you have AmigaDOS 1.3 you can
  986.                               only use this script to compute the code
  987.                               of special keys (like 'enter' and 'esc')
  988.                               and not of normal keys (like 'a', '3', ...).
  989.                               This script is installed as a function in the
  990.                               's/PowerVisor-startup' file
  991.             CopyLogWin        ML script to copy the active logical window
  992.                               to a buffer. This script is used by 'icopy'.
  993.                               Source is in the 'Source' directory
  994.             GetLogWin         ML script to copy a buffer to the active
  995.                               logical window. This script is used by 'icopy'.
  996.                               Source is in the 'Source' directory
  997.             GetQual           ML script to compute the qualifier of a named
  998.                               qualifier. Source is in the 'Source'
  999.                               subdirectory. This script is installed as a
  1000.                               function in the 's/PowerVisor-startup' file
  1001.             SearchHist        ML script to search in the history buffer.
  1002.                               Source is in the 'Source' subdirectory. This
  1003.                               script is installed on a key in the
  1004.                               's/PowerVisor-startup' file
  1005.             ikey              This PowerVisor script installs various
  1006.                               special features
  1007.             mkeys             PowerVisor script for a memory display
  1008.                               utility
  1009.             PrintHist.pv      ARexx script to print the contents of the
  1010.                               current history buffer
  1011.             PrintMode.pv      ARexx script to print the current mode
  1012.                               setting in a readable format
  1013.             ShowAscii.pv      ARexx script to show all ascii chars on the
  1014.                               PowerVisor window
  1015.             Assem.pv          Little ARexx assembler. Use the 'asm' alias
  1016.                               defined in s:PowerVisor-startup to call this
  1017.                               script. See the script for more info about
  1018.                               the script
  1019.             intuition.pvsd    pvsd file for the Window structure.
  1020.                               Source is in the 'Source' subdirectory
  1021.             Exec.pvsd         pvsd file for all Exec structures
  1022.                               Source is in the 'Source' subdirectory
  1023.  
  1024.      Examples (dir)           This subdirectory contains some example
  1025.                               programs. Sources for most of these programs
  1026.                               can be found in the 'Source' subdirectory
  1027.  
  1028.        BuggyProgram           Programs used in the 'Debug' tutor file
  1029.        BuggyProgram2
  1030.  
  1031.        crash3                 Some crash programs
  1032.        crash4
  1033.        crash5
  1034.        crash8
  1035.        crasha
  1036.        freeerror
  1037.        stackovf
  1038.  
  1039.        pptest                 powervisor.library test program
  1040.        takeme                 'debug t' test program
  1041.  
  1042.   ReadThisFirst               This file
  1043.   pv.bugs                     All bugs in the current version of Powervisor
  1044.   Install                     Execute this file to install PowerVisor
  1045.                               or click on icon from WorkBench
  1046.   Install.script              Install script used by 'Install' (Don't
  1047.                               execute this)
  1048.  
  1049.  
  1050. Environment
  1051. -----------
  1052.  
  1053.    PowerVisor normally does not expect special assignments or such.
  1054.    s/PowerVisor-startup however does expect 'fd' to be assigned to
  1055.    the subdirectory containing fd-files (at least exec_lib.fd,
  1056.    dos_lib.fd, graphics_lib.fd and intuition_lib.fd). If you do not
  1057.    have these fd-files (note that you can find them on the AmigaDOS
  1058.    1.3 Extras disk) you must remove four lines in s/PowerVisor-startup
  1059.    starting with '-lfd'. You will not be able to use the library
  1060.    functions defined in the fd-files if you do this (Note that
  1061.    PowerVisor makes very good use of these fd-files, so I recommend
  1062.    that you install them if you have a harddisk).
  1063.  
  1064.    s/PowerVisor-startup also expects the following files in the
  1065.    s:pv directory : db, CheckBrackets, GetCode, GetQual and SearchHist.
  1066.  
  1067.    You can of course adapt s:PowerVisor-startup to your own wishes.
  1068.  
  1069.  
  1070.    If you have reqtools.library (by Nico François) PowerVisor will use
  1071.    it for requesters. In the next distribution of PowerVisor, reqtools
  1072.    will probably be included with all the other files.
  1073.  
  1074.  
  1075.    If you use AmigaDOS 1.2 or 1.3 I recommend that you use
  1076.    'FastFonts' (FF) by C.Heath. This program greatly speeds up the
  1077.    PowerVisor display. This is not necessary in AmigaDOS 2.0 since
  1078.    Commodore did a good optimizing job.
  1079.  
  1080.    If you use AmigaDOS 1.2, 1.3 or 2.0 and you have a fast processor
  1081.    (68020 or higher) I recommend that you use 'CpuBlit' by Eddy Carroll.
  1082.    This program gives an even greater speed increase.
  1083.  
  1084.  
  1085. Installation
  1086. ------------
  1087.  
  1088.    Installing PowerVisor should be easy. Simply execute 'Install' (with
  1089.    the current directory set to the root directory of the PowerVisor
  1090.    distribution) or double click on the icon.
  1091.    You will get an interactive install session.
  1092.  
  1093.    Note that the installation script has only been tested in WorkBench 2.0.
  1094.    I hope it works with WorkBench 1.3. The installation script does NOT
  1095.    work with WorkBench 1.2. I tried to make the script as simple as
  1096.    possible but I failed :-)
  1097.  
  1098.    (Note! It appears that the script does not work in 1.3, I will try to
  1099.    fix it)
  1100.  
  1101.    Note that the script needs the following cli commands :
  1102.       - setenv       (builtin command in AmigaDOS 2.0)
  1103.       - if           (builtin command in AmigaDOS 2.0)
  1104.       - else         (builtin command in AmigaDOS 2.0)
  1105.       - endif        (builtin command in AmigaDOS 2.0)
  1106.       - skip         (builtin command in AmigaDOS 2.0)
  1107.       - lab          (builtin command in AmigaDOS 2.0)
  1108.       - ask          (builtin command in AmigaDOS 2.0)
  1109.       - echo         (builtin command in AmigaDOS 2.0)
  1110.       - endcli       (builtin command in AmigaDOS 2.0)
  1111.       - makedir
  1112.       - copy
  1113.       - version
  1114.       - delete
  1115.       - dir
  1116.       - input        (included in the PowerVisor distribution)
  1117.       - devname      (included in the PowerVisor distribution)
  1118.       - dirname      (included in the PowerVisor distribution)
  1119.  
  1120.  
  1121. Tutor files
  1122. -----------
  1123.  
  1124. Here are all the files in the prefered order to read them
  1125.  
  1126. tutor files :
  1127.  
  1128.    GettingStarted             For the first time user
  1129.    Expressions                Very important to read
  1130.    Screen
  1131.    InstallingPowerVisor
  1132.    LookingAtThings
  1133.    Debug
  1134.    Scripts
  1135.  
  1136. reference files :
  1137.  
  1138.    CommandReference           Very useful file
  1139.    Functions
  1140.    Aliases
  1141.    Lists
  1142.    TechnicalInfo
  1143.  
  1144. if you want to look up a specific word :
  1145.  
  1146.    Glossary
  1147.  
  1148. for very experienced users :
  1149.  
  1150.    TheWizardCorner            Only read if you are a PowerVisor wizard !!!!!
  1151.  
  1152.  
  1153.  
  1154. Authors
  1155. -------
  1156.  
  1157.    André Pelckmans for the disassembler
  1158.    Jorrit Tyberghein for the rest
  1159.  
  1160.  
  1161. Address
  1162. -------
  1163.  
  1164.    Jorrit Tyberghein
  1165.    Hepmansbossen 31
  1166.    B-2450 Meerhout
  1167.    BELGIUM
  1168.  
  1169.  
  1170. Thanks to
  1171. ---------
  1172.  
  1173.    André Pelckmans for his disassembler and for giving me all
  1174.    the programming help I need.
  1175.    Without him I wouldn't have a computer in the first place (I think).
  1176.  
  1177.    Nico François for his debugging, his numerous remarks and suggestions.
  1178.    Without him PowerVisor would have looked COMPLETELY different :-)
  1179.    (and without him I would have to use two disks to backup the source
  1180.    of PowerVisor)
  1181.  
  1182.    Nico François for his WONDERFUL reqtools.library. If you want to use
  1183.    well designed, flexible and powerful requesters there is no better choice
  1184.  
  1185.    Ives Aerts for his useful suggestions and criticism.
  1186.  
  1187.    Adam Hill, Christian Weber, Steven Reiz and Dominic Giampaolo
  1188.    for their bug reports and suggestions.
  1189.  
  1190.    Some extra thanks to Adam Hill for his efforts to arouse
  1191.    interrest in PowerVisor (in BIX for example).
  1192.  
  1193.    Adriaan van den Brand for his good suggestions and information
  1194.  
  1195.    The software people at Commodore for their VERY USEFUL debugging
  1196.    tools (like 'Enforcer', 'MungWall', ...).
  1197.    And also for their presence on usenet.
  1198.  
  1199.    To my parents of course.
  1200.  
  1201.    Also thanks to the Amiga computer for being an Amiga.
  1202.  
  1203.                __
  1204.               ///
  1205.              ///
  1206.             ///
  1207.    __      ///
  1208.    \\\    ///       Amiga, the computer for the creative mind
  1209.     \\\  ///
  1210.      \\\///
  1211.       \XX/
  1212.  
  1213.  
  1214.