@DATABASE AKCC_Documentation
@WIDTH 80

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

@NODE MAIN "AKCC Documentation"


                            AKCC V6.8

                        - POSTCARDWARE -

             © 1989-2008 by Andreas R. Kleinert. All rights reserved.

              Needs Kickstart V1.2. Kickstart release 3.x compatible.

              This program needs 'akccplus.library' V37+ in LIBS.
              Supports whatis.library V1+, which is (C)1990,1992
              by Sylvain Rouger and Pierre Carette.
              The "identify.library", (C) 1996-99 by Richard Körber,
              will be used when available.

              Release Date : 06.01.2008


                                @{"Copyright"           LINK Copyright}
                               @{"Disclaimer"           LINK Disclaimer}
                              @{"Distribution"          LINK Distribution}
                                @{"Function"            LINK Function}
                              @{"Installation"          LINK Installation}
                             @{"Correspondence"         LINK Correspondence}
                            @{"Command overview"        LINK CommandSummary}
                             @{"Version-History"        LINK History}

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


     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 AKCC V6.8 and its documentation files are
    (C)opyright 1989-2008 by Andreas R. Kleinert. All rights reserved.

    This program is POSTCARDWARE.
    Send the author a postcard to his snail mail address, if you like
    and use this program or you'd like something to criticize.

    whatis.library V1+ is (C)1990,1992 by Sylvain Rouger and Pierre Carette.
    identify.library V1+ ist (C) 1996-99 by Richard Körber.

    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 AKCC V6.8 is freely distributable (POSTCARDWARE).
    You may copy it, if the copyright notice is left intact and
    all of its parts are included in the distribution.

    But it is explicitely allowed, e.g. to put the AKCC-Commands onto
    Disk-Magazines or PD-Series, as long as there is a remark about the
    author, the copyright and the used version of AKCC.

    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 TAIFUN, FRANZ, TIME, GPD and Amiga Szene.

    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"

    AKCC V6.8 is a packet of CLI-/Shell-Commands for the Amiga, which
    is intended to make working with the AMIGA, especially for experienced
    users and programmers, but also beginners, somewhat easier.
    AKCC is intended to be additionally used with other existing CLI-/Shell-
    Packets (e.g. with those from ARP or Commodore).

    There are as well programs which just replace similar ones, as well as
    programs, which are completely new.

@ENDNODE

@NODE "Installation"

    Use the supplied Installer-Script to install AKCC.

    If you do not own "Installer" yet, you have to install
    AKCC by yourself :

    Copy the AKCC Commands to C: or any other search-path
    and install "akccplus.library" to LIBS:.

    Perhaps it would be useful to create the "ENV:" directory,
    if not already done (OS 1.2 users).

    Also stack-size should be placed on a relatively high level
    to allow recursive operations when handling wildcards.

    Last not least :
    All of the commands can be made memory-resident with the
    corresponding CLI/Shell-Command (p-flag already set).

@ENDNODE

@NODE "Correspondence"

  ** General WWW Site is http://www.ar-kleinert.de **
   _________________________________________________________
  |      You may reach me the following way:                |
  |---------------------------------------------------------|
  |                  Dipl.-Ing.                             |
  |                  Andreas R. Kleinert                    |
  |                  Düsseldorfer Str. 114                  |
  |                  D-51063 Cologne                        |
  |                  Germany, Europe                        |
  |                                                         |
  |                  +49-221-2973442                        |
  |                  (also FAX + AM)                        |
  |                                                         |
  |                  Weekdays after 20.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 ask before sending binaries!
        And please think twice before asking - my postbox
        is not unlimited in size.

           - Usenet
              >>>   info@ar-kleinert.de
                    Andreas_Kleinert@gmx.de

@ENDNODE

