@database MangaCom
@master MangaCom.guide
@$VER: MangaCom Guide v1.5
@remark (c) 1997 by Stefano Pucino

@node "Main" "Main-Menu"
                           ###      ##                                  
 ###########        ##  ##########   ##  #########     ###             
 ###########  ##   ###  ########### ##   #########     ###             
 ########### ####  ###  ###########  ##  #########    ###              
        ###   ###  ###  ############           ###    ###              
       ###    ###  ###    ###   ####           ###   ####              
    # ####     #   ###    ###   ####           ###   ###               
   ######         ####   ####   ###            ###   ###               
   ######        ####   ####   ####            ###   ###  ###          
    ####        ####   ####    ###             ###  ####  ####         
     ####     ######   ###    ####       ######### ###########         
      ###    ######   ###     ###        ######### ############        
       ##    #####    ###    ###         ######### #############       
              #                                              ###


                               @{b}@{u}MANGACOM@{ub}@{uu} v1.5

        @{"Disclaimer   " link "Disclaimer" 0}      -   Please read it before you start !!!
        @{"Introduction " link "Introduction" 0}    -   What is this thing !?
        @{"How to use   " link "How To Use" 0}      -   Is there a steering-wheel ???
        @{"Configuration" link "Configuration" 0}   -   Settings before you start
        @{"Bugs         " link "Bugs" 0}            -   Win $1000 if you find the bug :)
        @{"History      " link "History" 0}         -   Here I listed all my bugs.
        @{"Future       " link "Future" 0}          -   Can it be better.
        @{"Greetings    " link "Greetings" 0}       -   I send out all my greetings to ...
        @{"Author       " link "Author" 0}          -   Who am I ? How to contact me ?
@endnode

@node "Disclaimer" "DISCLAIMER"
          This software is copyrighted by @{u}Stefano Pucino@{uu} !!!

You are NOT ALLOWED to modify the program and documentation in any way.
If  you  want  to  change  something  within  the  program-code  or the
documentation-guide, please feel free to @{"contact" link "Author" 0} me.
This nice piece of software is released as free-ware.
You can use it for free, but the whole copyrights belongs to ME !

      ----------------------------------------------------------

You  have  to  distribute this archive "AS-IT-IS".  That means, it MUST
contain the following files:

 - MangaCom                     <the exe-file>
 - MangaCommentor.cfg           <the configuration-file>
 - MangaCom.guide               <this document-guide>

Everything  that  isn't  part  of this package must be distributed as a
separate package.

This  package  may  be  freely  distributed  via BBSs, InterNet/UseNet,
software  libraries  such  as  Fred Fish's and AmiNET CD-ROM, and other
similar electronic channels.

Disk  magazines  and  services that charge extra for file transfers may
NOT distribute it without written permission by me !!!!

      ----------------------------------------------------------

By  using  this  product,  you  accept  the FULL responsibility for any
damage or loss that might occur through its use or the inability to use
it.
I can NOT be held responsible for any damage caused by this program !!!
@endnode

@node "Introduction" "Introduction"
 What is THIS !?

Well,  this  program  makes your life easier if you are a big Manga fan
like I am ^_^.

I have a whole bunch of Manga-Images that I collected via InterNET. All
of them has such strange names like "9mj-001.gif" or "smpc012.png".
Now  this  program  makes  use  of  the  well-known  feature of AmigaOS
(YEAH!):  The File-Comment

If loads the @{"configuration" link "Configuration" 0} file with all the short- and full names and
tries to search through this database for your specified file. If
found, it will comment the file with the full description and the
number of the picture.

     "smpc012.png" gets the comment "Sailor-Moon Picture-Card #12"

"WHOW ! This is incredible" - But this isn't everything !!!
It  is  also able to comment unknown pictures by separating the numbers
from the filename (It tries to :)

It will comment "asa101.jpg" as "Asa #101". Nice, isn't it ? ^_^
@endnode

@node "How To Use" "How To Use"
Easy ... type "MangaCom <pic1> [<pic2>, <pic3>, ...]"

 Example:

      - MangaCom MANGA:3x3/sazan1.gif MANGA:3x3/sazan2.gif
        This will try to comment the pictures sazan 1 and 2

      - MangaCom ranma12.jpg
        This comments only this Ranma 1/2 picture inside the current
        directory.

      - MangaCom
        This does nothing except printing out a simple copyright-text.

      - MangaCom ?
        This shows you a short USAGE-text.
@endnode

@node "Configuration" "Configuration"
 Hot to use the Config-File:
 That's easy ...

 Here some examples :

 mrg2_   -/- MRG-II [H]
 koi     -/- Mystic-Princess Koi Hime
 Cjr     -/- Cjiro Fantasy-Images
 Twind   -/- Twin-Dolls
 Ma___   -/- Macross-7

 <------>    <----------------------------------------->
 @{i}FILENAME@{ui}             @{i}COMPLETE DESCRIPTION@{ui}

Write the filename and the description separated by the "@{b}-/-@{ub}" symbol.

Nukunukuimg -/- Super-Cultural CatGirl Nuku-Nuku

