@DATABASE SIP_Documentation
@WIDTH 80

##
## For reading this file you may use :
##
##  Program-Name    available at
##
##  - AmigaGuide    (various Packages)
##  - MultiView     (Workbench)
##

@NODE MAIN "SIP V3.7 : Documentation"

                                    SIP V3.7

                                - POSTCARDWARE -

             © 1992-97 by Andreas R. Kleinert. All rights reserved.

              Needs Kickstart V2.04. Kickstart release 3.x compatible.
              GUI created with Designer 1.54.

              The "identify.library", (C) 1996 by Richard Körber,
              will be used when available.

              Supports PowerPC (TM) via powerUP (TM).

              Release Date : 27.05.1997


@{"Copyright"              LINK Copyright}
@{"Disclaimer"             LINK Disclaimer}
@{"Distribution"           LINK Distribution}
@{"Function"               LINK Function}
@{"Correspondence"         LINK Correspondence}
@{"History"                LINK History}

@{fg highlight}
                          _ //
                     Only \\X/ Amiga makes it possible!
@{fg text}


                             Please visit:

                 @{"http://www.amigaworld.com/support/" SYSTEM "AWeb-II:AWeb-II URL http://www.amigaworld.com/support/"} (AWeb-II)


     The CHAOS theory:

     @{i}"Like finding that bloody butterfly whose flapping
      wings cause all these storms we've been having lately
      and getting it to stop."@{ui} (see "Witches Abroad" by Terry Pratchett)


     Ahm...well:

     @{i}...and thanks for all the fish.@{ui}

@ENDNODE

@NODE "Copyright"

    The program SIP V3.7 and its documentation files are
    (C)opyright 1992-97 by Andreas R. Kleinert. All rights reserved.

    Some of the mentioned names or products may be copyrighted by
    companies or trademarks of companies.

@ENDNODE

@NODE "Disclaimer"

    The author takes no responsibility for any results of the use of this
    program.
    This software is provided "AS IS" and there is no warranty of any kind,
    so that you use this software at your own risk.

@ENDNODE

@NODE "Distribution"

    The program SIP V3.7 is freely distributable (FREEWARE).
    You may copy it, if the copyright notice is left intact and
    all of its parts are included in the distribution.
    This program must not be included in commercial packages or commercial
    program collections without my written permission.
    This program must not be sold in any way, but it is allowed to take
    a nominal fee including the costs for copying.

    This program may be put on public domain disks or included in public
    domain disk libraries.
    Special permission hereby goes to Fred Fish's AmigaLib-Disks and
    the german series (in alphabetical order) :
    AmigaSzene, BerndsPD, FRANZ, GPD, SaarAG, TAIFUN and TIME.

    This program may also be distributed via electronic mail and may be
    put into mailboxes as long as the redistribution conditions are
    respected in all points.

    By using or distributing this program you automatically agree to
    all of the above conditions and terms.

@ENDNODE

@NODE "Function"

    Intention :
    ===========

    "SIP" stands for "System Information Program".

    SIP may look very similar to other programs with similar intentions,
    but has really nothing to do with them except of the task to fulfil.

    What I wanted to create, was a program that should bring the same comfort
    to you as other programs, but which also should be compatible to the new
    OS 2.04 and use the special features of the new Kickstart.


    Function :
    ==========

    SIP allows you to watch and manipulate most of the elementary parts of
    the Operating System of your Amiga, as (e.g.) Tasks, Libraries, Devices,
    Ports and Windows.
    It also brings you the possibility of viewing some of the most important
    vectors in the system and to clear them, to make sure to keep your system
    free of viruses and all the other garbage which affects working with
    your Amiga.

    SIP has been written under V3.1 of the AmigaOS and only runs under
    OS V2.04+.


    Usage :
    =======

        Function-Overview :
        -------------------

     Gadget              Function
     ----------------------------------------------------------------------

     Tasks               Shows Tasks by name and more
                         (divided into Exec Tasks/Processes
                          and PPC Tasks)
     Windows             Shows Screens and Windows by name
     Libraries           Shows Libraries by name and more
     Devices             Shows Devices by name and more
     Resources           Shows Resources by name and more
     Ports               Shows Ports by name and more
     Residents           Shows Residents by name and more
     Interrupts          Shows Interrupts by number and more
     Vectors             Shows some vectors (CoolCapture, etc.)
     Memory              Shows information about memory
     Mount               Shows all mounted devices by name
     Assign              Pops up a File-Requester to show assigns and volumes
     Fonts               Pops up a Font-Requester to show all available fonts
     Hardware            Gives some information about the Hardware


     Action-Gadget       Function
     ----------------------------------------------------------------------

     Remove!             a) Removes a Task/Window/Library/Device/Resource/
                            Port or Interrupt.
     Clear!              b) Clears Cold-/Cool- and WarmCapture entries in
                            SysBase.

     Priority!           Sets new Priority for a Task/Library/Device/Resource/
                         Port or Resident.

     <Close-Gadget>      (see Menus : "Quit")


     Menu                   Function
     ----------------------------------------------------------------------

     Project/Help           Opens the AmigaGuide Online-Help
            /Info           Opens the Info-Window of SIP
            /Start WB       Starts the Workbench
            /Quit           Opens the Iconify-Requester
     Switch/SIP Dos Tools   Switches to the "SIP Dos Tools"


     In the Iconify-Requester you may choose between three possibilities :

                           - Cancel                       1. Go back.

                                                          2. Iconify
                           - O.K.                       /
                                                        \
                                                          3. Really Quit


       Notes :
       ~~~~~~~

       - "Iconify" saves some memory (GUI, Lists, etc.)

       - You may click on all the gadgets without destroying anything,
         EXCEPT the following gadgets :

          - Remove!     Remove s.th., if s.th. is chosen
          - Priority!   Set priority, if s.th. is chosen

       Here's an example, how to "Remove!" a Task from the system :

       Example :
       ---------

               Action         Gadget / Text to select
               --------------------------------------

               <Clicked on>   Tasks
               <Selected>     "Background CLI"
               <Clicked on>   Remove!

               Then you'll see, that the task "Background CLI" will have been
               removed.


     SIP Dos Tools :
     ---------------

     In the Menu "SIP Dos Tools" you may view Bootblocks of Disks
     (DF1: to DF3:) or format Disks or Dos-Volumes (DF1: bis DF3,
     any Devices).

     Please note, that for formatting of 720 KB-Disks the appropriate
     Handlers (PC0: bis PCx:) have to be mounted and that Quick-Formatting
     of Amiga- to 720 KB-Disks or of 720 KB- to Amiga-Disks cannot work.
     Therefore for this, as well as for new Disks, please select
     Hard-Formatting.
     Also the maximum length for the name of 720 KB-Disks is 12 characters :
     the rest will be ignored.

     For Hard-Formatting "SYS:System/Format" is used.

