home *** CD-ROM | disk | FTP | other *** search
Text File | 1993-02-01 | 76.5 KB | 1,981 lines |
-
-
-
-
-
-
- First Impression
- "Your Professional Installation Kit"
-
- Written & Published
- by
- Lincoln Beach Software
-
- Copyright (C) 1992-1993
- ALL RIGHTS RESERVED
-
-
-
- _______
- ____|__ | (tm)
- --| | |-------------------
- | ____|__ | Association of
- | | |_| Shareware
- |__| o | Professionals
- -----| | |---------------------
- |___|___| MEMBER
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- FIRST IMPRESSION
- "Your Installation Program"
-
- ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
-
- LIABILITY WAIVER . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
-
- COPYRIGHT & SHAREWARE STATEMENT . . . . . . . . . . . . . . . . . . . 2
-
- SUPPORT STATEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
-
- PLEA FOR FREE ADVERTISEMENT . . . . . . . . . . . . . . . . . . . . . . 3
-
- VIAS & ASSOCIATES . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
-
- OMBUDSMAN STATEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . 3
-
- INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
-
- IMPRESSION MENU OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . 5
- BASIC INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . 5
- Window Attributes . . . . . . . . . . . . . . . . . . . . . . . . 5
- Border Attributes . . . . . . . . . . . . . . . . . . . . . . . . 5
- Type of Window . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Border Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Horizontal Bar . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- No Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Enter Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Justify Text . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Move Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Copy Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Text Attributes . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Position Window . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Other Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Fill with Character . . . . . . . . . . . . . . . . . . . . . . . 8
- Fill With String . . . . . . . . . . . . . . . . . . . . . . . . . 8
- REGISTRATION WINDOW . . . . . . . . . . . . . . . . . . . . . . . . 8
- INSTALLATION ENHANCEMENTS . . . . . . . . . . . . . . . . . . . . . 8
- Configuration Description . . . . . . . . . . . . . . . . . . . . 8
- Default Subdirectory . . . . . . . . . . . . . . . . . . . . . . . 8
- Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
- AUTOEXEC.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
- Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- CONFIG.SYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- Device Drivers . . . . . . . . . . . . . . . . . . . . . . . . 10
- Files and Buffers . . . . . . . . . . . . . . . . . . . . . . . 10
- System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- K Needed On Destination . . . . . . . . . . . . . . . . . . . . 10
- DOS Version Needed To Run . . . . . . . . . . . . . . . . . . . 10
- Base Memory Needed . . . . . . . . . . . . . . . . . . . . . . 11
- Is a Math Coprocessor/Game Port/Mouse Required? . . . . . . . . 11
- Network Required? . . . . . . . . . . . . . . . . . . . . . . . 11
- Monitor Required? . . . . . . . . . . . . . . . . . . . . . . . 11
- Sounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Hard Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Hard Code Name . . . . . . . . . . . . . . . . . . . . . . . . 12
- Location of Programs . . . . . . . . . . . . . . . . . . . . . 12
- Files to Code . . . . . . . . . . . . . . . . . . . . . . . . . 12
- Length of Field . . . . . . . . . . . . . . . . . . . . . . . . 12
- Exit Program . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
- FILES TO COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
-
-
-
-
-
- Blank Entries . . . . . . . . . . . . . . . . . . . . . . . . . . 13
- Multiple Disks . . . . . . . . . . . . . . . . . . . . . . . . . . 13
- READ ME FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- DOCUMENTS TO PRINT . . . . . . . . . . . . . . . . . . . . . . . . . 14
- DOS INSTRUCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- Drive Letter Substitution . . . . . . . . . . . . . . . . . . . . 15
- DOS Command Processing . . . . . . . . . . . . . . . . . . . . . . 15
- FILE COPY DISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . 16
- MEDIA SELECTION STYLE . . . . . . . . . . . . . . . . . . . . . . . 16
- Confirmation Option . . . . . . . . . . . . . . . . . . . . . . . 16
- VIEW BASIC INSTALL . . . . . . . . . . . . . . . . . . . . . . . . . 17
- GENERATE DISTRIBUTION DISKS . . . . . . . . . . . . . . . . . . . . 17
- LOADING AND SAVING CONFIGURATIONS . . . . . . . . . . . . . . . . . 17
- SHELL TO DOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- QUIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
-
- FINISHING UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
-
- UNINSTALL OPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
-
- INSTALLATION FLOWCHART . . . . . . . . . . . . . . . . . . . . . . . . 19
-
- CUSTOMIZED INSTALLATIONS WITH SETUP.EXE . . . . . . . . . . . . . . . . 20
- SYNTAX FOR WINDOW ROUTINES . . . . . . . . . . . . . . . . . . . . . 21
- Creating a Background . . . . . . . . . . . . . . . . . . . . . 21
- Opening a Window . . . . . . . . . . . . . . . . . . . . . . . 21
- Closing a Window . . . . . . . . . . . . . . . . . . . . . . . 21
- Clearing a Window . . . . . . . . . . . . . . . . . . . . . . . 21
- Moving Bars in a Window . . . . . . . . . . . . . . . . . . . . 22
- Setting Border Characters . . . . . . . . . . . . . . . . . . . 22
- Moving a Window . . . . . . . . . . . . . . . . . . . . . . . . 22
- Putting Text in the Window . . . . . . . . . . . . . . . . . . 22
- Putting Titles on Borders . . . . . . . . . . . . . . . . . . . 23
- Changing the Window Attribute . . . . . . . . . . . . . . . . . 23
- Changing the Border Attribute . . . . . . . . . . . . . . . . . 23
- Pausing Screen Activity . . . . . . . . . . . . . . . . . . . . 23
- Starting the Installation . . . . . . . . . . . . . . . . . . . 23
-
- INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ACKNOWLEDGEMENTS ACKNOWLEDGEMENTS
-
- Thanks to my wife for putting up with me during all of this and to God for
- giving me the knowledge and skill to do this.
-
- Also thanks to Charles Schell, Mike Buchanan, Mike Caines & Matt Methany
- for the time they took to BETA test this version and to all the users who
- have submitted ideas for First Impression.
-
- DEDICATION DEDICATION
- This version is dedicated to the memory of
-
- Suzzane Hoven
- 12/1/92
-
- LIABILITY WAIVER LIABILITY WAIVER
-
- FIRST IMPRESSION IS LICENSED "AS-IS." LINCOLN BEACH SOFTWARE MAKES NO
- WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS PROGRAM, ITS
- QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR ANY PARTICULAR
- PURPOSE. IN PARTICULAR, IT IS NOT GUARANTEED TO PREVENT OR DETECT DAMAGE
- TO YOUR DATA OR PROGRAMS. IN NO EVENT SHALL LINCOLN BEACH SOFTWARE BE
- LIABLE FOR ANY CLAIMS FOR LOST PROFITS OR ANY DAMAGE, INCLUDING, BUT NOT
- LIMITED TO, SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGE. SOME
- STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR
- CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY
- TO YOU. IN NO CASE SHALL LINCOLN BEACH SOFTWARE'S LIABILITY EXCEED THE
- LICENSE FEES PAID FOR THE RIGHT TO USE THE LICENSED SOFTWARE. THE LICENSE
- AGREEMENT AND WARRANTY SHALL BE CONSTRUED, INTERPRETED, AND GOVERNED BY THE
- LAWS OF THE STATE OF MISSOURI.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Lincoln Beach Software - 1
-
-
-
-
-
- COPYRIGHT & SHAREWARE STATEMENT COPYRIGHT & SHAREWARE STATEMENT
-
- FIRST IMPRESSION is a "shareware program" and is provided at no charge to
- the user for evaluation. Feel free to share it with your friends, but
- please do not give it away altered or as part of another system. The
- essence of "user-supported" software is to provide personal computer users
- with quality software without high prices, and yet to provide incentive for
- programmers to continue to develop new products. If you find this program
- useful and find that you are using FIRST IMPRESSION and continue to use
- FIRST IMPRESSION after a trial period not to exceed 30 days, you must make
- a registration payment of $55+$5(s/h) to LINCOLN BEACH SOFTWARE. The $55
- 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. An example is
- that this software may be used by any number of people and may be freely
- moved from one computer location to another, so long as there is no
- possibility of it being used at one location while it's being used at
- another. Just as a book cannot be read by two different persons at the
- same time. Also installation procedures may be developed solely for the
- company it is licensed to. You may not develop installations for other
- firms.
-
- Corporate users of FIRST IMPRESSION must register and pay for their copies
- by departments and site-License arrangements may be made by contacting
- LINCOLN BEACH SOFTWARE.
-
- You are encouraged to pass a copy of FIRST IMPRESSION along to your friends
- for evaluation. Please encourage them to register their copy if they find
- that they can use it. All registered users will receive a copy of the
- latest version of the FIRST IMPRESSION system and printed documentation.
-
- This software and documentation is protected under the United States
- Copyright Laws and International Treaty Provisions. Your support of
- Shareware is appreciated.
-
-
- SUPPORT STATEMENT SUPPORT STATEMENT
-
- If you have questions or comments about First Impression, you may call us
- at:
-
- 314-227-2431
-
- If no one is there to answer your call, please leave a message and we will
- get back to you as soon as possible.
-
-
-
-
- Or you may write to us at:
-
- Lincoln Beach Software
- P.O. Box 1554
- Ballwin, MO 63022-1554
-
- You may contact us on the CompuServe Information Service by directing your
- E-mail to:
-
- Harold Holmes, CompuServe ID: 70700,630
-
-
- 2 - First Impression - Copyright 1992
-
-
-
-
-
- PLEA FOR FREE ADVERTISEMENT PLEA FOR FREE ADVERTISEMENT
-
- If you would put the following paragraph in your documentation, we would
- greatly appreciate it:
-
- First Impression, the installation program used by <your company or program
- name>, was written by Lincoln Beach Software, which reserves all copyright
- protection worldwide. For more information about First Impression, write
- Lincoln Beach Software at P.O. Box 1554, Ballwin, MO 63022 or dial 314-227-
- 2431. They may also be reached on Compuserve at 70700,630.
-
-
- VIAS & ASSOCIATES VIAS & ASSOCIATES
-
- This document was edited and expanded by Vias & Associates, a technical
- writing and document design firm based in Gainesville, Florida. If you, or
- someone you know, needs documentation written, edited, designed, or laid
- out, please contact us at:
-
- Vias & Associates
- P.O. Box 8234
- Gainesville, FL 32605-8234
-
- 1-800-332-8234
- Compuserve: John Vias [72260,1601]
-
- Whether it's a newsletter, hardware documentation, or anything in between,
- we look forward to working with you!
-
-
- OMBUDSMAN STATEMENT OMBUDSMAN STATEMENT
-
- First Impression is produced by Lincoln Beach Software, a member of the
- Association of Shareware Professionals (ASP). The ASP wants to make sure
- the shareware principle works for you. If you are unable to resolve a
- shareware-related problem with an ASP member by contacting the member
- directly, the ASP may be able to help. The ASP Ombudsman can help you
- resolve a dispute or problem with an ASP member, but does not provide
- technical support for members' products. Please write to the ASP Ombudsman
- at: 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via
- CompuServe Mail to: ASP Ombudsman, 70007,3536.
-
- INTRODUCTION INTRODUCTION
-
- FIRST IMPRESSION allows users to easily install your software. It also
- shortens your development time by saving you the tedium of creating your
- own install procedures. IMPRESSION consists of three programs,
- IMPRESS.EXE, INSTALL.EXE, and SETUP.EXE. With these tools you can create a
- customized install program for almost any application. Here are the steps
- you must take to create a custom installation with FIRST IMPRESSION.
-
- 1. Run IMPRESS.EXE. Its operation is described in detail below. After
- you tell it how you want the installation to look, it creates a file
- called INSTALL.CFG.
- 2. Copy INSTALL.EXE and INSTALL.CFG (not IMPRESS.EXE), along with your
- program's files, to the distribution disk.
- 3. On the disk label, instruct the user to run INSTALL. It's that
- simple!
-
-
- Lincoln Beach Software - 3
-
-
-
-
-
- At installation time, INSTALL.EXE reads the INSTALL.CFG file and acts
- accordingly, displaying instructions and options, prompting the user,
- copying and displaying files, and so on.
-
- IMPRESS.EXE makes the job of creating an installation very easy. For added
- flexibility, however, you can use SETUP.EXE to manually create an
- installation script. SETUP is described in detail toward the end of the
- manual.
-
-
- Here are a few benefits FIRST IMPRESSION offers developers:
-
- User-selectable source and destination drives and directories
- Printing of included documentation.
- Confirmation of adequate disk space for installation.
- Hard coding of the registered user's name into your program.
- Ability to use compressed files and a compression utility of your
- choice.
- Adding a directory to the PATH statement at the user's option
- Updating of FILES and BUFFERS statements, also at the user's option.
-
- There are many other features that you will use and appreciate as you
- create your custom installation.
-
- FIRST IMPRESSION will utilize a Microsoft-compatible mouse, if one is
- installed.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4 - First Impression - Copyright 1992
-
-
-
-
-
- IMPRESSION MENU OPTIONS IMPRESSION MENU OPTIONS
-
- BASIC INSTALLATION BASIC INSTALLATION
-
- When you select Basic Install Windows from IMPRESS's Program Configuration
- menu, another menu appears with a list of windows you can customize. They
- are the Greeting, Program, Copy, Status, Directory, Exiting, and Background
- Windows. Also available is an option to return you to the previous menu.
-
- After selecting one of the windows to customize, you are presented with a
- screen in which you can change that window's attributes. These options are
- explained below in the order they appear in the menu at the bottom of the
- screen. As you would in IMPRESS's other menus, simply press the
- highlighted letter to access that option. As you're customizing, the
- window's appearance changes according to the options you select.
-
- You can press ESC to return to the previous menu, HOME to move to the first
- line in the window, and END to move to the last line.
-
- The Greeting, Program, Copy, Directory, and Exiting windows work as
- described below. You may not have all the options available in all the
- windows, but the options that are available work as described. Options for
- the other windows are detailed after this section.
-
-
- Window Attributes Window Attributes
-
- This option sets the window's foreground and background colors. Only the
- areas of the window that have no text will be affected. The border and
- text colors are set with different commands. When you press "W" to access
- this option, a small color box appears with all the available foreground
- and background color combinations. A spinning bar marks the current
- choice. To select a new color combination, use the cursor keys to move the
- bar. The window's appearance changes to reflect the currently selected
- colors. When you are satisfied with your choice, press ESC or ENTER.
-
-
- Border Attributes Border Attributes
-
- This option works identically to Window Attributes, except that it controls
- the window's border colors.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Lincoln Beach Software - 5
-
-
-
-
-
- Type of Window Type of Window
-
- The next option is for the window type. The choices are: Normal,
- Borderless, Exploding, and Shadowed.
-
- Normal Border, no shadow, and always appear full size.
-
- Borderless As you would expect, have no border. They also have no
- shadow, and they always appear full size.
-
- Exploding Border but no shadow. They start small and grow to their
- full size, giving an "exploding" look.
-
- Shadowed Border and shadow, and always appear full size and are
- transparent.
-
- Press the first letter of the window type you want, or move the bar to your
- choice. After making your selection, press ENTER.
-
-
- Border Type Border Type
-
- This option lets you change the border of the window. You can press the -
- /+, Up/Down, or PgUp/PgDn keys to cycle through the ten choices. The
- window's border changes to reflect the currently selected choice. The
- first six choices use combinations of single and double lines and the last
- four use a wide border with different shading. Press ESC or ENTER when you
- have made your selection.
-
-
- Horizontal Bar Horizontal Bar
-
- A horizontal bar can be useful to separate a title from other text in the
- window. To make such a line appear, move the cursor to the line you want
- the bar on and press H. Only one bar can appear in a window. If a window
- already has a bar and you want the bar elsewhere, just follow the
- directions above and IMPRESSION will erase the old bar and draw a new one.
-
-
- No Bar No Bar
-
- To erase a bar from a window, use this option. The cursor doesn't need to
- be on the line the bar is on.
-
-
- Enter Text Enter Text
-
- Of course, the purpose of having all these windows is to display text.
- This is the option that lets you do so. Position the cursor on the line on
- which you want the text to appear. Press ENTER or RETURN and a dotted line
- appears. Now type any ASCII characters and press ENTER again. IMPRESSION
- does not word wrap, so you must repeat this procedure on each line you want
- text to appear.
-
-
-
-
-
-
-
- 6 - First Impression - Copyright 1992
-
-
-
-
-
- Justify Text Justify Text
-
- Justification controls the horizontal position of your text. There are
- three options; pressing J cycles through them. For added flexibility, this
- option affects only the line the cursor is on, not the whole window, so you
- must move the cursor to each line you want to change.
-
- Left By default, IMPRESSION left-justifies your text. That is,
- it appears flush with the left border of the window.
-
- Center Text appears centered between the left and right borders.
-
- Right Text is flush with the right border.
-
-
- Move Text Move Text
-
- Moving a line of text is easy. Position the cursor on the line you want to
- move and press M. Now position the cursor on the line to want to move the
- text to, and press RETURN. If there is already text on the line you want
- to move your text to, it will be moved to the line the moved text came
- from. In other words, the lines are swapped.
-
-
- Copy Text Copy Text
-
- To copy text from one line to another, position the cursor on the line of
- text you want copied, press C, move the cursor to the line you want to copy
- the text to, and press ENTER. Text already on that line is overwritten.
-
-
- Text Attributes Text Attributes
-
- This option brings up the familiar color chart and spinning bar and works
- just like Window Attributes above, except that it lets you change the
- colors of the line of text the cursor is on. As usual, you must move the
- cursor and repeat the procedure for every line whose text colors you want
- to change.
-
-
- Position Window Position Window
-
- This option will let you move the window from its default position on the
- screen to wherever you want it to appear during the installation. Press P,
- then use the arrow keys to move the window. Press C to center the window
- vertically and horizontally. Press ENTER when you're done.
-
-
- When you're done customizing a window, press ESC to return to the previous
- menu. From there you can choose a new window, a few of which are described
- further below.
-
-
- Other Windows Other Windows
-
- The Status Window is the area in the Copy Window that shows the progress of
- the file copying. Choosing Status Window from the Basic Window Options
- menu lets you change the color of the text that appears in the status area.
-
-
- Lincoln Beach Software - 7
-
-
-
-
-
- Background Window Background Window
-
- The Background Window is the area behind every window--that is, the
- background. Although the its Attribute Change option uses the familiar
- color box, its other options are unique, and are described below.
-
-
- Fill with Character Fill with Character
-
- Using this option, you can specify a character and IMPRESS will fill the
- background with it. You can choose one of the characters from the menu by
- moving the bar to that character and pressing ENTER. If you want to use a
- character that doesn't appear, choose Manual and type in the decimal ASCII
- code of the character you want. After you exit the menu by pressing ENTER,
- the background reflects any changes you made.
-
-
- Fill With String Fill With String
-
- You can create an interesting effect by using this option and your company
- or product name, or a slogan. Enter a string of characters and IMPRESS
- will fill the screen with it, wrapping it (not truncating) at the right
- side of the screen. Experiment with spacing to get the desired effect.
- This option works with the above option in that spaces you type in the
- string will be replaced with whatever character is specified under Fill
- With Character. Again, experiment to get the effect you want.
-
-
- REGISTRATION WINDOW REGISTRATION WINDOW
-
- This option lets you customize a window that asks the user for a user name,
- to be hard coded into your program's executable file. It will only appear
- if the hard coding option was enabled. You may customize it just like the
- Basic Install Windows above.
-
-
- INSTALLATION ENHANCEMENTS INSTALLATION ENHANCEMENTS
-
- Use the Install Enhancements menu options to personalize your installation.
- Using them will enable FIRST IMPRESSION to meet your program's specific
- installation needs.
-
-
- Configuration Description Configuration Description
-
- Enter a description of your installation. If INSTALL.EXE finds multiple
- .CFG files, it will display a menu with their descriptions so the user can
- decide which installation to use. For example, one could be a first-time
- install, another an update. Be as descriptive as possible so the user can
- make an informed choice.
-
-
- Default Subdirectory Default Subdirectory
-
- This option lets you set the default subdirectory into which the user
- installs the software. Nested subdirectories may be used (for example,
- \UTILS\MYPROG).
-
-
-
- 8 - First Impression - Copyright 1992
-
-
-
-
-
- You also have the option of forcing the user to install to the directory
- you specify. Otherwise, the user can change the directory by typing over
- the default.
-
-
- Batch File Batch File
-
- If you want INSTALL to create a batch file in the root directory, use the
- Batch File option. The name you give the file must contain the extension
- .BAT. An error message will appear if it is missing. If no batch file is
- specified, none will be created.
- The next two items are included in the batch file if one is created.
-
- The first is the name of the program that is called from the batch file.
- This is generally the filename of your program. If an application tool is
- used, such as Dbase, its name should appear in the File To Execute field
- and the application that has been developed, such as DATABASE.DBF, would
- appear in the Command Line Arguments field. In the batch file it would
- appear as:
-
- DBASE.COM DATABASE.DBF
-
- Of course, you may instead specify your program's name and any necessary
- command line arguments.
-
-
- AUTOEXEC.BAT AUTOEXEC.BAT
-
- With this option, you can add lines to the user's AUTOEXEC.BAT file.
- Simply type in what you want to add. If you place a caret (^) in a line of
- text, INSTALL replaces it with the destination path. If the directory is
- already in the path, or if lines have been added, they will not be added
- again. When the caret appears at the end of a line, the path will be
- appended:
-
- SET IMPRESS=^
-
- will become:
-
- SET IMPRESS=C:\IMPRESS
-
- However, if you put it in the middle:
-
- device=^driver.sys
-
- it will become:
-
- device=C:\IMPRESS\driver.sys
-
- Note that in the second example INSTALL inserts a second backslash
- automatically before the driver.sys command. If you want your drivers in a
- different subdirectory under your base directory you could have the line
- read:
-
- device=^subdir1\driver.sys
-
- and it will become:
-
- device=C:\IMPRESS\subdir1\driver.sys
-
- Lincoln Beach Software - 9
-
-
-
-
-
- This works the same in the CONFIG.SYS section.
-
-
- Path Path
-
- You are also asked if the user's path can be updated. If you answer Yes,
- the destination subdirectory will be added to the PATH statement in the
- user's AUTOEXEC.BAT. If INSTALL modifies the AUTOEXEC.BAT file the
- original is renamed to AUTOEXEC.HLD.
-
-
- CONFIG.SYS CONFIG.SYS
-
- Device Drivers Device Drivers
-
- Here you can add device drivers to the user's CONFIG.SYS file. Type in the
- name of the device driver that you wish to load in the fields available.
- These files must exist in the base directory that the software is being
- installed to. The lines created in the CONFIG.SYS file will occupy the
- first lines and will look like this:
-
- DEVICE=C:\MYPROG\DRIVER.SYS
-
-
- Files and Buffers Files and Buffers
-
- The next two fields are used to update the BUFFERS and FILES statements in
- the CONFIG.SYS file. If these statements don't provide sufficient
- resources, INSTALL will, after asking the user for permission, make a new
- CONFIG.SYS with the necessary changes. If the CONFIG.SYS file is edited,
- the original is renamed CONFIG.HLD. INSTALL will only check and change
- fields that have values filled in. Leaving a field blank will bypass that
- function.
-
- System System
-
- K Needed On Destination K Needed On Destination
-
- If you enter a value in the field K Needed On Destination Drive, at install
- time, the drive will be checked for the necessary free space. If it does
- not exist the user is informed that there is not enough space and the
- install is aborted.
-
- NOTE: 1,000 K = 1 Megabyte
-
-
- DOS Version Needed To Run DOS Version Needed To Run
-
- If the application being installed needs a minimum DOS version, it may be
- selected here. Simply choose the version from the list. If the user is
- running an older DOS version, a message will inform the user and the
- install will abort.
-
-
-
-
-
-
-
-
- 10 - First Impression - Copyright 1992
-
-
-
-
-
- Base Memory Needed Base Memory Needed
-
- If your program requires a minimum amount of base memory, that amount may
- be entered here. INSTALL checks for 256K, 512K, or 640K. Press the left
- and right arrows to cycle through the choices. If there is not enough
- memory, INSTALL will notify the user and the install will abort.
-
-
- Is a Math Coprocessor/Game Port/Mouse Required? Is a Math Coprocessor/Game Port/Mouse Required?
-
- These three fields are for checking the existence of hardware your program
- may require. There are three valid entries for these fields. Use the left
- and right arrow keys to make your selection. The three choices, and the
- results if the required hardware is not found, are: not
-
- Critical A message is displayed regarding the absence of the device and
- the install will abort.
-
- Helpful A message is displayed stating that the program will run without
- the device but it would be helpful if one existed. The
- installation will continue after the user presses a key.
-
- No The component is not needed and won't be checked for.
-
-
- Network Required? Network Required?
-
- INSTALL can detect a Novell network and abort the installation if one is
- not found or not allow your software to be installed onto a network drive.
-
-
- Monitor Required? Monitor Required?
-
- Here you can specify if you want INSTALL to ensure that the user has a
- Mono, CGA, or EGA/VGA graphics card. As usual, if the required hardware is
- not found, the installation aborts. During the install you can use the /N
- switch to bypass monitor detection or the /M switch to run in Black & White
-
-
- Sounds Sounds
-
- If sound is enabled and an error occurs at install time, a low tone will
- sound. If the user is prompted to change a disk or enter something, a
- chime will sound. If you want INSTALL to use sound during the
- installation, move the cursor to Sounds and press ENTER (or simply press
- O). This option is a toggle, and its status is indicated by an adjacent
- check mark. By repeating the above procedure you can turn sounds on and
- off.
-
-
- Hard Code Hard Code
-
- INSTALL lets you hard code the user's name into your program's executable
- file. You should test this before sending out your application. You are
- allowed 10 to 50 characters, and you must have a field in your program
-
-
-
-
-
- Lincoln Beach Software - 11
-
-
-
-
-
- predefined and filled with dollar signs for this feature to work. Here is
- an example of how to predefine the field in the C language:
-
- char user_name[31]="$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$";
-
- INSTALL searches your program's file for this string and replaces it with
- the registered user's name.
-
- Although the hard coding features works in most cases, there are a few
- special situations you should be aware of:
-
- Some programs, such as those written for Dbase, may not be able to use
- this feature. Such files have not been tested so you will have to try
- them on your own.
-
- If you choose to code the files while they are on the source disk, they
- must reside on the first disk.
-
- If you compress your executable with PKLITE or LZEXE, this feature will
- not work.
-
-
- Hard Code Name Hard Code Name
-
- Toggle this option on to enable the hard coding feature.
-
-
- Location of Programs Location of Programs
-
- You can toggle hard coding of the source disk, the destination disk, or
- both. Obviously, the source disk must not be write protected if you want
- files on it to be hard coded.
-
-
- Files to Code Files to Code
-
- IMPRESSION prompts you for the names of the files to be hard coded. One or
- two files may be coded.
-
-
- Length of Field Length of Field
-
- Enter the length of the field predefined in your program (the series of
- dollar signs). INSTALL will look for a field exactly this long.
-
-
- Exit Program Exit Program
-
- When INSTALL completes the installation, it will run the program specified
- here. The exit program may be a .BAT file, but it will not remove
- INSTALL.EXE from memory before executing as do .EXE or .COM files. Keep
- that in mind if your application needs a lot of memory. You may want to
- enter the name of your configuration or setup program so it will run
- automatically. If an exit program is specified, the user is not returned not
- to the INSTALL program.
-
-
-
-
-
- 12 - First Impression - Copyright 1992
-
-
-
-
-
- FILES TO COPY FILES TO COPY
-
- When you select the menu option Files To Copy, a window will appear with
- spaces for you to enter the names of files to be copied from the source
- disk to the destination. Up to 54 filespecs can be selected for copying.
- The files will be copied in the order they appear in the window. Here is
- an example entry list. The line of underscores represents a blank entry.
-
- !DISK #1
- myprog.pak
- unpack.exe
- Progr??.exe
- &myfile.*
- ____________
- mydata.dat
-
-
- Blank Entries Blank Entries
-
- You may use wildcards as shown. Blank entries are not allowed between
- filenames. In the above example, MYDATA.DAT and anything that follows will
- not be copied to the destination. not
-
-
- Multiple Disks Multiple Disks
-
- You may use multiple disks. If a certain file cannot be found INSTALL
- prompts the user to either insert the correct diskette or to abort. The
- user may insert the correct diskette and press any key; INSTALL will try to
- find the file again.
-
- Note that the first name in the list of files starts with an exclamation
- point. When INSTALL encounters one of these entries, it prompts the user
- to insert the disk labeled (in this case) "DISK #1." After the user hits a
- key, INSTALL will start searching for files to copy. You should make a
- disk label entry for each disk in your distribution set. Follow each one
- with the filespecs for that diskette. Otherwise, when INSTALL can't find a
- file it will ask the user to put in the next or correct disk. The user may
- not know which disk is the correct one. By using these entries, you will
- make it easier for your users to correctly install your program.
-
- If the user tries to reinstall the application, INSTALL will search the
- destination directory for the first file. If it exists, INSTALL will
- prompt the user if a reinstall is desired. If not, the install is aborted.
- It only checks the first file.
-
- If you don't want to type individual filenames you can enter the
- information like this:
-
- !Disk #1
- *.*
- !Disk #2
- *.*
- !Disk #3
- *.*
- (more as needed)
-
- This will copy all the files in the root directory on each disk and prompt
- the user for each disk in the set.
-
- Lincoln Beach Software - 13
-
-
-
-
-
-
- READ ME FILES READ ME FILES
-
- INSTALL can display text files for browsing before and after installation.
- Use this option to display text too long to fit in a window, such as what
- to expect during installation, detailed features lists, program
- requirements, and contact information. The Read Me Files option lets you
- enter up to four filenames, one file to be displayed unconditionally before
- the installation, three afterward. The file to be displayed before
- installation must reside on the first source disk and must not be a
- compressed file. Each Read Me file will be shown to the user, with
- keystroke help on the bottom line of the screen. The user can use the
- usual arrow keys, HOME/END, and so on, and can quit the browser by pressing
- ESC.
-
- NOTE: If you are using the BASIC install, the 'READ ME' files may not
- exceed 30K each; if you are using the INSTALL.WIN file, the 'READ
- ME' files may not exceed 20K each. Heed this warning.
-
-
- DOCUMENTS TO PRINT DOCUMENTS TO PRINT
-
- You may want your new users to print your program's documentation. This
- feature of INSTALL lets them do just that. You can enter up to ten
- filespecs (including wildcards) to be copied to a printer during the
- install. If there are multiple printer ports, INSTALL will give the user
- the option of selecting a port.
-
-
- DOS INSTRUCTIONS DOS INSTRUCTIONS
-
- This option will give you fifteen lines to be used to enhance the install.
- All of these commands are executed from within the subdirectory created
- during the install.
-
- For example, you may have copied compressed files to the destination, and
- now want to be able to unpack the files, then delete the packed files and
- others that are not needed. Using the file list example in the Selecting
- Files section you could enter the following in this section:
-
- unpack myprog.pak >NUL
- &myfile.fil
-
- &MYFILE.FIL would contain the below lines. It would set up the software in
- multiple directories.
-
- MD MYSUB
- RELOCATE *.DAT MYSUB
- DEL MYPROG.PAK
- DEL &MYFILE.FIL
-
-
-
-
-
-
-
-
-
-
- 14 - First Impression - Copyright 1992
-
-
-
-
-
- Three commands are available with the &myfile.fil approach:
-
- MD Makes a Directory
- RELOCATE Moves a file by copying it to the destination then deleting it
- from the source
- DEL Deletes a file
-
- NOTE: If you are using the Device Driver option (in the CONFIG.SYS menu)
- do not move the device driver files from the base directory unless do not
- you specify it differently in the DOS Command section.
-
- The filename must begin with an ampersand ("&") and the rest of the
- filename can contain any valid filename characters. By create a file like
- &MYFILE.FIL, all copy routines are performed by internal code and will not
- change the screen. Normal batch files may be used but the screen has been
- known to scroll during the operation, creating an unprofessional mess.
-
-
- Drive Letter Substitution Drive Letter Substitution
-
- When distributing software you don't know which disks will be used during
- installation. This can cause problems. For example, the command:
-
- A:PKUNZIP A:MYPROG.ZIP C:
-
- would not work if the user were installing from B: to D:. With FIRST
- IMPRESSION, this problem can be easily resolved by using parentheses in the
- command. During the install, the open parenthesis "(" is replaced by the
- source drive and the close parenthesis ")" is replaced by the destination
- drive. So to make the previous command line more flexible, change it to
- this:
-
- (:PKUNZIP (:MYPROG.ZIP ):
-
- During the processing of this line it will be changed to:
-
- B:PKUNZIP B:MYPROG.ZIP D:
-
- DOS commands are executed after all the files have been copied to the
- destination drive. If you want to use the above example you must have only
- one distribution disk or the files in question must be on the last disk.
-
-
- DOS Command Processing DOS Command Processing
-
- DOS command functions are handled as if you are at the command prompt. For
- example, if you reference any external DOS command, it must be in the path
- the user has set up, otherwise the command will not work.
-
- Also be aware that all commands are executed "behind" the window that the
- user sees. If you are using a program that unpacks a file, and the file
- already exists, it would normally display a message such as: "Files exits,
- replace it (Y/N)?" The user may not see this prompt and may think the
- system locked up when actually a simple press of the 'Y' key would allow it
- to continue.
-
- The way to avoid this is to use a command line option that will unpack the
- file whether it exists or not. See the documentation for your specific
- "unpacker" to find out how this is done. For example, PKUNZIP from PKWARE,
-
- Lincoln Beach Software - 15
-
-
-
-
-
- Inc., has the option ("-o") to overwrite existing files. Another popular
- compression program, LHA, which creates files with the LZH extension, does
- not have an overwrite option at this time and could cause this problem if a
- file already exists. A work-around would be to create a file that contains
- as many Y's as there are files and redirect the input. So the command:
-
- LHA E MYPROG.LZH >NUL
-
- would become:
-
- LHA E MYPROG.LZH <REPLY.DAT >NUL
-
- REPLY.DAT would contain a series of Y's.
-
-
- FILE COPY DISPLAY FILE COPY DISPLAY
-
- When files are being copied or printed, the user may start to wonder if the
- machine has locked up. To assure the user that progress is being made,
- select one of these options. Each has a different way of showing activity.
- The first four are just for amusement. Options five and six are more
- useful, and show the percentage of the current file that has been copied or
- printed. Press the number corresponding to your choice.
-
-
- MEDIA SELECTION STYLE MEDIA SELECTION STYLE
-
- IMPRESSION gives you two options for letting the user select the source and
- destination drives and subdirectories. Press 1 or 2 to make your
- selection.
-
- Option 1 will display a window to show the user which floppy drives are
- available to install from. After the user selects the source drive (let's
- say A:), another window will appear showing all the drives the software can
- be installed to. Finally, the user is asked for the subdirectory to
- install to. If one was entered in Install Enhancements, it will appear in
- the field. The user may change the subdirectory unless you opted not to
- let him in the Install Enhancements section.
-
- Option 2 is less bullet-proof but more flexible. It will open a window and
- prompt the user for a source drive, a destination drive, and a destination
- subdirectory. The default source drive field will already hold the drive
- letter the install was started from. Using this option, users can install
- from one subdirectory on a hard drive to another. This is great for users
- who will get your software from a BBS. Note that option 1 does not allow
- this.
-
-
- Confirmation Option Confirmation Option
-
- You will now be asked if an optional confirmation window should appear. If
- you press Y for Yes, during the install a window will appear after the
- drives and directory have been selected, confirming the choices made. If
- the user declines the choices made, the selection process will begin again.
-
-
-
-
-
-
- 16 - First Impression - Copyright 1992
-
-
-
-
-
- VIEW BASIC INSTALL VIEW BASIC INSTALL
-
- This option will show you each window in turn as it will appear during the
- installation. Press a key to see the next window.
-
-
- GENERATE DISTRIBUTION DISKS GENERATE DISTRIBUTION DISKS
-
- This option will automatically build your distribution disk set. First you
- need to copy the installation programs you will use to the first disk, such
- as INSTALL.EXE, INSTALL.CFG, SETUP.EXE, INSTALL.WIN, or UPDATE.CFG. Then
- select this option and enter the drive and subdirectory in which your files
- are stored, and the destination drive. This will put all the files in the
- specified directory onto the floppy drive. They are copied according to
- size, largest to smallest. This sorting method reduces the number of disks
- you will need. To abort this process, press a key.
-
- NOTE: Do not put any files that already reside on the first floppy disk not
- into the source subdirectory. Doing so will waste valuable disk
- space.
-
-
- LOADING AND SAVING CONFIGURATIONS LOADING AND SAVING CONFIGURATIONS
-
- These options either save the current configuration to a file or load a
- previously-saved configuration. If you have already saved a configuration
- file during your session, IMPRESSION will automatically create a backup of
- it, giving it the extension .BK!. Note that the final configuration file
- for INSTALL.EXE must be named INSTALL.CFG if it is the only CFG file on the
- disk.
-
-
- SHELL TO DOS SHELL TO DOS
-
- If you need to exit to DOS temporarily without leaving the FIRST IMPRESSION
- program, simply select this option and you will shell to DOS. Type EXIT at
- the DOS prompt to return to FIRST IMPRESSION.
-
-
- QUIT QUIT
-
- To quit FIRST IMPRESSION and return to the DOS prompt, select this option.
- FIRST IMPRESSION will remind you to save the current configuration file
- before you go.
-
- FINISHING UP FINISHING UP
-
- Upon completing your configuration file, either use the Generate
- Distribution Disk option above, or simply copy INSTALL.EXE, INSTALL.CFG,
- and the files that compose your application and you're done. It's that
- easy! The user simply types A:INSTALL and enjoys a professional
- installation of your program. And you save a lot of work by using FIRST
- IMPRESSION. Enjoy!
-
- UNINSTALL OPTION UNINSTALL OPTION
-
- INSTALL has an uninstall option. This is a destructive option. To perform destructive
- an uninstall, the user types:
-
-
- Lincoln Beach Software - 17
-
-
-
-
-
- INSTALL /U
-
- This will prompt the user twice with "are you sure" questions. If either
- is answered "No" the uninstall will abort. Otherwise, it will erase all all
- subdirectories and files from the base directory down, regardless of
- whether they are part of your program. So if the user installed the
- program in the subdirectory \MYPROG and the user created several other
- directories for data and other files, MYPROG and all the other directories
- would be removed.
-
- NOTE: DO NOT document this option if you do not want the user to know
- about it. Its effects are permanent unless you know how to use an
- undelete program. It will not remove hidden files. If they exist,
- their directory will not be removed.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 18 - First Impression - Copyright 1992
-
-
-
-
-
- INSTALLATION FLOWCHART INSTALLATION FLOWCHART
- The following list describes INSTALL's operation in detail. This is what
- happens at installation time.
- 1. Checks for an multiple CFG files. If more than one exists a menu
- appears asking the user to decide which installation should be
- executed. If only the INSTALL.CFG file exists it loads that one and
- runs.
- 2. Checks for specified items such as DOS version running, math
- coprocessor, base memory, network, and game port. The options
- selected in the Installation Enhancements section will determine the
- course of the installation.
- 3. The greeting window will appear. INSTALL waits to continue until the
- user presses a key.
- 4. The program window will appear along with the Directory Information
- screen. In this window the user enters the source and destination
- drive and directory.
- 5. If the option for a "confirmation screen" was selected, it will
- appear asking if the selected drive specifications are correct. If
- not, it will return to the Directory Information screen.
- 6. Confirms that the destination drive exists.
- 7. Confirms adequate disk space exists.
- 8. If the user's name is to be hard coded on the source drive, the name
- is requested and the hard coding is performed.
- 9. Checks if the destination directory already exists. If not it
- creates it; if so it will ask the user if INSTALL should use the
- existing directory.
- 10. Checks if the first file to be copied exists in the destination
- directory. If so, asks if user wants to reinstall. If so, file
- copying commences.
- 11. If the user's name is to be hard coded on the destination drive, that
- function is performed.
- 12. Executes the commands in the DOS Command section.
- 13. Prompts the user to print documentation. If the user wishes to do
- so, INSTALL will automatically sense the available ports to print to
- and asks the user to select the desired port.
- 14. Prompts user to add the destination directory to the PATH statement
- in the AUTOEXEC.BAT file.
- 15. Prompts user to add environment variable to the AUTOEXEC.BAT file.
- 16. If either of the above two options has been selected, INSTALL will
- modify the AUTOEXEC.BAT file after copying it to a file named
- AUTOEXEC.HLD. It will also notify the user that changes have been
- made.
- 17. Prompts the user to confirm that the number of FILES and BUFFERS are
- sufficient. If the user grants permission, INSTALL will check the
- statements and write a new CONFIG.SYS if necessary.
- 18. Asks the user if INSTALL should automatically add Device Drivers to
- the CONFIG.SYS file.
- 19. If either of the above two options have been selected, it will modify
- the CONFIG.SYS file after it has been copied to a file named
- CONFIG.HLD. It will also notify the user that changes have been
- made.
- 20. Prompts the user to read any README files.
- 21. If changes were made to the CONFIG.SYS file, the user is asked if
- INSTALL should reboot the machine. If so, execution does not return
- to the INSTALL program.
- 22. At the end of the install, the Exit Program, if specified, will be
- executed. The user may not be returned to INSTALL after leaving the
- Exit Program depending on how it was performed.
-
-
- Lincoln Beach Software - 19
-
-
-
-
-
- CUSTOMIZED INSTALLATIONS WITH SETUP.EXE CUSTOMIZED INSTALLATIONS WITH SETUP.EXE
-
- Instead of using IMPRESSION's preconfigured installation procedure, you can
- create a unique installation by using SETUP.EXE. SETUP will allow you to
- obtain a totally customized install utilizing many windows and functions.
- Whereas IMPRESSION creates an installation script for you (INSTALL.CFG),
- with SETUP, you create the script manually, giving you added flexibility.
- You control all window routines except for the File Copy window that
- appears during the installation process. This window is where all the
- actual installation takes place. All prompting messages will appear in
- this window.
-
- There can be up to 26 windows open at a time, each named for a letter of
- the alphabet. First determine the appearance of a window. Consider the
- size, colors, text, titles, and the message you wish to convey. Of course,
- the attributes may be changed at any time.
-
- To use these windows, create a file called INSTALL.WIN. Use a text editor
- or word processor that will save ASCII text. Look at the INSTALL.WIN file
- that came with IMPRESSION. It will show you many things that can be done
- with windows.
-
- After you create the INSTALL.WIN file you may check it for trouble spots by
- using CHECKWIN.EXE. It will display any errors it finds in the INSTALL.WIN
- file. It will display the line number and what problem it discovered. It
- does not check for the format of the lines, but only what you are doing to
- a window.
-
- If you use SETUP to create your install, you need to copy two extra files
- to the source disk: SETUP.EXE and INSTALL.WIN. On the distribution disk
- you tell the user to type A:SETUP instead of A:INSTALL. SETUP.EXE is the
- only file that may be renamed.
-
- The syntax diagrams below for defining and using windows will be your guide
- to creating the ultimate installation.
-
- In the syntax diagrams below, you must specify color attributes for the
- windows. These are the values to use:
-
- Background/Foreground Foreground Background/Foreground Foreground
- 0 = Black 8 = Dark gray
- 1 = Blue 9 = Light blue
- 2 = Green 10 = Light green
- 3 = Cyan 11 = Light cyan
- 4 = Red 12 = Light red
- 5 = Magenta 13 = Light magenta
- 6 = Brown 14 = Yellow
- 7 = Light gray 15 = Bright white
-
- By adding eight to the background color the characters will blink on the
- screen. Because SETUP doesn't ensure that the color values fall in this
- range, check your work carefully.
-
-
-
-
-
-
-
-
- 20 - First Impression - Copyright 1992
-
-
-
-
-
- SYNTAX FOR WINDOW ROUTINES SYNTAX FOR WINDOW ROUTINES
-
- Creating a Background Creating a Background
-
- B, ,1,14
-
- B - Fill screen routine.
- - Character to fill the screen with.
- 1 - Background color to use.
- 14 - Foreground color to use.
-
- All windows should be closed before calling this routine. If not, and a
- window that was created with an old background is closed afterward, the old
- background will show through, ruining the display.
-
-
- Opening a Window Opening a Window
-
- OC,800,14,40,35,8,7,14,1,14,3,0
-
- OC - Open window C. There can be 26 windows, named A-Z.
- 800 - Window Type. The four window types are:
- 0 = Normal window
- 500 = Shadowed window
- 800 = Exploding window
- 1000 = Borderless window
- 14 - Top line. Lines are numbered starting at zero.
- 40 - Left column. Columns are numbered starting at zero.
-
- (The above two numbers determine the top left corner of the window.)
-
- 35 - Width in columns. The left-most column plus the width must be no
- larger than 80.
- 8 - Height in lines. The top line plus the height must be no larger
- than 25.
- 7 - Background attribute of the border
- 14 - Foreground attribute of the border
- 1 - Background attribute of the window
- 14 - Foreground attribute of the window
- 3 - Line of window in which to put a horizontal bar. Numbering
- starts at one for the first line of the window, regardless of its
- screen position.
- 0 - Column of window in which to put a horizontal bar.
-
- (In the above two fields, a zero means there is no bar of that type.)
-
-
- Closing a Window Closing a Window
-
- CC
- CC - Close window C.
-
-
- Clearing a Window Clearing a Window
-
- WC
- WC - Wipe window C. This erases all text in the window. The window
- stays open. Be careful with this because if there are bars in
- the window they will also be cleared.
-
- Lincoln Beach Software - 21
-
-
-
-
-
-
- Moving Bars in a Window Moving Bars in a Window
-
- VA,4
- V - Move a Vertical bar to a new location.
- A - The window in which to perform the operation.
- 4 - The column in which to make the bar appear.
-
- HA,4
- H - Move a Horizontal bar to a new location.
- A - The window in which to perform the operation.
- 4 - The line in which to make the bar appear.
-
- By setting the bar position to 0 it will remove the bar from the window
- selected.
-
-
- Setting Border Characters Setting Border Characters
-
- S3
- S3 - Sets the border to border set 3. Valid values are one through
- ten.
-
-
- Moving a Window Moving a Window
-
- MC,5,10
- MC - Move Window C.
- 5 - Line to move to.
- 10 - Column to move to.
-
-
- Putting Text in the Window Putting Text in the Window
-
- STYLE #1: CENTERED
-
- LAC,3,Welcome To My Program
- LAC - Line of text in Window A; C is for centering it horizontally.
- 3 - Line in window to put the text
- Wel - Text to put in the window.
-
-
- STYLE #2: PLACED AT COL,ROW
-
- LAL,5,10,More words
- LAL - Line of text in window A; L is for Left justify
- 5 - Row in which to put the text.
- 10 - Column in which to put the text.
- Mor - Text to put in the window.
-
-
-
-
-
-
-
-
-
-
-
- 22 - First Impression - Copyright 1992
-
-
-
-
-
- Putting Titles on Borders Putting Titles on Borders
-
- TA,3,MY TITLE
- TA - Put a title in Window A.
- 3 - Put title in location 3. Valid locations are 1-6.
- 1 = Top Right
- 2 = Top Left
- 3 = Top Center
- 4 = Bottom Right
- 5 = Bottom Left
- 6 = Bottom Center
- MY - Text to put in the title. This text will appear in the border,
- overwriting the default border characters.
-
-
- Changing the Window Attribute Changing the Window Attribute
-
- ABW,4,14
- ABW - Attribute change for window B affecting subsequent Window writes.
- 4 - New background color.
- 14 - New foreground color.
-
-
- Changing the Border Attribute Changing the Border Attribute
-
- ACB,4,14
- ACB - Attribute change in window C affecting subsequent Border writes.
- 4 - New background color.
- 14 - New foreground color.
-
-
- Pausing Screen Activity Pausing Screen Activity
-
- P5
- P5 - Pause the screen for approximately 5 seconds. This procedure
- will pause the screen for the specified number of seconds or
- until a key or mouse button is pressed. Using P1 will have
- almost no effect. If the user pressed ESC, the install is
- aborted.
-
-
- Starting the Installation Starting the Installation
-
- *
- * - That's it, just an asterisk (*). It must be the first character
- on the line. You may have more window activity after you perform
- the install. This procedure calls INSTALL.EXE from the drive the
- install originated from.
-
-
-
-
-
-
-
-
-
-
-
-
- Lincoln Beach Software - 23
-
-
-
-
-
- INDEX INDEX
-
- Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
- Attributes, text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- AUTOEXEC.BAT, updating . . . . . . . . . . . . . . . . . . . . . . . . . 9
- Background window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Bar, horizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Bar, none . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Bars, moving in a window . . . . . . . . . . . . . . . . . . . . . . . 22
- Base memory needed . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Basic installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
- Batch file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
- Blank entries in file list . . . . . . . . . . . . . . . . . . . . . . 13
- Border attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
- Border attributes, changing . . . . . . . . . . . . . . . . . . . . . . 23
- Border characters, setting . . . . . . . . . . . . . . . . . . . . . . 22
- Border, type of . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Borders, putting titles on . . . . . . . . . . . . . . . . . . . . . . 23
- Center text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Changing border attributes . . . . . . . . . . . . . . . . . . . . . . 23
- Changing window attributes . . . . . . . . . . . . . . . . . . . . . . 23
- CHECKWIN.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
- Clearing a window . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Closing a window . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Color attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
- Command line options . . . . . . . . . . . . . . . . . . . . . . . . . 15
- CONFIG.SYS, updating . . . . . . . . . . . . . . . . . . . . . . . . . 10
- Configuration description . . . . . . . . . . . . . . . . . . . . . . . . 8
- Configuration files
- Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Saving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Confirmation option . . . . . . . . . . . . . . . . . . . . . . . . . . 16
- Copy text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Copying, files to . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
- Copyright statement . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
- Creating a background . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Customized installations with Setup . . . . . . . . . . . . . . . . . . 20
- Default subdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Device drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- Disk labels in file list . . . . . . . . . . . . . . . . . . . . . . . 13
- Disk space needed on destination . . . . . . . . . . . . . . . . . . . 10
- Distribution disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
- Distribution disks, generating . . . . . . . . . . . . . . . . . . . . 17
- Documents to print . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- DOS command processing . . . . . . . . . . . . . . . . . . . . . . . . 15
- DOS instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- DOS version needed to run . . . . . . . . . . . . . . . . . . . . . . . 10
- DOS, shelling to . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Drive letter substitution . . . . . . . . . . . . . . . . . . . . . . . 15
- Enter text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Exit program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
- Field length to hard code . . . . . . . . . . . . . . . . . . . . . . . 12
- File copy display . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
- File Copy window . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
- Files and buffers, updating . . . . . . . . . . . . . . . . . . . . . . 10
- Files to copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
- Files to hard code . . . . . . . . . . . . . . . . . . . . . . . . . . 12
- Fill with character . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Fill with string . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
-
- 24 - First Impression - Copyright 1992
-
-
-
-
-
- Finishing up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Game port requirements . . . . . . . . . . . . . . . . . . . . . . . . 11
- Generate distribution disks . . . . . . . . . . . . . . . . . . . . . . 17
- Hard code name . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
- Hard coding user name . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Horizontal bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Impression menu options . . . . . . . . . . . . . . . . . . . . . . . . . 5
- INSTALL.WIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
- Installation enhancements . . . . . . . . . . . . . . . . . . . . . . . . 8
- Installation flowchart . . . . . . . . . . . . . . . . . . . . . . . . 19
- Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
- Justify text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- K needed on destination . . . . . . . . . . . . . . . . . . . . . . . . 10
- Left justify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Length of field to hard code . . . . . . . . . . . . . . . . . . . . . 12
- LHA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
- Liability waiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
- Location of programs to hard code . . . . . . . . . . . . . . . . . . . 12
- Locked-up system . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
- Math coprocessor requirements . . . . . . . . . . . . . . . . . . . . . 11
- Media selection style . . . . . . . . . . . . . . . . . . . . . . . . . 16
- Memory needed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Monitor requirements . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
- Mouse requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Move text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Moving a window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
- Moving bars in a window . . . . . . . . . . . . . . . . . . . . . . . . 22
- Multiple disks in file list . . . . . . . . . . . . . . . . . . . . . . 13
- Network requirements . . . . . . . . . . . . . . . . . . . . . . . . . 11
- No bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Ombudsman statement . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
- Opening a window . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Other windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Path, updating . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- Pausing screen activity . . . . . . . . . . . . . . . . . . . . . . . . 23
- PKUNZIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
- Position window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Printing documents . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- Putting text in a window . . . . . . . . . . . . . . . . . . . . . . . 22
- Putting titles on borders . . . . . . . . . . . . . . . . . . . . . . . 23
- Quitting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Read-me files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
- Registration window . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Right justify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Setting border characters . . . . . . . . . . . . . . . . . . . . . . . 22
- SETUP.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
- Shell to DOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Sounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- Space needed on destination . . . . . . . . . . . . . . . . . . . . . . 10
- Starting the installation . . . . . . . . . . . . . . . . . . . . . . . 23
- Status window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Substituting drive letters . . . . . . . . . . . . . . . . . . . . . . 15
- Support statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
- Syntax for window routines . . . . . . . . . . . . . . . . . . . . . . 21
- System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
- Text attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Text, copying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Text, entering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
-
- Lincoln Beach Software - 25
-
-
-
-
-
- Text, justifying . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Text, moving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Text, putting in a window . . . . . . . . . . . . . . . . . . . . . . . 22
- Type of border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Type of window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Uninstall option . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Vias & Associates . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
- View basic install . . . . . . . . . . . . . . . . . . . . . . . . . . 17
- Window attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
- Window attributes, changing . . . . . . . . . . . . . . . . . . . . . . 23
- Window routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Window types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
- Window, background . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Window, moving . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
- Window, positioning . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Window, registration . . . . . . . . . . . . . . . . . . . . . . . . . . 8
- Window, status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
- Window, type of . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
- Windows, other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 26 - First Impression - Copyright 1992
-
-
-