@NODE "CommandSummary"

    Each single 'AKCC'-Command prints out a short desrciption of itself,
    when it is started with a single '?' as its only parameter.
    This description always looks like this :

                  'USAGE : x <x> <x> [...]'

    The same thing happens, if a command has been used wrongly, but only
    if it has not been used TOO WRONG ...


    @{"AboutCLI" LINK AboutCLI}                         @{"AD" LINK AD}         *
    @{"CheckExec" LINK CheckExec}                        @{"Comment" LINK Comment}    *
    @{"DateAct" LINK DateAct}                          @{"Display" LINK Display}
    @{"DosRequest" LINK DosRequest}                       @{"Duplic" LINK Duplic}     *
    @{"EnvAct" LINK EnvAct}                           @{"ExecDevs" LINK ExecDevs}
    @{"ExecIRupts" LINK ExecIRupts}                       @{"ExecLibs" LINK ExecLibs}   *
    @{"ExecMem" LINK ExecMem}                          @{"ExecPorts" LINK ExecPorts}
    @{"ExecRes" LINK ExecRes}                          @{"ExecSems" LINK ExecSems}
    @{"ExecTasks" LINK ExecTasks}                        @{"ExtShow" LINK ExtShow}    *
    @{"FullPath" LINK FullPath}                         @{"HunkShow" LINK HunkShow}
    @{"KAssign" LINK KAssign}    *                     @{"Kill" LINK Kill}       *
    @{"KillTask" LINK KillTask}   *                     @{"KInfo" LINK Kinfo}
    @{"KScroller" LINK KScroller}                        @{"LED" LINK LED}
    @{"Move" LINK Move}       *                     @{"NewDir" LINK NewDir}
    @{"NewName" LINK NewName}                          @{"ProSet" LINK ProSet}     *
    @{"PriSet" LINK PriSet}     *                     @{"Texter" LINK Texter}
    @{"Show" LINK Show}       *
    @{"WinAct" LINK WinAct}

    Commands marked with a '*' support WildCards ('*'/'?'/'#?') and/or the
    recursive method of working on directories (option '-a').

    Under OS V2.04+ the normal DOS-WildCards are ADDITIONALLY
    supported (inclusive WildStar, e.g. "(Hello#?|World*)" ).

    Commands with "-a"-Support:
    ---------------------------
    "-a" stands for "-all" and describes recursive, that means
    (in this case) complete access to ALL sub-directories by the
    specific command.

    Commands with "*"/"#?"/"?" WildCard-Support:
    --------------------------------------------
    These WildCards are equivalent to the Standard-AmigaDOS-WildCards
    "#?" and the ARP-WildCard "*" (as under MS-DOS or other Operating
    Systems). It is also possible to use more than one WildCard in a
    name-descriptor, which is not common to all of the Standard-
    AmigaDOS-Commands (especially under OS <= V1.3) :

    e.g. : - Kill Vie*l*

             (deletes e.g. "Viele", "VielMehr", "VierBilder", etc.)

           - ExtShow sta*t*

              or

             ExtShow sta#?t#?

             (lists e.g. "startup-sequence".)

    The special SingleChar-WildCard of AmigaDOS ("?") is also supported,
    which allows to replace only one (or none) char instead of an unlimited
    number.

    All users of OS V2.04 or greater have ADDITIONALLY access to the new
    WildCards of V37-DOS, so that at first DOS-PatternMatching is used,
    and if the pattern "still does not fit" after that, the internal
    routines of "akccplus.library" are used instead.
    This results in the following additional WildCards :

        ~                         logical NOT

        (String_1|...|String_n)   logical OR  (brackets allowed)

    Combinations are possible.
    Also the "WildStar" ("*") can be used, because the "akccplus.library"
    activates it automatically.

@ENDNODE

@NODE AboutCLI "AboutCLI            (similar: -)"
    Provides information about some preferences of the (current) CLI:
    Stacksize, Prompt, Path, ...

@ENDNODE

@NODE AD "AD                  (similar: CD)"
    Changes the current directory. WildCards and Backward-References
    possible.

    Known Bugs:

    Some Shells, like the OS-2.04+-Shell, or the 'WShell', which
    shows the current directory in the title bar of the window or
    in the prompt of the command-line, don't examine the changes
    made by 'AD'.

    Fixing:   WShell:     Don't use the shell, live with it, or
                          turn its special function off.
              OS V2.04+:  Well, in this OS-Version the Command 'CD'
                          is resident (in ROM), so you don't need
                          AKCC's 'AD'.