Delete  the  picture-number from the filename because MangaCom will get
the  number  for  you.  The filename-search is case insensitive, so you
don't habe to worry about upper/lowercase chars.

The  only  problem  is  the -> " <- char.  Because I use 'Filenote' for
setting the comment, You can't use this char.  Use -> ' <- instead.

MangaCom will load the config as "@{b}SYS:Prefs/Presets/MangaCommentor.cfg@{ub}".
@endnode

@node "Bugs" "Bugs"
Bugs ???
Until now the only 'bug' I know is the usage of the cli-command 'filenote'.
That wasn't cool but allowed me to finish this version MUCH faster :)

In one of the next versions I will try to replace it by the system-call.
@endnode

@node "History" "History"
v0.x    AREXX-TIME
        A simple AREXX-Script !!!
        VEEEEEEEEEEERY slow !!!


v1.0    START

        My first attempt to write the EXE-version.
        Very simple commandline-parser.


v1.1    UPDATE

        CLI-parser more complex.
        Implemented the '?' help-text.
        Implemented HD/Path recognition


v1.2    UPDATE / BUGFIX

        Batch-Processing (MangaCom <file1> <file2>...) is
        finished. FINALLY !!!
        Fixed Number-Bug.


v1.3    BUGFIX

        Unknown files are handled more precisely.
        Number-Separator works correct now.

v1.4    BUGFIX

        Rewrote the whole File-Parsing routine.
        Implemented the -> " <- char recognition for the filename.
        Checked out several routines and cleaned up the code.

v1.5    RELEASE

        FIRST PUBLIC RELEASE
@endnode

@node "Future" "Future"

                  -------- ???????????????? --------

This  is  the  best program ever done.  Why should there be an update ?
Well, maybe I forgot to implement some bugs ^_^

Please  tell  me what you would like to see in the future.  If you want
some  specific routines and you have the idea how to code, feel free to
send me your incredible idea by @{"eMail" link "Author" 0} !

Until now I only want to ...

 ... Replace the "filenote" command by the system-call.
 ... translate this document into German, Italian and Japanese. ^_-
 ... remove the mistakes I wrote in this document.
 ... write some more bugs to find ^_^.

I  tested  this  tool under my Amiga 1230-882/50MhZ and 8 MB of FastRAM
together with Enforcer. Send me a note if it (still?) crashes :P
@endnode

@node "Greetings" "Greetings"
My best wishes go to ...

 - GeneX (AKA Vamp) / InterActive

        THANX for the CD.  It's INCREDIBLE !  GO ON AND COMPOSE MORE !
        Hope to see you at the next party ^_^.

     --=========================================================--

 - The rest of the InterActive-Crew (MicroDee, A-Freak, ...)

     --=========================================================--

 - The whole Defect-Softworks crew (Buggs, Eagleeye, M.U.D.U., ...)

    Der Bananen-Pfirsich-Nektar-Spezialist meldet sich zu Wort:
        Nächstes  Mal  machen  wir SICHER die Party durch und verziehen
        uns  nicht  mehr  so früh.  Sorry, aber wir hatten leider nicht
        soviel  Zeit.   Halte  die  Platte  warm,  denn für das nächste
        Party-Meeting  bringe ich 'ne leere Platte für die Chip-Modules
        mit ^_^;hehe.

     --=========================================================--

 - All users of the Hysteria-BBS !

        Thanks for supporting us with fun ! ^_^

     --=========================================================--

 - The users on AnimeGer

        I think I am the only one using this tool. Isn't the PC able to
        use File-Comments ^_^;hehe.

     --=========================================================--

 - YOSHIDA Sawako, IKEDA Ryoichi, KAJIWARA  Kumiko, BARKHAN

        For being my Japanese-sensei. Doumo arigatou gozaimashita !!

     --=========================================================--

 - FUKUTSUKA Tadashi

        For  all  those  very  nice  eMails  I  got  from  you and your
        students.   Sorry,  but  because  of lack of time I had to stop
        writing  to  you.  But I hope that we will get in contact again
        very soon ^_^.

     --=========================================================--

 - All Amiga-Fans out there

        Contact me if you own Chip-Music modules.
        I mean those Modules NOT composet with Sound/Pro/Noise-Tracker.
        Jason-Page, Hippel, TFMX, Custom, SID-Modules and so on ^_^

     --=========================================================--

 - All the Amstrad-CPC Fans on this planet

        Thanks for letting me in the comp.sys.8bit newsgroup !!!
@endnode

@node "Author" "Author"
Please:  If you find any mistake in my programs or documents, feel free
to write me an eMail/Snailmail so I can correct it as fast as I am able
to.  I'm still learning English, so I would be very pleased if you send
me your corrections to my work. ^_^


             Write your suggestions and/or compliments to:

                            Stefano Pucino
                          Robert-Koch-Str. 11
                            40880 Ratingen

                                Germany
                      Earth / SunSystem / Galaxy

              eMail:  s.pucino@fact.rhein-ruhr.de
                 or:  MaxHeadroom@hysteria.dssd.sub.org

Call  the TEX-WHQ "Hysteria":  02102 / 447431 (v.Everything/NoISDN) and
leave a note to "MaxHeadroom"

@endnode