












                                          User's Manual
                                   File List Printer (FLiP )
                                           Version 1.5
                                          December 1993



                              Copyright 1993, All Rights Reserved

































                                         Auburn Software
                                       32504 181st Ave SE
                                        Auburn, WA 98002
                                   (Compuserve ID 70400,1022)






                                           DISCLAIMER

            FLiP IS SOLD "AS IS" AND WITHOUT WARRANTIES AS TO
            PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES
            WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS
            HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM
            MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE
            IS OFFERED.   GOOD DATA PROCESSING PROCEDURE DICTATES THAT
            ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA
            BEFORE RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK
            OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER WILL BE
            LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
            PURCHASE PRICE.


































            FLiP is a trademark of Auburn Software.
            Windows is a trademark of Microsoft Corporation
            MS-DOS is a registered trademark of Microsoft Corporation
            Apple TrueType is a registered trademark of Apple Computer,
            Inc.




            FLiP User's Manual                                    Page i






                                        TABLE OF CONTENTS

            1. Getting started........................................1
                 1.1. Software .......................................1
                 1.2. Hardware .......................................1
                 1.3. Installation ...................................1
                 1.4. Removal ........................................2
            2. REGISTRATION AND SUPPORT...............................3
                 2.1. What is Shareware? .............................3
                 2.2. Registering ....................................3
                      2.2.1. Who must register? ......................3
                      2.2.2. The Benefits ............................4
                      2.2.3. How to Register .........................4
                 2.3. Distribution ...................................5
                 2.4. Technical Support ..............................5
            3. OVERVIEW...............................................6
                 3.1. On-line Help ...................................6
                 3.2. File Lists .....................................6
                 3.3. The Active File List ...........................7
                 3.4. Archiving File Lists ...........................7
                 3.5. Immediate Printing .............................7
                 3.6. Formatting Options .............................7
                      3.6.1. Section Format ..........................8
                      3.6.2. Page Layout .............................8
                      3.6.3. Font Selection ..........................9
                      3.6.4. Image File Handling .....................9
                      3.6.5. Special Character Handling ..............10
                 3.7. Keyboard Shortcuts .............................10
            4. MAIN WINDOW DISPLAY ELEMENTS...........................12
                 4.1. Active File List Display .......................12
                 4.2. Files in the Selected Directory ................12
                 4.3. Choosing a Drive or Directory ..................12
                 4.4. Setting a File Mask ............................13
                 4.5. Statusbar Information ..........................13
            5. COMMANDS AND OPTIONS...................................14
                 5.1. Adding Files to the Active List ................14
                 5.2. Removing Files from the Active List ............14
                 5.3. Clearing the Active List .......................14
                 5.4. Creating a New File List .......................14
                 5.5. Loading an Existing File List ..................15
                 5.6. Appending to the Active File List ..............15
                 5.7. Saving the Active File List ....................15
                 5.8. Saving the Active File List with a New Name ....15
                 5.9. Printing the Active File List ..................15
                 5.10. Selecting the Printer and Options .............15
                 5.11. Exiting FLiP ..................................16
                 5.12. Setting the Section Format ....................16
                      5.12.1. Page No. Control .......................16
                      5.12.2. Line Numbering .........................16
                 5.13. Setting the Page Layout .......................17
                      5.13.1. Paper Orientation ......................17
                      5.13.2. Margins ................................17
                      5.13.3. Target Lines Per Page ..................18
                      5.13.4. Logical pages per sheet ................18


            FLiP User's Manual                                   Page ii






                      5.13.5. Frame style ............................18
                      5.13.6. Line Spacing ...........................18
                      5.13.7. Headers and Footers ....................19
                 5.14. Specifying a Header or Footer .................19
                 5.15. Selecting the Printer Font ....................20
                 5.16. Setting Tab Handling ..........................21
                      5.16.1. Ignore Tabs ............................21
                      5.16.2. Tab as Spaces ..........................21
                      5.16.3. Use Tabs Stops .........................21
                 5.17. Image File Handling ...........................21
                      5.17.1. Image File Handling ....................22
                      5.17.2. Mapping Image Colors To Printer ........22
                      5.17.3. Image File Support .....................22
                 5.18. Wrapping Long Lines ...........................23
                 5.19. Squeezing Blank Lines .........................24
                 5.20. Handling Formfeeds ............................24
                 5.21. Handling Special Characters ...................24
                 5.22. Sorting the File List Entries .................25
                 5.23. File List Entry Display Options ...............25
                 5.24. About FLiP ....................................25




































            FLiP User's Manual                                  Page iii






























































            FLiP User's Manual                                   Page iv







            1. GETTING STARTED

            FLiP is designed to run under Windows 3.1 on PCs using Intel
            80x86, or compatible, processors.  Minimum requirements
            include:

            1.1. Software

                 MS/DOS 3.x or later
                 Windows 3.1 or later

            1.2. Hardware

                 Intel 80x86 or compatible processor
                 2 MBytes RAM (4MB recommended for printing image files)
                  Hard Disk with at least 1MB free space (FLiP can be
                   run from a floppy, but it is not recommended)
                 Color or Grayscale VGA display
                 Laser, Ink-jet, Dot-matrix or other printer capable of
                   raster graphics output
                 Mouse, or other pointing device, is highly recommended

            1.3. Installation

            FLiP installation is quite simple.  However, it does require
            familiarity with MS/DOS and Windows operation.  Refer to
            your DOS and Windows manuals if something in the description
            below isn't clear.

            If you are reading this, it is likely you have partially
            completed the installation process (Steps 1 and 2 below).
            However, for completeness, the entire process is described.

            (1) Download the distribution archive "flip15.exe" (for
            version 1.5) from your favorite BBS. Next create a directory
            (i.e., \flip) to hold the FLiP executable and help files.
            Copy the file "flip15.exe" into this directory.

            (2) At this point, you should exit Windows to DOS, or enter
            a DOS shell under Windows.  Now change to the "flip"
            directory you created above.  Enter the command
            "flip15<Enter>" to run the FLiP self-extracting archive.
            This will unpack the distribution archive into its component
            parts.  You can read the file "packing.lst" to confirm that
            all components were properly unpacked.

            (3) Return to Windows.  If you use Program Manager to launch
            programs, select the group you wish FLiP to reside in.  Now
            create an icon for FLiP using the File-New menu selection.
            Fill in the FLiP directory and program name (i.e.,
            c:\flip\flip.exe).  You can now use the icon to launch FLiP.




            FLiP V1.5 User's Manual                               Page 1






            FLiP is fully self-configuring and is now ready to run.
            When you first start up the program, it will automatically
            provide you with registration instructions (which may also
            be found in this document).  These will not appear again,
            provided you exit FLiP normally.

            1.4. Removal

            Should you decide that FLiP does not meet your needs, you
            will want to remove it from your computer.  All FLiP files,
            except one, will be located in the directory you used to
            unpack the distribution archive.  You may simply delete
            these files from your hard disk. FLiP will also create an
            initialization file in your Windows directory (usually
            \windows).  This file will have the name "flip.ini".  It
            should also be removed.








































            FLiP V1.5 User's Manual                               Page 2







            2. REGISTRATION AND SUPPORT

            2.1. What is Shareware?

            Shareware distribution gives users a chance to try software
            before buying it.  If you try a program and continue to
            using it, you are expected to register your copy.
            Individual programs differ on details - some request
            registration while others (such as FLiP) require it, some
            specify a maximum trail period.  With registration, you get
            anything from the simple right to continue using the
            software to an updated program with the printed manual.

            Copyright laws apply to both Shareware and Commercial
            software, and the copyright holder retains all rights, with
            a few specific exceptions as stated below.  Shareware
            authors are accomplished programmers, just like Commercial
            authors, and the programs are of comparable quality.  (In
            both cases, there are good programs and bad ones!)  The main
            difference is in the method of distribution.  The author
            specifically grants the right to copy and distribute the
            software, either to all and sundry or to a specific group.
            For example, some authors require written permission before
            a commercial disk vendor may copy their Shareware.

            Shareware is a distribution method, not a type of software.
            You should find software that suits your needs and
            pocketbook, whether its Commercial or Shareware.  The
            Shareware system makes fitting your needs easier, because
            you can try before you buy.  Because the overhead is low,
            prices are low also.  Shareware has the ultimate money-back
            guarantee. If you don't use the product, don't pay for it.

            2.2. Registering

            2.2.1. Who must register?

            FLiP is a "Shareware program" and is provided for evaluation
            at no charge to the user.  Feel free to share it with your
            friends, but please do not give it away altered or as part
            of another system.  The purpose of Shareware is to provide
            personal computer users with quality software at a very
            reasonable cost, and yet still provide incentive for
            programmers to continue to develop new products.

            If you find FLiP useful, and continue to use it beyond the
            30-day trial period, you must make a registration payment of
            $20 (if you desire a copy of the most recent release on
            diskette please include an additional $5).  The registration
            fee will license one copy for use on any one computer at any
            one time.  You must treat this software just like a book.
            For example, this software may be used by any number of
            people, and may be freely moved from one computer to


            FLiP V1.5 User's Manual                               Page 3






            another, so long as there is no possibility of it being used
            at one location while its being used at another.

            Commercial users of FLiP must register and pay for their
            copies of FLiP within 30 days of first use or their license
            is withdrawn.  If you are interested in site-licensing (25
            or more users), please contact Auburn Software for pricing
            information.

            2.2.2. The Benefits

            Of course, there are several benefits once you become a
            registered user.  First, you can obtain free technical
            support for a period of 90 days.  Second, you will be
            informed whenever a major program upgrade is released.  If
            this is within 6 months of your registration date, and you
            included $5 for a copy of the latest version of the program,
            a copy will be mailed to you at no charge.  Other users may
            receive the upgrade for a nominal charge or choose to
            download the upgrade through Shareware distribution
            channels.

            2.2.3. How to Register

            To register FLiP, you can use one of the methods indicated
            below.

            Method 1.  FLiP can be registered on Compuserve using the
            Shareware Registration Database (GO SWREG, Reg ID = 984).
            This is the simplest way to register your copy of the
            program and start receiving the benefits of being a licensed
            user.  Compuserve will bill you for the registration fee and
            notify me.

            Method 2.  Print out the registration form included in the
            distribution archive.  This can be done using FLiP by
            loading the "register.txt" file into a new File List.  You
            should set the pages per paper sheet to 1, portrait
            orientation, and select a fixed pitch font (e.g., courier).
            You can then print the file by selecting the File-Print
            command.  Fill in the required information on the printed
            form and mail it in.  As an alternative, you can load the
            file "register.txt" into your favorite word processor and
            enter the required information on-line..

            After completing the form, mail it to the address shown
            along with your check or money order for $20 ($25 if you
            wish a copy of the latest version on diskette).  I do not
            accept credit cards at this time.  Please allow a minimum of
            two weeks for mail delivery and processing before you
            request technical assistance.  This support is limited to
            registered users.




            FLiP V1.5 User's Manual                               Page 4







            2.3. Distribution

            Anyone distributing FLiP for any kind of remuneration must
            first contact Auburn Software for authorization, using the
            distribution licensing agreement form provided in the
            distribution archive (distlic.txt).  The fee charged for
            distributing FLiP may not exceed $10.  Upon approval of your
            distribution license, you will receive a copy of the latest
            version of the program.

            Individuals are encouraged to pass a copy of FLiP along to
            their friends for evaluation.  Please encourage them to
            register their copy if they find that they can use it.
            Also, please do not modify the distribution archive in any
            manner.

            2.4. Technical Support

            One of the key benefits from becoming a registered user of
            FLiP, is access to technical support.  As part of you
            registration fee, you are entitled to free technical support
            for a period of 90 days.  During this period, I will
            endeavor to provide you with prompt answers to your
            questions.

            Technical Support is available on Compuserve, via electronic
            mail, or by submitting a written request to the address on
            the registration form.  Questions submitted via Compuserve
            should be addressed to Blair Dillaway, ID=70400,1022.  I
            will make every effort to respond to questions within 72
            hours.  (Please be patient, however, as I do take a vacation
            once in a while.)

            After the 90-day free support period, you will still be able
            to obtain assistance.  In particular, I am always interested
            in hearing about possible bugs or incompatibilities with
            specific hardware and/or software.  I take such reports
            seriously and will try and help you resolve them.  If
            however, you require continuing assistance in setting up the
            program, consultation on how to use it most effectively, or
            additional explanation of program features, there will be an
            extra charge.  You will need to contact Auburn Software for
            current pricing on extended technical support agreements.












            FLiP V1.5 User's Manual                               Page 5







            3. OVERVIEW

            FLiP is a productivity enhancement tool for programmers, and
            other computer users, who needs to create hardcopy printouts
            of ASCII text, and other files, on a routine basis.  It is
            designed to automate the task of printing multiple text
            files in a well formatted, space efficient, manner.  It will
            also print files containing binary data, with some
            restrictions (see the discussion on special character
            handling) and can handle Windows Bitmaps (including icon and
            cursor resource files) as well as image files in the popular
            GIF, PCX, and MacPaint formats.  Typical uses include:

                 - Production of hardcopy archives for software
                     development projects.
                 - Producing hardcopy catalogs of sets of image files.
                 - Creating catalogs of bitmap "clip-art" libraries
                 - Printing of e-mail.
                 - Printing downloaded program documentation and source
                     files.
                 - Printing files produced by other programs when one
                     wishes to view embedded formatting information.

            FLiP uses File Lists to define a set of files to print and
            associated formatting instructions.  Each lists can contain
            from one to hundreds of file references spanning multiple
            directories.  The number of File Lists you define is limited
            only by available disk capacity.

            The formatting options allow you to place from 1 to 4 pages
            of output on each sheet of paper.  FLiP automatically scales
            the printer font to fit as much information on each sheet as
            is possible.  (You can, of course, select the font to use
            and exercise control over the font size.)  In addition, you
            can choose to embellish your output with a "frame" around
            your text and headers and footers with useful identifying
            information such as the date, time, file name, and page
            number.

            3.1. On-line Help

            FLiP provides on-line help.  With a few minor exceptions,
            the information contained in this document is accessible
            through the on-line help system.

            Help is accessible by pressing the F1 function key or
            selecting the Help-Index menu command.  Context sensitive
            help is also available for each of the program dialog boxes.

            3.2. File Lists

            FLiP is built around the concept of "File Lists".  A File
            List defines both the files that you wish to print and the


            FLiP V1.5 User's Manual                               Page 6






            associated formatting instructions.  Each list is an
            independent entity which can be printed efficiently on
            demand.  These lists can refer to totally unrelated sets of
            files, the same set of files but with different formatting
            options, or overlapping file sets.  You are provided a
            flexible set of options for selecting and organizing the
            files in each list to meet your needs.

            The maximum number of files in a list is limited to 16,000.
            Each file reference is maintained as a fully qualified file
            pathname.   In actual use, you will not want to approach
            this limit due to practical limitations, such as print time.
            Consider, for example, a file list containing 100 files.  If
            the output from each file requires only 2 sheets of paper,
            this list will output 200 sheets when printed.  This is
            larger than the paper tray capacity of many printers and can
            easily require several hours to complete.

            3.3. The Active File List

            You may have only one File List active at a given time.
            This list will be displayed in the main program window.  You
            may modify the contents of the active list and alter the
            formatting instructions.  Selecting the File-Print command
            will cause the active file list to be printed.

            3.4. Archiving File Lists

            You have the ability to archive the active File List to
            disk.  An archived list can be re-loaded at a later time.
            It is also possible to append an archived list to the
            currently active list.  In this way, you can easily combine
            and modify existing lists.

            3.5. Immediate Printing

            It is often desirable to quickly select one or more files
            and print them as a one time action. FLiP can easily support
            this mode of operation.  To do this start with an empty
            list, Add the desired files to the list, set the formatting
            options, and then Print the list.  When done, you can create
            a New list or load an archived list.

            3.6. Formatting Options

            FLiP provides you with multiple options for formatting your
            output.  These are briefly described below.  A more thorough
            discussion of these options is provided in the topic
            discussion for each area.







            FLiP V1.5 User's Manual                               Page 7







            3.6.1. Section Format

            Each input file printed using FLiP is treated as a separate
            section of the overall document.  You can specify where on
            the paper sheet a section will start, how page numbers are
            handled across sections, and how line numbering is to be
            handled.  These options can be modified using the dialog box
            accessible using the Format-Section menu selection.

            Options when starting a new file output include continuing
            printing on:
                 - the next logical page
                 - the start of the next column
                 - the start of a new paper sheet.
            Note that these are equivalent if you select 1 page per
            paper sheet.  The distinction is important only if you are
            printing multiple pages per sheet.

            Page numbering can be continuous for the entire File List,
            or it can be re-started for each section.

            You can also choose to have FLiP number each line of the
            input file.  This numbering can be continuous across all
            files in the list or be reset to 1 at the start of each
            file. The maximum line count should not exceed 99,999.

            3.6.2. Page Layout

            There are multiple options provided for controlling the
            layout of each paper sheet.  These allow you to not only
            control the appearance of the output but also to setup
            headers and footers which provide meaningful identifying
            information.  These are accessible using the Format-Page
            Layout menu selection and are summarized below.

            Paper Orientation - you can select either portrait or
            landscape mode.  You should make sure your printer will
            support the selected mode.  If it doesn't, you will be
            warned prior to printing.

            Margins - you can control the margins used on the output
            page.  These can range from 0 to 3.00 inches in .01-inch
            increments.  The margins are measured from the edge of the
            paper and define the area used for holding the output pages.
            In setting the margins, you must account for any unprintable
            area and the space required for headers and footers.

            Target Lines Per Page - You can specify the number of lines
            you would like printed on each logical page.  This can range
            from 1 to 250 lines.  The actual lines printed on each page
            are determined by this setting in combination with the
            minimum font size (see Font Selection) specified and the
            physical size of the logical page.  The latter is controlled


            FLiP V1.5 User's Manual                               Page 8






            by the physical paper size, orientation, and margin
            settings.

            Pages per Sheet - You can select 1, 2, or 4 pages per paper
            sheet.

            Frame Style - you can select to use no frame or 1 of 3 frame
            styles.

            Line Spacing - you can select single, space-an-a-half, or
            double spaced output.

            Header/Footer - you can specify the format for a single line
            header and footer to be printed on each page.  This can
            include arbitrary text, the file list name, file name, page
            number, date, time, etc.  For a full explanation of the
            options, see Specifying a Header.

            3.6.3. Font Selection

            FLiP allow you to select the font to use in printing the
            file list and to set the minimum size the font will be
            scaled to.  You will find a discussion of font selection
            issues in the help topic for the Font dialog box.  To
            summarize the important considerations:

            (1) FLiP attempts to scale the selected font to fit a full
            size (i.e., 66 line) page into the page output area
            established by paper orientation, margins, and pages per
            paper sheet selected.  To do this, the selected font must be
            scalable to the desired size.  It is generally best if you
            use an outline font such as a TrueType of Postscript font.

            (2) Since FLiP attempts to fit a full 66-line page into the
            specified output area, it is possible that the printout will
            use extremely small font sizes.  The minimum font size
            control allows you to insure that output font is not made
            smaller than an acceptably readable size.

            (3) Use of variable pitch fonts can result in vertical
            alignment problems in the output if it was prepared assuming
            a constant character width.  If proper vertical alignment is
            critical, consider using a fixed pitch font.

            3.6.4. Image File Handling

            FLiP supports the printing of bitmap images in a number of
            popular formats.  These include the Windows Bitmaps (.BMP
            files), run-length encoded bitmaps (.RLE files), icon
            resource files (.ICO files), and cursor resource files (.CUR
            files).  It can also print images in the popular GIF, PCX,
            and MacPaint (MAC) format.  You may also choose to treat
            image files as binary input files.  To control printing of
            image files.


            FLiP V1.5 User's Manual                               Page 9








            3.6.5. Special Character Handling

            The standard English alphanumeric and punctuation characters
            use only a portion of the ASCII standard character codes
            expressible using an 8-bit character set.  The unused
            character codes are used for a number of purposes.  The
            values below 32, provide control codes (i.e., line feed,
            carriage return, tab, form feed, etc.), while codes with a
            value above 127 are used for "graphics" symbols or foreign
            language characters.  You are provided with several options
            for dealing with these character codes.

            First, you can control how common control characters, which
            often appear in text files, are handled.  Linefeed and
            carriage-return characters are always treated as end-of-line
            indicators.  A  ^Z (character code 26) is an end-of-file
            marker for text files and is ignored.  This allows binary
            files to be used as input.  Handling options for formfeeds
            and tabs include:
                 Formfeeds (see Ignore Formfeeds) - these can be ignored
                   or interpreted as a request to move to the start of
                   the next output page.
                 Tabs (see Setting the Tab Handling) - these can be
                   ignored, converted to spaces, or interpreted as
                   request to move to an absolute tab stop position.

            For other control codes, or character codes with a value
            greater than 127, you can set select one of 5 options (see
            Handling Special Characters).
                 Print as spaces - insert a space in the output for each
                   character in the input file.
                 Print as periods - insert a period in the output for
                   each character in the input file.
                 Use font - output whatever the selected font defines
                   for these characters.
                 Print as hex value - output the hexadecimal value of
                   the character code using 0x99 format.
                 Print as decimal value - output the decimal value of
                   the character code as a positive integer.

            3.7. Keyboard Shortcuts

            FLiP it designed around a visual interface that is most
            easily accessed using a pointing device such as a "mouse",
            However, it is possible to access all program functions
            using the keyboard.  For the experienced user, this can
            often allow more efficient interaction.

            To effectively use the keyboard, you should be familiar with
            the standard keyboard shortcuts implemented by Windows(TM)
            dialog boxes.  Please refer to the manuals provided with
            your copy of Windows.


            FLiP V1.5 User's Manual                              Page 10







            The available keyboard entries and their effect are :

            General

                 F1          Help
                 TAB         Set focus to next control in main window

            File Commands

                 Ctrl-N      Create a new File List
                 Ctrl-L      Load a File List archive
                 Ctrl-A      Append a File List archive
                 Ctrl-S      Archive a File List
                 Ctrl-P      Print a File List
                 Ctrl-X      Exit FLiP

            Format Commands

                 F9          Activate the Section Format dialog
                 F10         Activate the Page Layout dialog
                 Ctrl-F      Activate the Font Selection dialog
                 Ctrl-T      Activate the Tab Handling dialog box
                 Ctrl-G      Activate the Image Handling dialog box
                 Ctrl-W      Toggle wrapping of long lines
                 Ctrl-Q      Toggle squeezing of blank lines






























            FLiP V1.5 User's Manual                              Page 11







            4. MAIN WINDOW DISPLAY ELEMENTS

            4.1. Active File List Display

            There is only one File List active at a given time and it is
            the only list which can be edited or printed  The total
            number of file references in the list, and the name of the
            File List archive, are shown in the top, right hand, corner
            of the main program window.

            The file references in the active list are displayed in a
            list box on the right hand side of the program window.   A
            display method may be selected in the List menu (see Display
            Options).  This controls whether file references are shown
            as full pathnames, or as only the file name.  Regardless of
            the display method, they are always stored as full pathnames
            so that references to files from multiple directories can be
            stored in the same list.

            4.2. Files in the Selected Directory

            At the top, left hand side, of the main window the currently
            selected directory is shown.  The files in this directory,
            which match the selected File Mask are displayed in the list
            box immediate below it.

            You may move selected file references (indicated by
            highlighting) to the File List using the Add button.  It is
            possible to select multiple files in the list box using the
            standard Windows control actions.

            4.3. Choosing a Drive or Directory

            You can select the drive and/or directory of the displayed
            files using the Drive or Directory list box on the left hand
            side of the screen.

            If you are in a sub-directory, the first entry in this list
            will be ".." and have an "open folder" icon beside it.
            Double clicking on this entry (or pressing the Enter key
            with this entry selected) will move you to the parent
            directory.

            The available sub-directories are indicated by "closed
            folder" icons and the directory name.  Double clicking on
            one of these will move you to the sub-directory.

            Drives will generally be listed at the bottom of the list
            box.  It may be necessary to scroll the list to bring the
            available drives into view.  These are shown by a "disk"
            icon and a drive letter.




            FLiP V1.5 User's Manual                              Page 12







            4.4. Setting a File Mask

            The File Mask, shown in the drop down list box at the bottom
            left of the screen, determines which files in the current
            directory will be displayed.  Only files which match the
            mask, given standard DOS/Windows file matching conventions,
            will be displayed.

            A set of standard masks are defined to meet the needs of a
            variety of users.  These include:


                  *.*                      All Files
                  *.txt;*.doc;*.ini        Text Files
                  *.c;*.cpp;*.h;*.hpp      C/C++ Source Files
                  *.pas;*.inc              Pascal Source Files
                  *.asm                    Assembly Source Files
                  *.bas                    Basic Source Files
                  *.bat                    Batch Programs
                  *.for                    Fortran Source Files
                  *.cob                    Cobol Source Files
                  *.rc;*.dlg               Resource Files
                  *.dat;*.def              Data Files
                  *.gif,*.mac,*.pcx        Image Files
                  *.bmp,*.cur;*.ico;*.rle  Bitmap Files


            To select a given mask use the standard Window control
            actions.

            4.5. Statusbar Information

            FLiP includes a statusbar at the bottom of the screen.  It
            displays information concerning the selected formatting
            options.  In order, from left-to-right, the statusbar
            indicates:

                  - paper orientation
                  - logical pages per paper sheet
                  - line spacing
                  - tab handling method
                  - whether to wrap long lines
                  - whether to squeeze multiple blank lines
                  - formfeed handling

            The statusbar also displays help information for each menu
            as it is activated.








            FLiP V1.5 User's Manual                              Page 13







            5. COMMANDS AND OPTIONS

            5.1. Adding Files to the Active List

            Clicking the Add button (located in the center of the main
            window) adds the file references selected in the directory
            listing to the active File List.  This operation checks for
            duplicates and automatically rejects a request to add a file
            reference which is already in the File List.  You will be
            warned if no files are selected.

            5.2. Removing Files from the Active List

            Clicking on the Remove button (located in the center of the
            main window)  will remove any selected file references from
            the active list.  Selections are indicated by highlighting
            of the entries in the file reference listbox.  You can
            select multiple entries following standard Window's control
            conventions.  An error message will be displayed if no
            entries have been selected.

            Exercise caution when removing files from the active list.
            Once removed, the file references can not be restored unless
            you have previously archived the list to disk.

            5.3. Clearing the Active List

            Clicking the Clear button (located in the center of the main
            window) will clear all file references from the active File
            List.  Exercise caution when using the command.  Once the
            list is cleared, the only way to easily restore its contents
            is reload the archive from disk (assuming you saved it
            earlier).

            5.4. Creating a New File List

            This command will initialize a new File List and is selected
            using the File-New menu.  It can also be activated with the
            ^N shortcut key.

            The new list will be give the name "untitled" by default.
            You can assign it a name by archiving it to disk using the
            Save As  command.

            If there is a non-empty active File List, you have the
            option of retaining all current file references.  This is a
            quick way to duplicate an existing File List.  Remember to
            save this list with a unique name..







            FLiP V1.5 User's Manual                              Page 14







            5.5. Loading an Existing File List

            This command loads an existing File List archived on disk
            and is selected using the File-Load menu.  It can also be
            activated with the ^L shortcut key.

            The archived list will replace the active File List.  Once
            loaded, the File List may be edited, formatting options
            modified, or printed.

            5.6. Appending to the Active File List

            The File-Append (^A shortcut key) command appends the file
            references contained in an archived list to the active File
            List.  Note that only the file references are appended.  No
            formatting information will be altered.

            5.7. Saving the Active File List

            The File-Save (^S shortcut key) command allow the user to
            archive the active File List to disk.  The archive will have
            the name associated with the currently active list.  If the
            active list has the name "untitled", you will be prompted
            for an archive name.

            5.8. Saving the Active File List with a New Name

            The File-SaveAs command allows you to archive the active
            File List to disk.  You will prompted for the name of the
            archive.

            5.9. Printing the Active File List

            Selecting the File-Print menu, or using the Ctrl-P shortcut
            key, will start the printing for the currently active File
            List.  When a printout is requested, a dialog box will
            appear which shows the selected printer, default
            resolutions, and number of copies to print.   You may change
            any of these selections at this juncture if you wish.  Once
            you confirm your selections (OK), the File List will be
            printed using the selected formatting options.

            5.10. Selecting the Printer and Options

            The File-Print Selection command allows you to change the
            default system printer and to set desired printer options.
            The printer types available are determined by the drivers
            you loaded during Windows setup.  Please refer to the Setup
            command in your Windows manual for instructions on adding or
            deleting print drivers.





            FLiP V1.5 User's Manual                              Page 15







            5.11. Exiting FLiP

            Choose the File-Exit command to leave the FLiP program.
            This can also be accessed using the Ctrl-X keyboard
            shortcut.

            Before FLiP exits, you will be prompted to save the active
            File List if changes have not been previously saved.  Also,
            FLiP automatically saves the currently selected set of
            formatting options.  These will be used the next time the
            program is started.

            5.12. Setting the Section Format

            The Section Control dialog box allows you to control how
            FLiP deals with formatting choices which can change with
            each file.  It is activated using the Format-Section Control
            menu or by pressing the F9 function key.

            5.12.1. Page No. Control

            Page numbering is done for each paper sheet of your
            document.  To output the page numbers, you must include the
            "&p" command in the Header or Footer.  You can choose to
            allow page numbers to be continuous within the entire
            document or to re-start at page 1 for each file.  If you
            choose to re-start page numbering for each file, it is best
            if you also select to start each section on a new sheet.
            This insures that the start of the file output is on Page 1.
            With other options, it is possible that a new file will
            actually start on the last paper sheet of the previous
            section.

            5.12.2. Line Numbering

            You can select whether or not to number each line in your
            document.   If you choose to include line numbering, you
            have the choice of re-starting at 1 for each new file, or
            allowing numbering to run continuously for the entire
            document.  If you select the latter option, any image files
            in the File List will be ignored when determining the
            appropriate line numbers.

            Line numbers are placed at the beginning of each line within
            the referenced file.  A maximum line count of 99,999 is
            supported.

            FLiP assumes that the input files are text files.  As such,
            the end of a line is determined solely by the presence of a
            linefeed character as expected in standard text files.  This
            has two important implications.  First, if lines are wider
            than will fit within the output area in the document, and
            wrapping is selected, the remainder of the line will appear


            FLiP V1.5 User's Manual                              Page 16






            on subsequent output lines.  These "wrapped" lines are
            considered as part of the previous line and are not
            individually numbered.  Second, line numbering may occur at
            unexpected places if printed files containing binary data.
            If you include references to binary files, it is best to de-
            activate line numbering.

            5.13. Setting the Page Layout

            The layout of the output page is controlled using the dialog
            box selected via the Format-Page Layout menu command (F10
            shortcut key).  The available options are described below.

            5.13.1. Paper Orientation

            You can select either Portrait  or Landscape mode when
            printing.  Portrait mode refers to the printing using the
            orientation typically used for letters and other documents.
            Landscape mode prints "sideways" to the normal orientation
            to allow a wider, but shorter, output area.

            5.13.2. Margins

            You can individually set the top, bottom, left, and right
            margins on the paper sheet.  These margins determine the
            area on the paper sheet used to hold the output text.
            Increasing the margins will decrease the paper area used for
            the output, while decreasing the margins will increase the
            output area.

            The margins can range from 0.00 to 3.00 inches in .01-inch
            increments and are measured from the edge of the paper.  To
            set the margins, you can either directly edit the margin
            value, or use the spin controls to move the margin up/down
            in .01-inch increments.

            There are several factors you will need to consider in
            setting the margins.  First, many printers are unable to
            print in a band around the edge of the paper.   For some
            printers, this band is 0.5 inches wide!  If you specify
            margins less than this width, some of your output will be
            clipped.  Please refer to you printer manual to determine
            the unprintable area, if any.

            Second, headers and footers are printed between the edge of
            the printable area and the output area determined by the
            margins.  If you desire headers and footers, you must leave
            a distance of approximately 0.2 inches between the
            unprintable area and the start of the output area.  For
            example, if your printer has a 0.25 inch unprintable area at
            the top and bottom of the page, you should specify a top and
            bottom margin of at least 0.45 inches if you wish to avoid
            clipping the header/footer.



            FLiP V1.5 User's Manual                              Page 17






            Finally, if you request a frame surrounding your output, it
            is also printed outside the output area determined by the
            margins.  You should increase your margins by approximately
            0.1 inches to accommodate a frame.

            If you are uncertain as to the optimal margin setting,
            experiment with different settings (and a File List with
            only a single reference to a short file).  You should be
            able to quickly determine settings which will suit your
            needs.


            5.13.3. Target Lines Per Page

            You can specify the number of lines per page you desire
            printed on each logical output page.  This value can range
            between 1 line and 250 lines.  The actual lines printed on
            each logical "page" is a function of this setting, the
            minimum font size specified in the Font Dialog, and the
            physical size of the page.  The latter is determined by the
            physical paper size, paper orientation, and margin settings.

            5.13.4. Logical pages per sheet

            The number of logical input file "pages" per paper sheet can
            be set to 1, 2, or 4.  The placement of the pages on the
            paper is indicated by the graphic selection button in the
            dialog and varies with the paper orientation selected.

            FLiP will attempt to scale the output font size to fit a
            standard (for 8.5 x 11 inch paper) 66-line page into each
            output page area.  The actual number of lines on a page is
            dependent upon user specified font (see Font Selection), the
            available output area, and the selected line spacing.

            5.13.5. Frame style

            There are four frame styles which can be selected.  These
            are depicted by the frame selection buttons.  While a frame
            does not alter the actual look of the printed text, it can
            improve the overall look and readability of your document.

            You may choose to have no frame, in which case the internal
            grid lines separating the logical pages will also be absent.
            If you choose to have a frame, then grid lines separating
            the pages on the paper sheet are automatically drawn.  The
            frame styles are a single "hairline" frame, a double line
            frame, or a box with shadowing.

            5.13.6. Line Spacing

            The line spacing can be set to three values depicted in the
            line spacing selection buttons.  You may select single,
            space-and-a-half, or double spaced output.


            FLiP V1.5 User's Manual                              Page 18







            5.13.7. Headers and Footers

            FLiP allows you to set up complex headers and footers which
            contain useful identifying information about the files being
            printed.  These are specified using the appropriate edit
            control in the Page Layout dialog box.  The section on
            "Specifying a Header or Footer" describes the available
            options.

            5.14. Specifying a Header or Footer

            FLiP allows you to set-up informative headers and footers
            for the File List.  These are specified using the edit
            controls available in the Page Layout dialog box.  You may
            enter arbitrary text, control alignment of the output, and
            select from a set of variables which reflect various
            "system" values.  The only restriction is that all
            information must fit in a single output line.  If you
            specify too much information it will be clipped.

            Format and system variable commands are identified by a
            preceding ampersand "&" character.  The available commands
            and their meanings are:

                  &f          Insert name of the current input file
                  &l          Insert name of the active File List
                  &p          Insert the current page number
                  &t          Insert the time printing started
                  &d          Insert the date printing started
                  &<          Flush all output left until the next
                                alignment instruction,  This is the
                                default.
                  &^          Center all output until the next alignment
                                instruction
                  &>          Flush all remaining output right
                  &$          Insert an RCS style header ($Header:
                                filename revnum .... $) if found in the
                                current input file.
                  &@          Insert a standard program identification
                                string of the form "@(#) ..... " if
                                found in the current input file.
                  &&          Insert an ampersand in the header/footer

            Each header/footer specification is checked for legal syntax
            before you exit the Page Layout dialog box.  You will be
            alerted to unknown commands or syntax errors.

            There are two important considerations to keep in mind when
            specifying a header or footer.  First, the alignment of the
            output is assumed to proceed from left to right.  For
            example, the specification




            FLiP V1.5 User's Manual                              Page 19






                   "&^Center Text&<Left Text"

            is illegal.  This requests that the phrase "Center Text" be
            centered with the phrase "Left Text" left justified.
            Reverse the order of these instructions to achieve the
            desired effect.

            Second, use extreme caution when requesting that an embedded
            input file identification string be inserted (&@ or &$).  As
            each input file is opened, the entire file will be scanned
            for an occurrence of these strings.  If these strings are
            not located near the beginning of the file, or are not
            present, this search can significantly slow down printing.

            A few examples of legal headers/footers:

            To get -
            My Name      C:\SOURCE\PROJECT\MAIN.C         April 1, 1993

            Use -
            "My Name&^&f&>&d"

            To get -
            My Project                                           Page 1

            Use -
            "MyProject&>Page &p"

            5.15. Selecting the Printer Font

            You can select from any of the available printer fonts
            installed on your system using the Font Selection dialog
            box.  This is accessed using the Format-Font Selection menu
            or the ^F keyboard shortcut.  The available fonts are
            determined by those fonts loaded into Windows.

            Windows 3.1 provides a set of scalable TrueType (TM) fonts.
            These may be supplemented with fonts provided by your
            printer vendor or additional third party fonts you have
            loaded.  You have the option of selecting from among the
            available style options for that font, such as Bold or
            Italic.

            Because FLiP automatically scales the font in response to
            the selected formatting options, you need not set a specific
            font size.  You are however, allowed to specify a minimum
            point size that will be used.  FLiP will not scale the font
            below this size when printing the document.

            Most people will find a minimize size of 6 points (the
            default) works well.  (The minimum size which can be
            specified is 4 points.)  Laser or Ink-jet printers with a
            300-dpi resolutions can typically produce a very readable 6-
            point font.  If you have a printer with lower resolution


            FLiP V1.5 User's Manual                              Page 20






            capability, or have problems reading very small type, you
            can increase the minimum size up to 24-point type.

            Remember, setting a large minimum point size will prevent
            FLiP from exercising its ability to intelligently fit
            multiple pages of output on a sheet of paper.

            5.16. Setting Tab Handling

            FLiP allows you to control how tab-characters are treated in
            your printout using the Tab Selection dialog box accessible
            via the Format-Tabs menu (^T shortcut key).  You have the
            following options.

            5.16.1. Ignore Tabs

            Tabs are skipped when encountered in the input file.

            5.16.2. Tab as Spaces

            This option converts each tab-character in the input file
            into one or more space characters.  You may set the number
            of space characters using the spin-control in the dialog
            box.  The minimum is 1 space and the maximum is 72 spaces.

            5.16.3. Use Tabs Stops

            This option provides the finest control granularity.  You
            may specify up to 32 individual tab stops in increments of
            .01 inches.  Tab stops may be set anywhere between 0.01 and
            17.0 inches. When each tab-character is encountered in the
            input file, the system will move to the next tab stop
            (relative to the current position in the output line) and
            continue building the output at that point.  You determine
            the tab stops by adding new settings to the displayed list,
            removing values from the list, or clearing the list
            entirely.  Note that setting the system to use tab stops
            with an empty tab stop list is equivalent to ignoring tabs.

            5.17. Image File Handling

            FLiP allows you to print image files in a number of popular
            formats.  Control over printing images is provided by the
            Image Handling dialog box accessible via the Format-Image
            Handling menu (^G shortcut key).  FLiP V1.5 recognizes image
            bitmaps stored in a number of formats.  It recognizes
            Windows bitmaps (.BMP files), icon resources (.ICO files),
            cursor resources (.CUR files), and run-length encoded
            bitmaps (.RLE files).  It also  handles image files in the
            GIF, PCX, and MacPaint (MAC) formats.

            When printing an image, an error dialog will be displayed if
            any error occurs when attempting to load or process the
            image data.  This will give you the opportunity to cancel


            FLiP V1.5 User's Manual                              Page 21






            the print job or continue with the remainder of the list.
            Possible errors which can occur include an invalid image
            file format, corrupted image data, and inability to allocate
            sufficient storage for the image.

            You have the following options to control image file
            printing.

            5.17.1. Image File Handling

            You are provided three methods for handling files containing
            image bitmaps.  These are controlled via radio buttons in
            the dialog box.  First, you may choose to treat them as
            binary files.  In this case, FLiP will attempt to print them
            using standard text symbols and your selected method of
            handling special characters (see Handling Special
            Characters).

            Second, you may choose to allow FLiP to size the image to
            the existing logical page size.  The image aspect ratio will
            be preserved.

            Third, you may size the images using a specified DPI (dots
            per inch) setting.  Note that the image will be cropped if
            this causes the printed image to extend beyond the logical
            page boundaries.  If this happens, you will only see the
            lower-left part of the image.  FLiP uses a logical
            coordinate system in which the origin is at the lower left
            hand corner with positive x coordinates to the right and
            positive y coordinates up.

            5.17.2. Mapping Image Colors To Printer

            Since most of us have only black and white printers
            available, we must be concerned with how image colors will
            appear when printed.  Three options are provided to help you
            produce acceptable output.  First, you can use the default
            mapping supported by your print driver.  In most cases, this
            will be adequate.  Second, you can force the image to be
            converted to grayscale before it is sent to the printer.
            Third, you can map the image to a bi-level representation
            based on a Burkes error diffusion dither.  This tends to
            produce excellent results and should be used if your print
            driver does a particularly poor job of handling color image
            input.

            If you are lucky enough to have a color printer, FLiP should
            work with it.  In this case, use the default mapping mode
            and allow your printer to produce color output.

            5.17.3. Image File Support

            MS Windows Bitmaps - FLiP supports Windows 3.x bitmap files
            (it will not work with OS/2 bitmap files).  These are


            FLiP V1.5 User's Manual                              Page 22






            normally identified by a .BMP extension and may be bi-level,
            4-bit color, 8-bit color, or 24-bit color.  The run-length
            encoded variants (either 4- or 8-bit color) are also
            supported.  These will generally have an RLE extension.

            MS Windows Icon and Cursor resource files - Icon and Cursor
            resource files contain bitmap images which define these
            Windows resources.  Each resource bitmap consists of  two
            parts.  First, is an "XOR" bitmap which may be color or
            monochrome.  Second is an "AND" bitmap which is always
            monochrome and defines the transparent part of the resource.
            FLiP will always print the bitmap with the AND bitmap on top
            and the "XOR" bitmap immediately below.   These files look
            best at fairly small sizes.  Setting them to print at a DPI
            of 36 to 72 seems to work well.

            Note that these files may contain multiple bitmaps which
            define the icon or cursor resources employed for different
            display types.  The current version of FLiP only prints the
            first icon or cursor bitmap encountered.

            GIF - The GIF format (Compuserve's Graphic Interchange
            Format) is widely used and supports color images with from
            1- to 8-bits per pixel.  GIF Version 87a is fully supported
            along with some GIF89a extensions.  This is fairly important
            since some current encoders mark their output files as
            GIF87a even though GIF89a extensions are employed.  Most GIF
            Version 89a files should be readable so long as the image
            wasn't saved using the graphics attribute definitions
            possible with GIF 89a.

            PCX - This is a popular PC image file format.  It is fully
            supported.

            MAC - Bi-level MacPaint images (Apple Computer) are fully
            supported.

            5.18. Wrapping Long Lines

            You can specify how FLiP deals with input lines which exceed
            the width of the output page.  If you select to wrap long
            lines, the system will break the current line at an
            appropriate point (space, punctuation mark, etc.) with the
            remainder of the input line printed on the next output line.
            If you choose to not wrap long lines, the input line will be
            clipped to fit in the width of the page.

            A check mark next to the Format-Wrap Long Lines menu
            indicates that wrapping is enabled.   Selecting this menu
            item will toggle the selection.  This can also be
            accomplished using the Ctrl-W shortcut key.





            FLiP V1.5 User's Manual                              Page 23







            5.19. Squeezing Blank Lines

            FLiP allow you to "squeeze" blank lines in the output.  This
            decreases the space required to print the file by
            eliminating multiple blank lines.  Note that the first blank
            line is always printed to avoid running separate
            topics/paragraphs together.

            A check mark next to the Format-Squeeze Blank Lines menu
            selection indicates that squeezing is enabled.   Selecting
            this menu item will toggle the selection.  This can also be
            accomplished using the Ctrl-Q shortcut key.

            5.20. Handling Formfeeds

            You can specify whether or not FLiP honors formfeed
            characters in the input file.  If you choose to honor
            formfeeds, each formfeed character will cause output to
            continue at the top of the next logical page.  If you choose
            to ignore formfeeds, they will be treated as through a
            linefeed character were present.  That is, they will cause
            the current output line to be ended and subsequent text to
            appear on the next output line.  In this latter case, a
            linefeed character immediately following a formfeed
            character will be ignored.

            A check mark next to the Format-Ignore Formfeeds menu
            selection indicates that formfeeds will be ignored.
            Selecting this menu item will toggle the selection.  This
            can also be accomplished using the Ctrl-F shortcut key.

            5.21. Handling Special Characters

            The presence of special characters in text files is fairly
            common.  These are used to represent graphics characters,
            non-English language characters, control characters,
            formatting instructions, etc.  FLiP allows you to specify
            how to deal with these characters in the printed output.

            These options, and the resultant output are:

            Print as spaces - Replace non-alphanumeric characters with
                                spaces
            Print as period - Replace non-alphanumeric characters with
                                periods
            Print using font- Interpret the character code using the
                                selected font
            Hex code -        Print the hexadecimal code for the
                                character using a 0x99 format
            Decimal code -    Print the decimal code for the character
                                 as a positive decimal value




            FLiP V1.5 User's Manual                              Page 24






            Setting the desired option can be done by selecting the
            appropriate  menu item accessible via the Format-Special
            Character Handling menu.  The currently selected options is
            indicated by a check mark.

            A few characters, which have a special meaning in text
            files, are always treated the same regardless of the users
            specified option.  These include:

                  - Linefeed and carriage-return characters which are
                      treated as end-of-line markers
                  - ^Z (decimal 26) characters are ignored to allow
                      binary files to be processed.  This character is
                      used as an end-of-file marker for text files.
                  - Formfeeds are ignored or interpreted as a page break
                      indicator depending upon the user selected option
                  - Tabs are handled according to the user selected
                      option

            5.22. Sorting the File List Entries

            The List menu provides three options for sorting the
            contents of the File List.  These are selected using the
            appropriate menu item.  The current selection is indicated
            with a check mark.

            The list may be sorted by full pathname, by filename, or by
            file type (DOS file extent).  You may resort the File List
            at any time by selecting the appropriate sort option in the
            menu.  If you have a long File List, this may take a few
            seconds.

            5.23. File List Entry Display Options

            There are two supported options for displaying the
            references in the active File List.  These may be selected
            using the appropriate menu items in the List menu.  The
            currently selected option is indicated by a check mark next
            to the menu option.  You can either choose to display the
            full pathname for  a file, or display only the filename.
            Note that the list box will display a maximum of 80
            characters for the pathname.  It is therefore possible that
            very long pathnames will be clipped if the option to display
            full pathnames is selected.

            5.24. About FLiP

            Selecting the Help-About FLiP menu will display information
            concerning this version of the program.  Note that the
            program serial number is displayed at the bottom of the
            screen.  If you experience an unusual problem, this can be
            used to positively identify the version of the program you
            are running.



            FLiP V1.5 User's Manual                              Page 25