@ENDNODE

@NODE CheckExec "CheckExec           (similar: -)"
    Shows some values of the 'ExecBase' and checks some vectors to avoid
    viruses. Is also able to show Boot-Blocks.

    CheckExec prints out information about the system's configuration :

    e.g. CPU, FPU, PAL/NTSC, various addresses,
         Viruses ?, ...

    CheckExec also allows to view Bootblocks of Disks :

     e.g. CheckExec CHECK DF0:

    displays the Bootblock of a disk in the internal drive "DF0:".

    The "FORMAT [DF(0|1|2|3):] allows to format diskettes.
    Only 837 KB disks are supported.
    This option may only concern users of OS 1.2 so far.

    Known Bugs:

    "FORMAT" does not seem to be fully free of bugs yet. Sorry !

@ENDNODE

@NODE Comment "Comment             (similar: Filenote)"
    Adds filenotes. WildCards.

@ENDNODE

@NODE DateAct "DateAct             (similar: SetClock, Date)"
    Shows or sets the actual system-time and -date.
    Is also able to read/write the Realtime-Clock MSM 6242 B
    (or compatible), like e.g. inside the Amiga 500 Plus.

    This command merges two of the Standard-AmigaDOS-Commands.
    It changes the internal Clock (CIA-Timer based) as well as
    it is able to access the (optional) batterie-buffered realtime-clock
    (only supports type MSM 6242 B, e.g. in most im Amiga 500 plus models).

    Meaning of the options :

     - <Date description>          CIA-Timer are set new
     - LOAD                        Loads CIA-Timer with realtime-clock
                                   values and displays them
     - SAVE <Date description>     Set realtime-clock to date

    Direct copies from CIA-time to realtime-clock are not supported.
    The reverse way should be gone always.
    (First set realtime-clock, then copy to Timers, or even not.)

@ENDNODE

@NODE Display "Display             (similar: Type)"
    Displays the content of a file on the Screen or a (virtual) device
    (e.g. PRT:, CON:, SER:, ...), or into an other file. Supports octal
    and hexadecimal printing and sourcecode generation.

    Display supports printing files in different ways, e.g.
    as ASCII, hexadecimal, octal, C- and Assembler-SourceCode,
    to the Console (default) or any other DOS-Device, as well as
    into a file.

     Normal/ASCII     : (Default)
     Hexadecimal      : HEX
     Octal            : OCT
     C-Source         : C             (Byte-Array)
     Assembler-Source : ASM           (dc.b-field)

@ENDNODE

@NODE DosRequest "DosRequest          (similar: RequestChoice)"
    This program allows easy opening of Requesters from Batch-Files,
    to let the user decide, what actions to perform next.
    Use this excerpt from a Batch-File as a demonstration :

     ; Begin of Batch-File

     DosRequest "Should I continue ?" "Yes" "No"
     if warn
      echo "You selected 'No' !"
     else
      echo "You selected 'Yes' !"
     endif

     ; End of Batch-File

    Under OS V2.04+ "AutoRequest()" will be replaced by the V37-Intuition-
    Function "EasyRequest()".
    This allows greater comfort and higher flexibility for requesters, then.

@ENDNODE

@NODE Duplic "Duplic              (similar: Copy)"
    Copies files/dirs.

@ENDNODE

@NODE EnvAct "EnvAct              (similar: SetEnv, GetEnv, etc.)"
    Is able to manage all affairs with environment-variables in an easy
    and quick way.

    Selection of a specific action is done via commandline parameters :

     EnvAct INIT <...>        - creates ENV: (NewDir + KAssign)
     EnvAct WRITE <...>       - writes an Env-Variable
     EnvAct READ <...>        - reads an Env-Variable
     EnvAct STREAM <...>      - prints out the content of an Env-Variable
     EnvAct ERASE <...>       - erases an Env-Variable

    STREAM results in printing out only the content of the Variablen
    (only a linefeed attached, no more explaining texts), so that
    the result may be used with other programs (e.g. via Backticks
    under OS V2.04+).

    Existance of "ENV:" is needed for using this command.

