@DATABASE GIF_+_Comment.guide
@AUTHOR "Felix C. Coronado"
@(C) "Copyright © 1995 Felix C. Coronado"
@$VER: GIF_+_Comment.guide 1.01 (22.5.95)
@INDEX Index




@NODE Main "GIF_+_Comment 1.06"
GIF_+_Comment 1.06
© 1995 Felix C. Coronado
------------------------
ARexx Pseudo-Loader for GIF files & GIF file comments
For use with The Art Department Professional v2.5

@{"Copyright & Distribution" LINK Copyright}
@{"Disclaimer              " LINK Disclaimer}

@{"Introduction         " LINK Introduction}
@{"Requirements         " LINK Requirements}
@{"Installation         " LINK Installation}
@{"Using It             " LINK UsingIt}

@{"Contacting the Author" LINK Author}
@{"History              " LINK History}

@{"Other Stuff by Felix Coronado" LINK OtherStuff}
@ENDNODE




@NODE Copyright "GIF_+_Comment 1.06"
@{B}Copyright & Distribution@{UB}

 GIF_+_Comment is copyright 1995 by Felix C. Coronado.  All rights reserved.
 GIF_+_Comment is Freeware and it may be distributed only if:

 1. it is in its original unmodified form
 2. it is accompanied by this documentation
 3. nothing is charged for it, other than the cost of the media and nominal
    duplication fees

  Any distribution of GIF_+_Comment that does not meet all of the above
 requirements must have the prior written permission of the author (Felix C.
 Coronado).

  Permission is granted to include GIF_+_Comment in Fred Fish's Amiga Disk
 Library (including CD ROM versions of it) and the AmiNet CD ROMs.
@ENDNODE




@NODE Disclaimer "GIF_+_Comment 1.06"
@{B}Disclaimer@{UB}

  This program (GIF_+_Comment) comes with no warranty, either expressed or
 implied.  The author (Felix C. Coronado) is in no way responsible for any
 damage, loss, or ill-effects directly or indirectly caused by the usage of
 this program.
@ENDNODE




@NODE Introduction "GIF_+_Comment 1.06"
@{B}Introduction@{UB}

  GIF_+_Comment is an ARexx script for use with ADPro 2.5 that searches for
 and displays any text comments contained in a GIF file, then loads the file
 into ADPro's image buffer.

 NOTE: GIF_+_Comment will only search for comments in GIF89a files, as
 this is the only type of GIF file that can contain comments.  If you use it
 on a GIF87a file, the file will be loaded into ADPro's image buffer without
@ENDNODE




@NODE Requirements "GIF_+_Comment 1.06"
@{B}Requirements@{UB}

 1. ARexx
 2. Art Department Professional version 2.5
 3. ADPro GIF Loader
@ENDNODE




@NODE Installation "GIF_+_Comment 1.06"
@{B}Installation@{UB}

 Copy GIF_+_Comment to your ADPro:Loaders2 directory or elsewhere.
@ENDNODE




@NODE UsingIt "GIF_+_Comment 1.06"
@{B}Using It@{UB}

  Start GIF_+_Comment using the instructions for launching ARexx scripts in
 your ADPro manual, or any other method you can think of.
  Once it starts, you will see a file requester from which to pick a GIF file
 to load.
  If the file you pick is a GIF 89a file, a small window will open showing
 the following:

     @{B}File:@{UB} <the GIF file you selected>

     Searching for comments...

     Ctrl-d to stop

  GIF_+_Comment is now searching the selected file for comments.  If you
 press Ctrl-d (the "Ctrl" key and the "d" key at the same time) while this
 window is open, GIF_+_Comment will stop searching for comments and go on to
 the rest of the script.  Pressing Ctrl-c while this window is open will 
 abort the script.
  If you stop the search before any comments are found, if no comments are
 found, or if the file you selected was a GIF 87a file, GIF_+_Comment will
 load the selected file into ADPro's image buffer.
  If GIF_+_Comment is able to find comments, a large window will open
 showing the following:

     @{B}File:@{UB} <the GIF file you selected>

     @{B}Comment@{UB} <number>@{B}:@{UB} <Comment>

  After this window opens, GIF_+_Comment will load the selected file into
 ADPro's image buffer.  The window will remain open until you click on its
 close gadget.
@ENDNODE




@NODE Author "GIF_+_Comment 1.06"
@{B}Contacting the Author@{UB}

  If you have any bug reports, questions, suggestions, comments, or gifts to
 send me, I would be glad to hear from you.  I would particularly like to
 hear from you if:

 1. You come across a GIF file that you know contains comments but
   GIF_+_Comment does not display the comments.  If this occurs, I would
   appreciate it if you sent me a copy of the file so that I could try to fix
   the problem.

 2. You have any information relating to GIF file comments (programs that let
   you add/edit them, etc.)

*****************************************
*  I can be reached at:                 *
*                                       *
*   Felix Coronado                      *
*   3966 Stanford Way                   *
*   Livermore, CA 94550                 *
*                                       *
*  EMail:                               *
*                                       *
*   CompuServe: 75460,722               *
*                                       *
*   Internet: 75460.722@compuserve.com  *
*****************************************
@ENDNODE




@NODE History "GIF_+_Comment 1.06"
@{B}History@{UB}

 1.06 May 21, 1995 - Minor improvements
 ---------------------------------------------------------------------------
 1.05 April 5, 1995 - GIF_+_Comment can now detect comments shorter than 255
                      characters
                    - GIF_+_Comment now displays only actual comment text
                    - Multiple comments are now displayed separately
                    - Other minor improvements
 ---------------------------------------------------------------------------
 1.04 April 2, 1995 - Minor improvements
 ---------------------------------------------------------------------------
 1.03 March 26, 1995 - First public release
 ---------------------------------------------------------------------------
 1.0 March 1, 1995
 ---------------------------------------------------------------------------
@ENDNODE




@NODE OtherStuff "GIF_+_Comment 1.06"
@{B}Other Stuff by Felix Coronado@{UB}

 Look for these other fine ARexx scripts/programs by Felix C. Coronado:

 Cataloger - ARexx script for The Art Department Professional v2.x or
             MorphPlus.  Makes image catalogs containing thumbnails of
             selected files.
             Features include:
             - Loads & saves most ADPro/MorphPlus file formats
             - Many options, different combinations can be saved & loaded
             - Files can be picked from requesters, FRED Sequence files, or
               ASCII file lists

 JPEG_+_Comment - ARexx script that acts as a pseudo-Loader for The Art
                  Department Professional v2.5.  Loads a JPEG file while
                  displaying any text comments contained in the file.

 ShowComment.rexx - ARexx program that searches for and displays any text
                    comments contained in a JPEG or GIF file.
@ENDNODE




@NODE Index "GIF_+_Comment 1.06"
@{B}Index@{UB}
@ENDNODE