@ENDNODE

@NODE "Correspondence"


                           SuperView WWW Sites
             http://home.t-online.de/home/Andreas_Kleinert/
                http://www.amigaworld.com/support/sview/


   _________________________________________________________
  |      You may reach me the following way.                |
  |    Send bug-reports, money or whatever to:              |
  |---------------------------------------------------------|
  |        * SuperView Development & Registration *         |
  |          * DRAFU Development & Registration *           |
  |       * Image Engineer Registration Site Europe *       |
  |                                                         |
  |                                                         |
  |                  PerSuaSiVe SoftWorX                    |
  |                                                         |
  |                  Andreas R. Kleinert                    |
  |                  Sandstrasse 1                          |
  |                  D-57072 Siegen                         |
  |                  Germany, Europe                        |
  |                                                         |
  | Any snail mail to the old address will still be routed. |
  |                                                         |
  |                  Phone:  +49-271-22869 also FAX + AM    |
  |                          +49-271-22838                  |
  |                                                         |
  |                  Weekdays after 17.00h.                 |
  |                                                         |
  |         When calling via phone you may leave a message, |
  |         if I'm not available - but don't expect me      |
  |         calling back to USA, Australia, ... since       |
  |         german phone rates are HIGHLY expensive.        |
  |_________________________________________________________|

  EMail:

        Please send binaries via ARK@News.wwbnet.de, and keep
        them smaller than 16 KB. Please think twice before
        sending them - my postbox is not unlimited in size.

        * Do not send binaries via Fido or Fido-Gates ! *

           - Fido   Andreas Kleinert 2:2457/350.18
           - Usenet
                    ARK@superview.ftn.neckar-alb.de  (Fido-Gate)
                    Andreas_Kleinert@t-online.de     (T-Online)
                    ARK@News.wwbnet.de               (Z-Netz)
                    ARK@amigaworld.com               (AmigaWorld)

           - If nothing else works, try one of these public
             Fido-Usenet gateways:

               In Germany:
                 Andreas_Kleinert@p18.f350.n2457.z2.fido.sub.org

               From USA or elsewhere:
                 Andreas_Kleinert@p18.f350.n2457.z2.fidonet.org


When reporting any bugs, please don't forget to include a detailed
description of the bug and tell me, if it is reproduceable or not.
Please also mention the version number of SIP you used and describe
your system configuration (Amiga model 500/.../4000T-060, Kickstart/OS,
RAM, HardDisk, special configurations).

@ENDNODE

@NODE "History"

     V3.7 (27.5.97):
     ---------------
      - added another quick hack to display information on powerUP (TM)
        tasks currently running
      - GUI really needs to be made font-sensitive...

     V3.6 (15.5.97):
     ---------------
      - added quick hack to recognize powerUP (TM) boards
        (not with identify.library being installed)

     V3.5 (7.4.97):
     ---------------
      - 060 recognition did not work (argh)
        (-> Rolf Mueller, various)
      - no, there is no OS 3.4

     V3.4 (31.3.97):
     ---------------
      - changed startup codec
      - no more CTRL-C possible
      - again small fix to "Handler" code
      - differently optimized
      - small changes

     V3.3 (3.1.97):
     --------------
      - completely recompiled with SAS/C V6.57
      - did always crash when trying to access keymap.resource as
        library node. Now bypassed.
        (-> Sascha Teichmann)
      - of course OS 3.1 has been used for development, OS 3.2
        was a typo

     V3.2 (12.9.96):
     ---------------
      - fixed version string
      - fixed bug in "Handler" enlistment
      - there are still possibly two EHits in "Handler" enlistment,
        but it seems, as if a bug in RAW-Handler is the reason
      - "Assign" now creates and shows own list; was buggy as well
      - KickTag listing (still) was buggy and produced hits
      - fixed small bug in "Hardware" section
      - and more little changes

     V3.1 (4.9.96):
     --------------
      - recompiled with SAS/C V6.56
      - using utility.library, using new GST,
        now caching SysBase, change compiler options, etc.
      - fixed several Enforcer Hits:
         - Closegadget
         - Resources enlistment
         - Handler enlistment
      - reworked Resources enlistment
      - reworked Handler enlistment
      - removed superview/superplay facilities
      - switched GUI-Engine from GadToolsBox to Designer
      - now recognizes 68060
      - now does support Richard Körber's "identify.library"

****************************************************************************
Version history before V3.1 no longer included
****************************************************************************

@ENDNODE