@ENDNODE

@NODE ExecDevs "ExecDevs            (similar: avail flush, etc.)"
    Informs about all resident devices (plus load, kill, ...)

@ENDNODE

@NODE ExecIRupts "ExecIRupts          (similar: -)"
    Informs about all resident interrupts.

@ENDNODE

@NODE ExecLibs "ExecLibs            (similar: avail flush, etc.)"
    Informs about all resident libraries (plus load, kill, ...)

    ExecLibs may also load Libraries and flush unused ones out of memory
    (if #=0, and the Library has been loaded to RAM and is not a ROM-
    resident one), if the specific Library supports this.

    ExecLibs offers basically the same options in using WildCards (for
    removing) as "KillTask" or "PriSet".
    But always ALL Libraries, which match the WildCard string are removed.
    But - different to the handling of Tasks - there are never two or
    more libraries with exactly the same name, which makes selection
    somewhat easier.

    When loading Libraries (from "LIBS:") the full name of the Library
    (as e.g. "42.library") has to be specified.

    "akccplus.library" cannot be removed via ExecLibs, because ExecLibs
    itself does use it.
    Use "flushlibs" (Workbench-Menu) instead to do this (available
    when started in "-debug" mode).


    List of options :

     ExecLibs LOAD <Name>

       - Loads a Library from LIBS: to memory

     ExecLibs KILL <NamePattern>

       - Removes all the Libraries from memory, which match the
         pattern (WildCards : "?", "#?", "*").

         Attention : Somtimes two or more calls are useful, because may
                     Libraries also open other Libraries, which then can
                     be removed also later.

     ExecLibs VIEW

       - All resident Libraries are displayed.
         Option is not needed (typing "ExecLibs" suffices).


    You may also access the command "ExecDevs" in the same way as this has
    been described above for "ExecLibs".

@ENDNODE

@NODE ExecMem "ExecMem             (similar: avail)"
    Shows available memory. Useful: is able to write the result into an
    environment variable.

    Display free memory and allos addiotional options :
    The results may be written to an Environment-Variable (e.g. for use
    by an other program).

     e.g. :            ExecMem CHIP VAR=<Variable-Name>

                       (writes size of free CHIP mem to ENV:<Variable-Name>)

     Syntax :

                               1. ExecMem

                                  => print out complete information

                               2. ExecMem <type of memory>

                                  allowed types :

                                  CHIP -> CHIP-Memory
                                  FAST -> FAST-Memory
                                  SUM  -> CHIP- & FAST-Memory

                                  => print out specific information only

                               3. ExecMem <type> VAR=<Variable-Name>

                                  => writes size of free memory of a
                                     specific type to an Env-Variable

@ENDNODE

@NODE ExecPorts "ExecPorts           (similar: -)"
    Informs about all public message ports.

@ENDNODE

@NODE ExecRes "ExecRes             (similar: -)"
    Informs about all resident resources.

@ENDNODE

@NODE ExecSems "ExecSems            (similar: -)"
    Informs about all public semaphores.

@ENDNODE

@NODE ExecTasks "ExecTasks           (similar: Status)"
    Informs about all active tasks.

@ENDNODE

@NODE ExtShow "ExtShow             (similar: List)"
    Shows a directory, protection bits, date and comment.
    With special functions under OS V2.04+.

@ENDNODE

