
                          SEARCH.EXE VERSION 1.20A03
                                       
Written By Robert Thivierge

   
   
   SEARCH.EXE is a freeware Windows 3.1 program that produces HTML Web
   pages consisting of small in-line GIF images. These images can be
   clicked on in a Web browser (like Netscape or Mosaic) to see the full
   sized JPEG picture. The output can be customized to suit your tastes.
   
     _________________________________________________________________
   
For an up to date version of this document please refer to:
  http://www.canuck.com/~thivier1/search.html

To be mailed mailed future update information
related to SEARCH.EXE, send me mail at:
  thivier1@freenet.calgary.ab.ca or thivier1@canuck.com

   
Table of Contents

   
   
     * SEARCH.EXE News
     * Current Features
     * Planned Features
     * Program Stability
     * Obtaining the Program
     * Legal Issues and Credits
          + Ownership
          + Freeware Status
          + Credits
          + Disclaimer
     * System Requirements
     * Installation Procedures
     * A Picture of SEARCH.EXE
     * Known Bugs
     * Contacting the Author
       
   
   
SEARCH.EXE News

   
   
   Version 1.20 is a significant upgrade from 1.10. All the HTML text
   produced can be controlled by you. The default output is now in HTML
   tables. You still don't need to know HTML to use SEARCH.EXE. However,
   if you wish to customize the output you will need to know HTML. You
   can also use SEARCH.EXE to to give a breakdown on disk space used by
   your JPEG files.
   
   All required information on how to use SEARCH.EXE is available by
   normal Windows on-line help included with the program. Just select one
   of the Help pull-down menu options.
   
