home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / programming / debug-utils / pv / howtoinstall < prev    next >
Encoding:
Text File  |  1992-11-03  |  19.5 KB  |  461 lines
  1.  
  2. |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|
  3. | How To Install?                                  Mon Nov  2 22:03:14 1992 |
  4. |___________________________________________________________________________|
  5.  
  6.  
  7.  
  8. Installation for AmigaDOS 2.0 or 3.0
  9. ------------------------------------
  10.  
  11.    If you have a harddisk (and about 3 megabytes free) the easiest way to
  12.    install PowerVisor is to make a subdirectory named 'PowerVisor' and
  13.    extract the PowerVisor archive in that subdirectory. After that
  14.    double click on the 'InstallPV' icon and installation (with many
  15.    confirm options) will start (in another subdirectory). After
  16.    installation simply remove the 'PowerVisor' subdirectory. (Note
  17.    that you must have the 'Installer' program (© Commodore) to use
  18.    the 'InstallPV' script. If you don't have this program you must use
  19.    the manual installation method described below).
  20.  
  21.    If you don't have a harddisk or you don't have enough free harddisk
  22.    space, but you do have a lot of memory you can also make the
  23.    'PowerVisor' subdirectory on your RAM: disk and repeat the above
  24.    procedure.
  25.  
  26.    If you don't have a harddisk and you don't have enough memory you
  27.    can make use of the fact that the 'Docs' and 'PVDevelop' subdirectories
  28.    need not be on the same disk or volume as the rest of the PowerVisor
  29.    archive. You can easily put 'Docs', 'PVDevelop' or both on another
  30.    disk or volume. The install script will notice the missing subdirectories
  31.    and will ask for the other disk. Please remember that you MUST use
  32.    the subdirectories on these other disks even if the disk only contains
  33.    one sort of files. Thus, the disk with the manual MUST contain
  34.    a 'Docs' subdirectory containing all the manual files.
  35.    Warning! Please give each disk you use another name, otherwise there
  36.    might be problems.
  37.  
  38.  
  39. Manual installation for AmigaDOS 2.0 or 3.0
  40. -------------------------------------------
  41.  
  42.    If you don't have 'Installer' or you want to install PowerVisor manually
  43.    (because you distrust my install script) you must install PowerVisor
  44.    manually. Just perform the following steps one by one. Not all steps
  45.    are needed. The advantages of all steps are explained below.
  46.    Note that I assume that your harddisk or disk is called 'work:'. If this
  47.    is not the case just replace 'work:' by the correct name everywhere in
  48.    these steps. Also note that some installation techniques are recommended
  49.    above others. The recommended method is always the one that is also
  50.    compatible with the 1.3 version of PowerVisor unless otherwise noted.
  51.  
  52.    To install a minimal PowerVisor execute the following steps :
  53.  
  54.       o The best way is probably to make a subdirectory (called 'PV' for
  55.         example) where you can put all PowerVisor files.
  56.         Add the following line to your S:user-startup or S:startup-sequence :
  57.  
  58.             assign pv: work:pv
  59.  
  60.       o Make a subdirectory called 'c' in the 'PV' subdirectory and put
  61.         the 'pv' executable there.
  62.  
  63.       o Adjust your path or let c: assign to that subdirectory (with the
  64.         AmigaDOS 2.0 multiple assign feature) like this
  65.         (add to S:user-startup or S:startup-sequence) :
  66.  
  67.             path pv:c add      (recommended)
  68.  
  69.         or
  70.  
  71.             assign c: pv:c add
  72.  
  73.       o Copy the 'powervisor.library' to your LIBS: directory (recommended)
  74.         or make a subdirectory 'libs' in the 'PV' subdirectory and put the
  75.         library there. In the last case you must also use the multiple assign
  76.         feature like this (add to S:user-startup or S:startup-sequence) :
  77.  
  78.             assign libs: pv:libs add
  79.  
  80.    You now have a minimal installation of PowerVisor. This is just enough
  81.    to run PowerVisor, but you will have no online help, no error messages
  82.    (only numbers), no manual, no examples, no PowerVisor-startup file
  83.    (containing useful PowerVisor extensions), no menus, no reqtools
  84.    requesters (unless you already have reqtools), ...
  85.  
  86.    Use the following step(s) if you want online help, error messages and
  87.    menus :
  88.  
  89.       o Copy the following files to the same directory where you put the
  90.         executable ('pv') (recommended if you plan to use PowerVisor only
  91.         in AmigaDOS 2.0) or put them in your S: subdirectory (only
  92.         recommended if you plan to use PowerVisor in AmigaDOS 1.3 now and
  93.         then) :
  94.  
  95.             PowerVisor-help.qq  (or PowerVisor-help)
  96.             PowerVisor-ctrl
  97.             PowerVisor-menus
  98.             PowerVisor-errors
  99.  
  100.         All files ending with '.qq' are compressed. Use the 'dc' utility
  101.         in the archive to decompress them like this :
  102.  
  103.             dc PowerVisor-help.qq PowerVisor-help 4
  104.             delete PowerVisor-help.qq
  105.  
  106.         You won't need the 'dc' utility for anything else. Delete it when
  107.         you are ready with it (after the installation, you may need it
  108.         once more for parts of the manual).
  109.  
  110.    Use the following step(s) if you want to use reqtools requesters in
  111.    PowerVisor (some of the PowerVisor-scripts and some of the menus use
  112.    these requesters. If reqtools.library (© Nico François) is not available,
  113.    PowerVisor uses very primitive replacements) :
  114.  
  115.       o Copy 'reqtools.library' to LIBS: (recommended) or to the same place
  116.         you put 'powervisor.library'. Note that you must make sure that you
  117.         don't overwrite a more recent version of reqtools. Check the version
  118.         with the following commands :
  119.  
  120.             version reqtools.library
  121.  
  122.         and
  123.  
  124.             (first make sure that the reqtools.library from the PowerVisor
  125.             archive is in RAM:)
  126.             lha x pv.lha libs/reqtools.library ram: (or something like this)
  127.             version ram:reqtools.library file
  128.  
  129.         If the second version is more recent you should copy the newer
  130.         reqtools.library over the old one (probably somewhere in LIBS:)
  131.  
  132.    When PowerVisor starts it will execute the S:PowerVisor-startup file if
  133.    this file exists. The PowerVisor-startup file from the archive is rather
  134.    useful and installs some nice new commands and features. It is highly
  135.    recommended. Note that you should also install all example PowerVisor
  136.    scripts if you install the PowerVisor-startup file because some of these
  137.    example scripts are used in the startup script.
  138.  
  139.       o Copy 'PowerVisor-startup' to your S: directory (recommended)
  140.         or make a subdirectory 's' in the 'PV' subdirectory and put the
  141.         file there. In the last case you must also use the multiple assign
  142.         feature like this (add to S:user-startup or S:startup-sequence) :
  143.  
  144.             assign s: pv:s add
  145.  
  146.       o Make a subdirectory 'pv' somewhere in S:
  147.         Note that it is best to put all PowerVisor scripts (except the
  148.         PowerVisor-startup script) in 'S:pv' because then you don't need
  149.         to type this pathname when you use the 'script' command (PowerVisor
  150.         automatically looks in that subdirectory)
  151.  
  152.       o Put all example scripts from the archive (in subdirectory 's/pv')
  153.         in that new subdirectory
  154.  
  155.       o The included PowerVisor-startup file also needs FD: assigned to
  156.         the subdirectory containing your fd-files. Fd-files are files
  157.         containing information about Amiga library functions. If you don't
  158.         have these files (note that you can find the AmigaDOS 1.3 fd-files
  159.         on the Extras 1.3 disk) you must delete the four lines in the
  160.         PowerVisor-startup file starting with '-lfd', otherwise add
  161.         the following line to your S:user-startup or S:startup-sequence :
  162.  
  163.             assign fd: <subdir for fd-files>
  164.  
  165.    Execute the following steps to install the manual (which can also be
  166.    used as an enhanced online help file if you have MultiView
  167.    (© Commodore) :
  168.  
  169.       o Make a subdirectory called 'docs' in the 'PV' subdirectory (this
  170.         place is only important if you plan to use MultiView. MultiView
  171.         will look for the documentation in 'pv:docs')
  172.  
  173.       o Copy all files from the archive (the complete 'docs' subdirectory)
  174.         to the new 'docs' subdirectory
  175.  
  176.       o It is possible that the 'CommandRef.guide' file is compressed
  177.         (to make it possible that the manual fits on one old filesystem
  178.         disk). If this is the case it will be named 'CommandRef.guide.qq'.
  179.         Decompress it with the 'dc' utility like this :
  180.  
  181.             dc CommandRef.guide.qq CommandRef.guide 4
  182.             delete CommandRef.guide.qq
  183.  
  184.         You won't need the 'dc' utility for anything else. Delete it when
  185.         you are ready with it
  186.  
  187.       o If you have MultiView you can use it to read the documentation.
  188.         You can also start MultiView from within PowerVisor (with 'ahelp',
  189.         'cmdhelp' and 'funhelp') so you have a magnificent online help
  190.         environment. If this is the case you can delete the following
  191.         files :
  192.  
  193.             ConvertGuide2Doc
  194.             ConvertGuide2Doc.c
  195.             doc.info
  196.             ConvertDoc.script
  197.  
  198.       o If you don't have MultiView but you don't mind the MultiView
  199.         commands in the manual you can also delete the previous files
  200.         like in the previous step
  201.  
  202.       o If you don't have MultiView and you want to convert the manual
  203.         to a more readable (readable with a normal textviewer, that is)
  204.         format you must follow the following procedure :
  205.  
  206.             cd pv:docs
  207.             for each #?.guide file do
  208.  
  209.                ConvertGuide2Doc #?.guide #?.doc (don't use wildcards,
  210.                                                 replace with correct
  211.                                                 filename)
  212.                delete #?.guide
  213.                delete #?.guide.info
  214.                copy doc.info #?.doc.info
  215.  
  216.         After this you can delete the four files like in the previous
  217.         steps
  218.  
  219.       o The 'docs' subdirectory also contains a 'searchit' program. This
  220.         program is used by the 'index' alias defined in the
  221.         PowerVisor-startup file. If you have the 'ixemul.library' it is
  222.         probably best to replace 'searchit' by 'searchit.gcc' because
  223.         this version is much faster and shorter :
  224.  
  225.                copy searchit.gcc searchit
  226.  
  227.         You can delete 'searchit.lc' and 'searchit.gcc' after that.
  228.         You can also delete 'searchit.c' if you don't want to look
  229.         at the source
  230.  
  231.    There are some additional utilities that you can use to enhance some
  232.    features of PowerVisor. Execute the following steps to install them :
  233.  
  234.       o If you want to change the online help (PowerVisor-help) you need
  235.         the 'QuickHelp' utilities. Copy the following files in the same
  236.         subdirectory where the 'pv' executable is located :
  237.  
  238.             MakeHelp
  239.             ArcFiles
  240.             Help
  241.  
  242.       o If you want to make your own structure files (see the 'addstruct'
  243.         command) you must copy the 'MStruct' utility in the same
  244.         subdirectory where the 'pv' executable is located
  245.  
  246.    If you also want to run PowerVisor in AmigaDOS 1.3 (or 1.2) you must
  247.    also copy the 1.3 versions of all executable programs. All 1.3 versions
  248.    have the same name extended with 13.
  249.  
  250.       o Copy the wanted files to the same subdirectory as 'pv' :
  251.  
  252.             pv13
  253.             MStruct13
  254.             MakeHelp13
  255.             ArcFiles13
  256.             Help13
  257.  
  258.    If you want you can also copy the additional 'Examples', 'Source' and
  259.    'PVDevelop' subdirectories. PowerVisor does not need these. They are
  260.    for your information only.
  261.  
  262.    This concludes the manual installation for AmigaDOS 2.0.
  263.  
  264.  
  265. Manual installation for AmigaDOS 1.3 (or 1.2)
  266. ---------------------------------------------
  267.  
  268.    Follow these steps if you want to install PowerVisor for AmigaDOS 1.3.
  269.    Just perform the following steps one by one. Not all steps are needed.
  270.    The advantages of all steps are explained below.
  271.    Note that I assume that your harddisk or disk is called 'work:'. If this
  272.    is not the case just replace 'work:' by the correct name everywhere in
  273.    these steps. Also note that some installation techniques are recommended
  274.    above others. Note that if you install PowerVisor like described below
  275.    you will not be able to run PowerVisor in AmigaDOS 2.0. If you want
  276.    to use PowerVisor in AmigaDOS 2.0 and AmigaDOS 1.3 at the same time you
  277.    must follow the AmigaDOS 2.0 installation procedure.
  278.  
  279.    To install a minimal PowerVisor execute the following steps :
  280.  
  281.       o The best way is probably to make a subdirectory (called 'PV' for
  282.         example) where you can put all PowerVisor files.
  283.         Add the following line to your S:user-startup or S:startup-sequence :
  284.  
  285.             assign pv: work:pv
  286.  
  287.       o Make a subdirectory called 'c' in the 'PV' subdirectory and put
  288.         the 'pv13' executable there (if you want you can rename it to
  289.         'pv')
  290.  
  291.       o Adjust your path like this  (add to S:user-startup or
  292.         S:startup-sequence) :
  293.  
  294.             path pv:c add
  295.  
  296.       o Copy the 'powervisor.library' to your LIBS: directory
  297.  
  298.    You now have a minimal installation of PowerVisor. This is just enough
  299.    to run PowerVisor, but you will have no online help, no error messages
  300.    (only numbers), no manual, no examples, no PowerVisor-startup file
  301.    (containing useful PowerVisor extensions), no reqtools requesters
  302.    (unless you already have reqtools), ...
  303.  
  304.    Use the following step(s) if you want online help, error messages and
  305.    menus :
  306.  
  307.       o Copy the following files to S:
  308.  
  309.             PowerVisor-help.qq  (or PowerVisor-help)
  310.             PowerVisor-ctrl
  311.             PowerVisor-errors
  312.  
  313.         All files ending with '.qq' are compressed. Use the 'dc' utility
  314.         in the archive to decompress them like this :
  315.  
  316.             dc PowerVisor-help.qq PowerVisor-help 4
  317.             delete PowerVisor-help.qq
  318.  
  319.         You won't need the 'dc' utility for anything else. Delete it when
  320.         you are ready with it (after the installation, you may need it
  321.         once more for parts of the manual).
  322.  
  323.    Use the following step(s) if you want to use reqtools requesters in
  324.    PowerVisor (some of the PowerVisor-scripts use these requesters. If
  325.    reqtools.library (© Nico François) is not available, PowerVisor uses
  326.    very primitive replacements) :
  327.  
  328.       o Copy 'reqtools.library' to LIBS:
  329.         Note that you must make sure that you don't overwrite a more recent
  330.         version of reqtools. Check the version with the following commands :
  331.  
  332.             version reqtools.library
  333.  
  334.         and
  335.  
  336.             (first make sure that the reqtools.library from the PowerVisor
  337.             archive is in RAM:)
  338.             lha x pv.lha libs/reqtools.library ram: (or something like this)
  339.             type ram:reqtools.library opt h
  340.  
  341.         If the second version is more recent you should copy the newer
  342.         reqtools.library over the old one (in LIBS:)
  343.  
  344.    When PowerVisor starts it will execute the S:PowerVisor-startup file if
  345.    this file exists. The PowerVisor-startup file from the archive is rather
  346.    useful and installs some nice new commands and features. It is highly
  347.    recommended. Note that you should also install all example PowerVisor
  348.    scripts if you install the PowerVisor-startup file because some of these
  349.    example scripts are used in the startup script.
  350.  
  351.       o Copy 'PowerVisor-startup' to your S: directory
  352.  
  353.       o Make a subdirectory 'pv' in S:
  354.         Note that it is best to put all PowerVisor scripts (except the
  355.         PowerVisor-startup script) in 'S:pv' because then you don't need
  356.         to type this pathname when you use the 'script' command (PowerVisor
  357.         automatically looks in that subdirectory)
  358.  
  359.       o Put all example scripts from the archive (in subdirectory 's/pv')
  360.         in that new subdirectory
  361.  
  362.       o The included PowerVisor-startup file also needs FD: assigned to
  363.         the subdirectory containing your fd-files. Fd-files are files
  364.         containing information about Amiga library functions. If you don't
  365.         have these files (note that you can find the AmigaDOS 1.3 fd-files
  366.         on the Extras 1.3 disk) you must delete the four lines in the
  367.         PowerVisor-startup file starting with '-lfd', otherwise add
  368.         the following line to your S:user-startup or S:startup-sequence :
  369.  
  370.             assign fd: <subdir for fd-files>
  371.  
  372.    Execute the following steps to install the manual (which can also be
  373.    used as an enhanced online help file if you have MultiView
  374.    (© Commodore) :
  375.  
  376.       o Make a subdirectory called 'docs' in the 'PV' subdirectory (this
  377.         place is only important if you plan to use MultiView. MultiView
  378.         will look for the documentation in 'pv:docs')
  379.  
  380.       o Copy all manual files from the archive (the complete 'docs' sub-
  381.         directory) to the new 'docs' subdirectory
  382.  
  383.       o It is possible that the 'CommandRef.guide' file is compressed
  384.         (to make it possible that the manual fits on one old filesystem
  385.         disk). If this is the case it will be named 'CommandRef.guide.qq'.
  386.         Decompress it with the 'dc' utility like this :
  387.  
  388.             dc CommandRef.guide.qq CommandRef.guide 4
  389.             delete CommandRef.guide.qq
  390.  
  391.         You won't need the 'dc' utility for anything else. Delete it when
  392.         you are ready with it
  393.  
  394.       o If you have MultiView you can use it to read the documentation.
  395.         You can also start MultiView from within PowerVisor (with 'ahelp',
  396.         'cmdhelp' and 'funhelp') so you have a magnificent online help
  397.         environment. If this is the case you can delete the following
  398.         files :
  399.  
  400.             ConvertGuide2Doc
  401.             ConvertGuide2Doc.c
  402.             doc.info
  403.             ConvertDoc.script
  404.  
  405.       o If you don't have MultiView but you don't mind the MultiView
  406.         commands in the manual you can also delete the previous files
  407.         like in the previous step
  408.  
  409.       o If you don't have MultiView and you want to convert the manual
  410.         to a more readable (readable with a normal textviewer, that is)
  411.         format you must follow the following procedure :
  412.  
  413.             cd pv:docs
  414.             for each #?.guide file do
  415.  
  416.                ConvertGuide2Doc #?.guide #?.doc (don't use wildcards,
  417.                                                 replace with correct
  418.                                                 filename)
  419.                delete #?.guide
  420.                delete #?.guide.info
  421.                copy doc.info #?.doc.info
  422.  
  423.         After this you can delete the four files like in the previous
  424.         steps
  425.  
  426.       o The 'docs' subdirectory also contains a 'searchit' program. This
  427.         program is used by the 'index' alias defined in the
  428.         PowerVisor-startup file. If you have the 'ixemul.library' it is
  429.         probably best to replace 'searchit' by 'searchit.gcc' because
  430.         this version is much faster and shorter.
  431.  
  432.                copy searchit.gcc searchit
  433.  
  434.         You can delete 'searchit.lc' and 'searchit.gcc' after that.
  435.         You can also delete 'searchit.c' if you don't want to look
  436.         at the source
  437.  
  438.    There are some additional utilities that you can use to enhance some
  439.    features of PowerVisor. Execute the following steps to install them :
  440.  
  441.       o If you want to change the online help (PowerVisor-help) you need
  442.         the 'QuickHelp' utilities. Copy the following files in the same
  443.         subdirectory where the 'pv13' (or 'pv') executable is located :
  444.  
  445.             MakeHelp13
  446.             ArcFiles13
  447.             Help13
  448.  
  449.         If you want you can remove the '13' suffix from their names
  450.  
  451.       o If you want to make your own structure files (see the 'addstruct'
  452.         command) you must copy the 'MStruct13' utility in the same
  453.         subdirectory where the 'pv13' (or 'pv') executable is located
  454.  
  455.  
  456.    If you want you can also copy the additional 'Examples', 'Source' and
  457.    'PVDevelop' subdirectories. PowerVisor does not need these. They are
  458.    for your information only.
  459.  
  460.    This concludes the manual installation for AmigaDOS 1.3.
  461.