@NODE FullPath "FullPath            (similar: Path)"
    Sets a completely new list of paths, which have to be searched for
    commands. Parameter is the name of a file, which contains this list.
    As a result of this, the order, in which the paths have to searched
    is exactly defined. Also single paths may be added or removed.

    FullPath replaces the Standard-Command Path in a way, which
    is especially useful for HardDisk owners :

    Usually there are masses of sub-directories on a HardDisk, of which
    many also have to be seacherd for commands.
    This might be frustratin, if the most-often used commands are placed
    in a directory, which is placed at the end of the search-list.
    Even a fast HardDisk takes some time to load a command, then.

    FullPath allows to declare a List of Paths (from a File) as the
    current List, where also the order of the entries is respected
    (first Path at first, last Path at last).
    The current directory is always searched at first, indepently from
    that.

    Another adavantage : You only have to call one command, no matter
                         if there are e.g. 30 Paths to be searched.

    Attention : The old PathList is always deleted !

    Tip : "C:" is usually searched at last, no matter if it is actually
          in the list or not.
          If you specify it at the begining of the list, it will be
          be searched directly after the current directory.
          Very useful !

    An example list :

    C:
    SYS:
    SYS:System
    SYS:Tools
    SYS:Utilities

    A new line for any new entry !!!

    When calling from CLI, there also may be added/removed single
    entries via ADD/REMOVE.

@ENDNODE

@NODE HunkShow "HunkShow            (similar: -)"
    Shows the HUNKS of a program or object-file and recognizes IFF-files
    of all kinds, also other kinds of files.

    This program show the Hunks of Program- or Objekt-Files
    (only SAS/Lattice-compatible formats).
    It also knows the follwing file-types :

     1a) FORM-????              (IFF-Files)
      b) LIST,PROP,CAT          (extended IFF-Files)
     2)  PowerPacker 3.0a/b     (packed programm -> PowerPacker)
     3)  PP20                   (packed file     -> PowerPacker)
     4)  -lh?-                  (archive in the "-lh?-" format)
     5)  MMD0, MMD1             (MED-Module, OctaMED-Module)
     6)  MED                    (MED-Sound)
     7)  HDBackup Logfile       (Logfile for HDBackup of WB V2.04+)
     8)  .key                   (many batch-files begin this way)
     9)  .info                  (Info-File of Workbench V1.x+)
    10)  ZOO                    (Archive in the "ZOO"-Format)
    11)  ZOM                    (Archive of ZOOM)
    12)  TFMX-SONG              (TFMX-Sound-Module)
    13)  FC                     (Future_Composer-Sound-Module)
    14)  RIFF-????              (RIFF-File, PC-Standard)
    15)  AmigaGuide File        (AmigaGuide Online-Documentation)
    16)  VOC SoundSample File   ("Creative Voice File"-Sample)

@ENDNODE

@NODE KAssign "KAssign             (similar: Assign)"
    Manages assignments. With special functions under OS V2.04+.

@ENDNODE

@NODE Kill "Kill                (similar: Delete)"
    Deletes files/dirs.

@ENDNODE

@NODE KillTask "KillTask            (similar: Break)"
    Deletes one (or many) task(s) from the system's lists. WildCards.

    Be careful when killing any tasks/processes (especially system tasks).

    There are two possibilities to use KillTask, to remove Tasks from
    the system :

    1. "BREAK"

    This does never affect the system and is nearly always SAFE.
    Any available CTRL-Break-Signale will be sent to the Task, so that
    it will immediately, if it supports one of them.
    Don't forget the keyword "BREAK", which is the only difference
    the method two.
    Example :

               KillTask BREAK Exchange


    2. "REMTASK"

    This one will remove the Task via Exec's "RemTask()" ALWAYS.

    Removing tasks this ways has many (almost only) disadvantages, but
    is useful to remove tasks, which crashed "silently".

    KillTask does is not case-sensitive, concerning the Task-Names,
    which makes usage much easier.

    Also usage of WildCards, as with the file-orientated commands,
    is supported ('#?'/'*'/'?').

    Basically the first Task, which fits the name or pattern is removed,
    but if you specify the option "-a", ALL matching Tasks/Processes
    will be removed instead.

     Examples :

         KillTask THISONE             (kills current task : should NEVER
                                       be done)

         KillTask "Background CLI"    (kills first task named
                                       "Background CLI")

         KillTask "Background CLI" -a (kills ALL tasks named
                                       "Background CLI")

         KillTask "Back*"             (kills first task beginning with
                                       "Back")

         KillTask "Back*" -a          (kills ALL tasks beginning with
                                       "Back")



    Attention : If any of the REMOVEd (not BREAKed) tasks still had any
                resources allocated, e.g. opened Windows, those will NOT
                be given free. (You should minimize the Window's sizes.
                The next reset will clear this up.)

