@database "Man.guide"
@next MAIN
@remark $VER: Man 1.0 Guide
@(C) 1996 PLM Soft
@Author PierLuca Maltese

@node MAIN "Man.guide/Main"
@next INTRO

	M     M AAAAA N    N      1    000
	MM   MM A   A NN   N     11   0   0     by @{b}PierLuca Maltese@{ub}
	M M M M A   A N N  N    1 1   0   0
	M  M  M AAAAA N  N N      1   0   0
	M     M A   A N   NN      1   0   0     ©1996 @{b}PLM Soft@{ub}
	M     M A   A N    N      1 .  000

Thanks to AMIGA to be the best computer ever made.

@{"    INTRO     " link INTRO} Introduction about Man
@{"  COPYRIGHT   " link COPYRIGHT} Who can use it ?
@{" LEGAL STUFF  " link LEGAL} Standard Disclaimer
@{" REQUIREMENTS " link REQUIREMENTS} What do I need to use it ?
@{" INSTALLATION " link INSTALLATION} How do I install it ?
@{"    USAGE     " link USAGE} How do I use it ?
@{"   HISTORY    " link HISTORY} Once upon a time ...
@{"    BUGS      " link BUGS} Hey, my program faults in ...
@{"  CONTACT     " link CONTACT} How to reach the author
@endnode

@node INTRO "Man.guide/Introduction"
@next COPYRIGHT
@prev MAIN

Man is a program like... Man :)), used on UN*X workstations to gain some
help about system calls and commands on the shell.

When I try other versions of this useful command, I am not satisfied for
results, so, I write my own version.

This is a program written after opening and closing with Multiview(tm) the
AutoDocs(tm) for every Amiga system call needed for programming, so I think
it will be useful for a quick look about one of them. It's probably faster
use my program instead of searching manually for parameters of that system
call.

Of course there are programmers who remember every system call of the Amiga
Kernel, but for normal peoples, like me :)), Man will do its job.

@{" Goto MAIN " link MAIN}

@endnode

@node COPYRIGHT "Man.guide/Copyright"
@next LEGAL
@prev INTRO

Man and all related files in this archive are copyrighted by 

©1996 @{b}PierLuca Maltese@{ub}.

You may spread this archive as much as you please, as long as the following
conditions are observed :

    @{b}o@{ub} The archive has to remain intact, no files may be changed,
      added, deleted or altered in any other way whatsoever.
    @{b}o@{ub} No money may be charged for this program (PD-distributors
      may charge a small fee as disk payment.)

This program is not freeware. You MUST give 1000 dollars...ehm...:-)) OK

This program is FREEWARE.

@{" Goto MAIN " link MAIN}

@endnode

@node LEGAL "Man.guide/Legal Stuff"
@next REQUIREMENTS
@prev COPYRIGHT

Here follows legal stuff :

This program is provided "as is" without warranty of any kind, either
expressed or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.
The entire risk as to the quality and performance of this program is
with you. In no event can I be liable to you for damages of any kind
arising out of the use of this program, or the inability to use it.

@{" Goto MAIN " link MAIN}

@endnode

@node REQUIREMENTS "Man.guide/Requirements"
@next INSTALLATION
@prev LEGAL

To run Man you need :

    @{b}o@{ub} AmigaOS v3.0 or higher
    @{b}o@{ub} Motorola 68020
    @{b}o@{ub} Original AutoDocs files
    @{b}o@{ub} Hard Disk is recommended, or you will wait..wait..wait....

@{" Goto MAIN " link MAIN}

@endnode

@node INSTALLATION "Man.guide/Installation"
@next USAGE
@prev REQUIREMENTS

Man must be installed manually, because it's very simple and I generally
don't use Installer(tm) ;).

Follow the steps below.

    @{b}o@{ub} Copy the executable file to C: or another desired location.
    @{b}o@{ub} Copy this documentation where you want.
    @{b}o@{ub} Assign MAN: to a directory containing the Autodocs(tm) files.
               You can use multiple assigns, if your docs are in various
               directories.
               Try this :

               Assign MAN: dir1 dir2 dir3 etc.

    @{b}o@{ub} Relax yourself. All done :)

@{" Goto MAIN " link MAIN}

@endnode

@node USAGE "Man.guide/Usage"
@next HISTORY
@prev INSTALLATION

Man has this syntax :

    Man <SystemCall> [ALL]

where :

  @{b}SystemCall@{ub} is the (partial, see later) name of system call you
                      are searching. It is no case-sensitive, so, if you
                      don't remember if the call is Forbid() or ForBid() or
                      fORBID() :)), there are no problems.

  @{b}ALL@{ub}        is optional and tells Man not to stop if it founds a
                      system call name containing string passed like first
                      argument. If you want infos about calls with string
                      "Init",using ALL, you will gain infos of InitCLI(),
                      InitBitMap() etc, otherwise Man will show infos only
                      for first system call (ie. only InitCLI()) and no more.

Use CTRL+C to stop it.


 Examples :

You want see infos about Forbid():

1> Man Forbid

will show only Forbid().

You want see infos about BltBitMap* :

1> Man BltBitMap ALL

will show BltBitMap(), BltBitMapRastPort() etc.

@{" Goto MAIN " link MAIN}

@endnode

@node HISTORY "Man.guide/History"
@next BUGS
@prev USAGE

Here is Man's history :

 v0.9 (01 October 1996)

 Internal version. Not released.

 v1.0 (09 October 1996)

 First public release.

@{" Goto MAIN " link MAIN}

@endnode

@node BUGS "Man.guide/Bugs"
@next CONTACT
@prev HISTORY

 None (I hope).

 Man is tested with my configuration below and never gave me some problem.

 @{b}o@{ub} A1200
 @{b}o@{ub} CPU Motorola 68EC020 14 Mhz
 @{b}o@{ub} FPU Motorola 68881   14 Mhz
 @{b}o@{ub} Microbotics MBX1200z with 8 MB Fast Ram on board
 @{b}o@{ub} Hard Disk 540 MB (IBM)

 I successfully tested Man on AutoDocs(tm) files and files released with
 some C compiler.

 The format of files MUST be this :


 <FORMFEED>                      [RETURN here is optional]
 xxxxx.library/yyyyyzzzz()       name of system call
 infos....


 FormFeed is usually printed like an inverted L symbol and has ASCII code 12.

 If you are sure that Man has a bug, then @{"contact me" link CONTACT} so
 I can remove it (I hope :))

@{" Goto MAIN " link MAIN}

@endnode

@node CONTACT "Man.guide/Contact"
@next MAIN
@prev BUGS

If you want contact me, you can use my E-Mail address below, but I don't know
when it will expire, because I am graduating in Computer Science in the
University of Catania. Try it.

E-Mail:  hp194040@liotro.dipmat.unict.it

Or you can use Snail-Mail:

 Pierluca Maltese
 Vico Napolitano 22
 97015 Modica (RG)
 Italy

My telephone number is +39 932 943336.

You can send everything (bombs, girls, money (yes yes), your programs etc.)
but I can't guarantee that your stuff will be returned (girls specially :)))

See ya.

@{" Goto MAIN " link MAIN}

@endnode