Current Features

   
   
  WEB FEATURES
     * For every JPEG file in your site, it creates a smaller GIF
       version.
     * It generates one or more HTML files which contain links to these
       pictures. If you choose to have a sophisticated multi-page site
       (which you don't have to) a browser of your site will be able to
       traverse through all the pages by following links.
     * Your site can have one more pages in any directory and any number
       (zero, one, or many) sub-directories and any level of
       sub-directories.
     * You can have SEARCH.EXE organize pictures in different pages based
       on the file name or comments which are contained within the JPEG
       file. You can use this feature in combination with sub-directories
       or without sub-directories.
     * You can have SEARCH.EXE automatically generate a layout for your
       pictures with the "AutoOrg" button. It recognizes repeated file
       name patterns (ie. cc01.jpg, cc02.jpg, etc...), and groups them
       for you. Optionally you can edit this default layout.
     * New - All text outputted in pages can be changed. You can make
       changes globally that effect all pages, make changes that effect a
       certain type of page, make changes that effect only a particular
       directory, or effect only a particular page. You can also specify
       certain text to go next to individual pictures. For instance, next
       to a photo you could have the title of the photo and the name of
       the person (or object) in the photo. The text you specify may
       contain any HTML tags you wish. Pretty much, anything that can be
       done in HTML can be done with SEARCH.EXE.
     * New - You can have any number of pictures appear on a row in a
       table.
     * New - You can control the display width and height of images.
       SEARCH.EXE (by default) uses the WIDTH and HEIGHT tag to tell the
       browser the dimensions of a picture. This speeds up the display of
       your page for browser users.
     * New - Support for the new progressive-JPEG file format.
       Progressive-JPEG files take less disk space and have a fade in
       effect when viewed by Netscape. You can make your own with the
       JPEG Utilities located at
       http://www.canuck.com/~thivier1/software.html.
       
   
   
   If there's anything you can't get SEARCH.EXE to do when making Web
   Pages, please let me know.
   
  OTHER FEATURES
     * Inside SEARCH.EXE, if you click on a particular JPEG file you will
       see the image dimensions of the file shown.
     * SEARCH.EXE can be used to produce a listing of all files matching
       a pattern in a directory and its sub-directories. You can limit
       the listing to files that contain a string inside them. Of course
       this includes comments inside of JPEG files.
     * SEARCH.EXE will decode JPEG files from saved uuencoded articles
       off the UseNet. Unlike most decoders SEARCH.EXE will read
       information such as the "Subject" line and will store this
       information in the JPEG file. This information can be used to have
       SEARCH.EXE organize your pictures into logical groups.
     * Without running another program, you can preview GIF images inside
       of SEARCH.EXE. As well, you can double click on any file and
       launch the associated program to view/edit that file.
     * You can view the comments stored inside a JPEG file inside
       SEARCH.EXE. If you used SEARCH.EXE to decode the picture, you can
       see information such as who posted the picture.
       
Planned Features

   
   
   These are features I would like to implement if I get feedback on
   their usefullness.
     * Provide a user friendly interface for customizing a site.
     * Provide some canned picture layouts that users can select from,
       instead of always having to write their own if they want something
       different than the default.
     * Provide an easy built-in way to package files to be uploaded to a
       UNIX box.
     * Allow finer control over the size of GIF files created.
     * Let the user choose between GIF and JPEG format for in-line
       images.
     * Allow the user to use GIF files as anchor files.
       
   
   
   
   
   
   
Program Stability

   
   
   This program still has bugs that I am working out. However, it seems
   to work OK for me and other users. Remeber you are using my program at
   your own risk. There is no warranty.
   
   
   
Obtaining the Program

   
   
   If you are viewing this document on the Web, just load this anchor to
   disk and follow the installation procedures later in this file.
   Otherwise you should go to http://www.canuck.com/~thivier1/search.html
   to view the on-line version of this document or mail me at
   thivier1@freenet.calgary.ab.ca or thivier1@canuck.com.
   
   
   
Legal Issues and Credits

   
   
  OWNERSHIP
  
   
   
   SEARCH(c) 1995
   The Picture Page Generator
   Written by Robert Thivierge
   All rights reserved by Robert Thivierge
   
   Any attempt by a person other than myself to reverse compile, sell, or
   to represent the program as their own is prohibited. You may give a
   copy of the the program to someone else free of charge, provided you
   include all the files you received yourself. They then should notify
   me of receipt of it.
   
   However, any person or organization may distribute my program as
   freeware. They may charge a fee for the service of distribution (such
   as on-line charges, charge for distribution media, etc...). An
   acceptable form of distribution is including my program on CD-ROMs
   containing freeware/shareware, where there is a charge for the CD-ROM.
   However, it must be understood that they are not selling my program.
   And absolutely nobody, but me, may imply or suggest that they authored
   this program or that it is their property. I must always be given full
   credit.
   
  FREEWARE STATUS
  
   
   
   This program is freeware. I do not require financial payment for use
   of this product. Since users benefit from my time I think its fair to
   ask for some feedback. I like to know everytime someone gets my
   software and every time someone uses it for the first time. I also
   like suggested improvements, and friendly constructive criticism. I
   also appreciate being sent the URLs of sites made with the program.
   There is a special form to collect user responses, located at
   http://www.canuck.com/~thivier1/survey.html. You are always encouraged
   to let me know by e-mail what you're doing with and how its going with
   my program at thivier1@freenet.calgary.ab.ca or thivier1@canuck.com.
   Remember, one of my main rewards for making this program is seeing
   sites made with it.
   
   
   
  CREDITS
  
   
   
     * This software is based in part on the work of the Independent JPEG
       Group. They are kind enough to allow programmers to use their code
       library without financial charge.
     * The Graphics Interchange Format(C) is the Copyright property of
       CompuServe Incorporated. GIF(SM) is a Service Mark property of
       CompuServe Incorporated.
     * The actual compression method used in GIF is copywrited by Unisys
       Corporation. I thank them for allowing freeware authors to use
       their compression method without obtaining a license or paying
       royalties. See the Unisys FAQ on GIF for further details.
     * The tabbed dialogs in SEARCH.EXE were made with the source code
       for TabDlg.DLL. TabDlg.DLL is Copyright (c) 1994 Edward McCreary
       
   
   
  DISCLAIMER
  
   
   
   Use my program at your own risk. There are bugs I know of, there are
   bugs I don't know of. I assume no liability for any losses incurred by
   use of my program. I myself half accidently overwritten files with
   SEARCH.EXE. So, if I can loose stuff, you can too.
   
   
   
System Requirements

     * Operating System: It was designed for Windows 3.1. Users have also
       run it on Windows 95 and Windows NT OK.
     * Memory: The amount required is semi-proportional to the size of
       the largest JPEG picture you wish to compress. The amount used
       increases greatly when you use Pattern Match Pages.
       
   
   
Installation Procedures

   To install, do the following:
    1. Make a directory for the program (such as C:\SEARCH). It is very
       important that you have a directory set aside exclusively for
       SEARCH.EXE. Never use the same directory for the program that you
       use for your Web Site.
    2. Copy the ZIP File into it.
    3. Unzip it with PKUNZIP or a compatible program.
    4. Make sure all the files are in the same directory, with no other
       files present. Never use this directory to put your pictures or
       HTML files in.
    5. Double click on SEARCH.EXE in the File Manager or create an icon
       for it in the Program Manager. To create an icon in the Program
       Manager, simply drag the file from the File Manager to the Program
       Manager.
    6. Click on the "Settings" button and make sure they are all as you
       wish.
       
A Picture of SEARCH.EXE

   
       
       If you are viewing this document on the web you can view a picture
       of SEARCH.EXE running.
       
       
       
Known Bugs

   
       
       Please tell me of any bugs not on this list.
         1. Clicking on the program while it's busy can cause it to
            crash. Let me know if this happens. I have reduced the
            frequency of this error. If I can find out under exactly what
            circumstances it happens, I may be able to fix it.
         2. Fixed! - There should no longer be screen fuzz when you are
            writing GIF files out. This problem used to occur if the JPEG
            file was corrupt. I beleive I fixed this problem.
   
       
Contacting the Author

   
       
       You are welcome to contact me with your comments, suggestions, and
       bug reports at either thivier1@freenet.calgary.ab.ca or
       thivier1@canuck.com.
       
       
       
       Visit my Home Page at http://www.canuck.com/~thivier1