@ENDNODE

@NODE KInfo "KInfo               (similar: Info)"
    Gives Information of all mounted Volumes, e.g. Disks or RAM-Disks.

    Meaning of the "status" field :

     R   : write-protected
     VAL : (at the moment) not validated
     R/W : valid and not write-protected
     ??? : unknown or invalid status-value

    Volume-Type :

     string              meaning                    since OS    DOS-ID

     unreadable         <-                                     'BAD\0'
     no disk            <-                                     -1
     no DOS             <-                                     'NDOS'
     OFS                OldFileSystem                          'DOS\0'
     FFS                FastFileSystem             V1.3        'DOS\1'
     OFS/I              international OFS          V2.04/3.00  'DOS\2'
     FFS/I              international FFS          V2.04/3.00  'DOS\3'
     OFS/IC             international OFS,   Cache V3.00       'DOS\4'
     FFS/IC             international FFS,   Cache V3.00       'DOS\5'
     Kickstart          Kickstart-Diskette                     'KICK'
     MSDOS              PC-Formatted Diskette      V2.04/V3.00 'MSD\0'

    When entering an unknown DOS-ID, the Hex-Value will be printed
    like in C ("0x...").

    The (international) FileSystems with DirectoryCache (DirCache)
    are also described as "DCFS" sometimes.
    But because the are two available of this kind, we do not use
    this description here.

    The "Size" value describes the number of Bytes per Block, which
    the correspondings File-System uses. These are e.g. 488 for
    OFS-Disks, 512 for FFS-Disks and 1024 for the Ram-Disk.

    Less information on the structure of the saved data (per Block)
    results in a higher diskspace with FFS-Disks, compared against
    the old OFS-Disks (24 Bytes additionally per Block).

@ENDNODE

@NODE KScroller "KScroller           (similar: Echo, etc.)"
    This program allows to use an ASCII file as the source for a simple
    "Text-Scroller" in the CLI/Shell (various speeds).
    When combined with "Texter" there are offered many possibilities
    for printing texts in the CLI/Shell.

@ENDNODE

@NODE LED "LED                 (similar: -)"
    Turns the Audio-Filter (PowerLED) on or off.

    The LED command support batch files, in a way that its return code
    is "boolean", when started with the "-batch" option.
    Example :

     ; Begin of Batch-File

     LED -batch
     if warn
      echo "LED is ON !!!"
     else
      echo "LED is OFF !!!"
     endif

     ; End of Batch-File


    LED may be useful, if e.g.

     - Soundprogramms "forgot", to turn the LED (again) ON or OFF
     - the LED is not visible (tower construction or defect LED)
     - the LED should be controlled automaticalle (e.g. from Batch-Files)
     - and many more

@ENDNODE

@NODE Move "Move                (similar: Copy+Delete)"
    Moves files/dir from one device/dir to an other.
    Copies the Source, then deletes it => combination of Kill and Duplic.

    This command allows "moving" of files by "deletion-after-copy".
    So files may transferred from one directory to another by copying them
    and then deleting the source.
    This is a replacement for the "Rename" command, if it is to be used
    "across device borders".

@ENDNODE

@NODE NewName "NewName             (similar: Rename)"
    Renames files/dirs.

@ENDNODE

@NODE NewDir "NewDir              (similar: MakeDir)"
    Creates a new directory or a complete new path:
    e.g. 'df0:Texts/Letters/Private'

    NewDir also creates complete paths (recursive), so that con-
    structions like 'RAM:tmp/comp/txt/1' etc. are also legal !

@ENDNODE

@NODE ProSet "ProSet              (similar: Protect)"
    Sets new protection bits for a file [out of: hsparwed].

@ENDNODE

@NODE PriSet "PriSet              (similar: ChangeTaskPri)"
    Changes the priority of a task/process by name. Wildcards.

    Priorities should be between -20 and +20 (better : -5 / +5),
    so that the task-switching is not affected in any way.
    Common values are : -1 / 0 / 1.

    PriSet offers the same WildCard options as e.g. also "KillTask".

@ENDNODE

@NODE Show "Show                (similar: Dir)"
    Shows a directory.

@ENDNODE

@NODE Texter "Texter              (similar: Echo)"
    Prints out a text on the screen OR on a printer.

    Options : normal, bold, underlined, italic, reverse, free lines

    All the styles and more are controlled with C-like codes
    (e.g. '\I', '\B', '\C=0,1')

    Uses PRT: for parallel printing, or PAR: when PRT: not available.

    All the styles are combineable (for the printer as well as for
    the screen.

    All font-attributes and other settings may be modified via special
    controlcodes (no ESCAPE-sequences needed).
    Example :

      Texter "\B\I\C=0,1Hello !\N\C=1,0" >PRT:

    Results in bold, italic "Hello !", with foreground color 0 and
    background color 1 (passed to printer).
    After that the old settings are restored.

    Possible controlcodes :

    atributes :
                      \N      : normal
                      \B      : bold
                      \I      : italics
                      \U      : underlined
                      \R      : reverse

    colors :

                      \C=<FG>,<BG>

    characters :
                      \\      : "\"
                      \42     : " itself

    format control codes :

                      \n      : linefeed
                      \b      : backspace
                      \f      : clrscr
                      \t      : TAB
                      \r      : carriage return


    Font attributes always have to be specified BEFORE colors, because
    otherwise the colors would be reset again when setting the attributes.

@ENDNODE

@NODE WinAct "WinAct              (similar: -)"
    Sizes the active window to PAL-, NTSC- or the biggest possible size,
    or brings it just to a given X/Y-size (everything possible).
    Also can move the window into the left, top corner of the screen or
    give it a new title.

    This command allows the modify the active CLI-/Shell-Window in
    an easy way (e.g. fromout Batch-Files) :

    Size-adjustment options :

      - PAL         (640 / 256)
      - NTSC        (640 / 200)
      - BIGGEST     (Max / Max)    <- see Preferences
      - X=<x> Y=<y> ( x  /  y )    <- First X, then Y (only TOGETHER)

    Position-adjustment options :

      - POSLEFT     (Window will be moved to upper, left corner.)

    Other options :

      - NAME=<Name> (Window title will be changed.)

@ENDNODE

@ENDNODE

@NODE "History"

     V6.8 : (13.9.2008)
     ------
      - under MOS two different DiskTypes are provided in the corresponding structure,
        so that e.g. SFS was recognized as OFS (MOS-workaround for KInfo);
        recognizes more volume types
      - similar fix for KAssign

     V6.7 : (6.1.2008)
     ------
      - bumped copyright to 2008
      - added DTBench, a benchmark tool for datatype image
        loading (works from OS 3.0 on with DOS or from
        OS 3.1 on with lowlevel.library); measures only
        the pure loading time without pic-dt remapping

     V6.6 : (16.2.2007)
     ------
      - with allocations < 4 Byte it was possible that upto
        3 Byte behind the allocation were overwritten with 0
      - 0 byte allocation attempts now will fail instantly
      - this fixes a memory leak in the wildcard comparision
        set of functions

     V6.5 : (3.1.2007)
     ------
      - since a few releases, the DOS pattern matching was
        never used even under V37+ but always the builtin code
      - now only under MOS 1.4.5 (MOS with Exec v50.60) or
        smaller this is the case (since pattern matching
        appearantly is broken there when FFS is used)
      - fixed a few minor issues in the internal pattern
        matching code
      - bumped copyright to 2007

     V6.4 : (21.4.2006)
     ------
      - problem with ANSI codes fixed (akccplus.library)

     V6.3 : (20.4.2006)
     ------
      - PPC inlines for MorphOS added
      - problem with ANSI codes fixed (all commands)
      - documentation fixed at places

     V6.2 : (13.4.2006)
     ------
      - fixed some bugs reported by users (hits)

     V6.1 : (25.3.2006)
     ------
      - MorphOS support

     V6.0 : (27.6.2002)
     ------
      - fixed bugs in date routines (did not occur yet, though)
      - added (more) UAE, Amithlon, CGx/P96 recognition to
        "checkexec noidentify" code
      - fixed KInfo OFS-stuff
      - updated copyrights and contact information

     V5.4 : (22.4.2000)
     ------
      - General: - Misc!

     V5.3 : (10.10.1998)
     ------
      - Commands: - better optimization
                  - CheckExec: - added UAE recognition code

      - Library:  - accidentally was dated "1997"
                  - better optimization

      - General: - updated docs

     V5.2 : (15.7.1998)
     ------
      - Library: - small changes

      - Commands: - small changes

     V5.1 : (27.11.1997)
     ------
      - Library: - UnLineStr: filters 0x0c now, too (see ExecLibs)

      - Commands: - ExecLibs:  no more formfeeds when there's a
                               0x0c character in the ID string
                  - ExecPorts: could crash when examing an uninitialized
                               mp_SigTask entry of a PA_IGNORE port
                               (-> DiskSafe)

     V5.0 : (20.09.1997)
     ------
      - recompiled with SAS/C 6.58

     V4.6 : (29.06.1997)
     ------
      - fixed Library bugfix (InitCode, memory loss)

     V4.5 : (24.06.1997)
     ------
      - Library bugfix (InitCode, memory loss)

     V4.4 : (16.05.1997)
     ------
      - added quick hack to recognize powerUP (TM) boards
        (not with identify.library being installed)

     V4.3 : (07.04.1997)
     ------
      - 060 recognition did not work
      - added "FLUSH" option to ExecMem
      - fixed library code

     V4.2 : (17.02.1997)
     ------
      - recompiled with SAS/C 6.57
      - updates docs: - email
                      - copyrights
                      - etc.
      - optimized/fixed library

     V4.1 : (06.09.1996)
     ------
      - english guide file did contain a binary character a first entry,
        which prevented it from being viewed as a guide file
        (-> Bill Beogelein)
      - this documentation had to be reworked (e.g. merged with Tips.doc)
        (-> Neil Sedger)
      - removed AKCC_Shell
      - completely reworked library and programmers stuff
      - renamed library to akccplus.library
        (you simply need to recompile your programs, nothing more)
      - all commands no longer display texts in different colors,
        which makes texts better readable under several configurations
        (-> Neil Sedger)
      - strongly improved CheckExec
          - now supports Richard Koerber's identify.library  for
            hardware and expansion board diagnostics (may be disabled)
          - now also checks for gfx and dma chipset (only when
            identify.library disabled or not present)
      - fixed ExecRes, removed Enforcer Hits
        (there's still one hit when examing keymap.resource, but
         I don't know why and where and did not want to build
         an extra-case for that structure)
      - fixed ExecSems (only use-count shown now)
      - in most commands, buggy command line parsing did cause Enforcer
        Hits, either only under certain circumstances (calling without
        parameters, no "?" given) or always (checked for parameter
        contents, which were not there). Old, buggy stuff, so has
        been rewritten.
      - also fixed Enforcer Hits in AboutCLI
      - removed PrefSet from distribution. It was a black hole
        of Enforcer Hits - unresolveable, maybe because OS 3.x
        no longer supports this prefs stuff that well and
        thus it is not possible to debug an OS 1.2 version...
      - removed name-change option of WinAct

     V4.0 : (01.08.1996)
     ------
      - recompiled using SAS/C V6.56
      - Commands: - using new GST for CLI commands
                  - changed related info and copyright texts
      - Library:  - there was a function not correctly saving D1 (parameter)
                  - using new GST
                  - using new startup-code
                  - and more...

****************************************************************************
Version history before V4.0 no longer included
****************************************************************************

@ENDNODE
