Between Heaven & Hell 2

home *** CD-ROM | disk | FTP | other *** search

/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 100 / 85 / popedit.doc < prev next >

Wrap

Text File | 1987-04-05 | 21KB | 458 lines

PopEdit - Underdog's Universal PopUp Screen Editor POPEDIT, SPOP, LPOP are copyright (C) 1986 by: Crater Rim and Procrustion Software 4028 41st Ave So. Seattle, Wa. 98118 PopEdit is a unique program which allows the user to create, edit and save an unlimited number of memory resident PopUp Screens which may be loaded into memory as pages and called up upon request, in any application. The user has the option of creating a small (20 line by 29 column) or large (24 line by 62 column) Memory Resident PopUp Screen. Additionally, the user may reload an existing PopUp Screen into PopEdit and modify it as required. Running PopEdit is pretty straight forward so I wont bore you with alot of words here. The main thing to remember is that the editor in itself is non-destructive as long as you do not answer 'Y' to the 'save PopUp' prompt! In other words, you may play with PopEdit all day long without damaging any existing PopUp files. Answering 'N' to the 'save PopUp' prompt will simply return you to DOS. Due to the fact that the user may create two different sized PopUps, it should be noted that some of the information within the program will change according to the size screen you are working on. These changes are: - LPOP.COM is the Default PopUp filename for the large PopUp - SPOP.COM is the Default PopUp filename for the small PopUp - Ctrl-LeftShift is the default 'trigger' for the large PopUp - Ctrl-RightShift is the default 'trigger' for the small PopUp Getting Started ~~~~~~~~~~~~~~~ Since PopEdit is destructive to any existing files holding the default PopUp filenames (LPOP.COM and SPOP.COM), make sure you make a backup copy of your original files each and every time you start up PopEdit. Once you have executed PopEdit you will be asked if you wish to edit a Small or Large PopUp. Make your selection by pressing 'S' or 'L' (upper or lower case). In most cases, you do not have to press [ENTER]. If you select 'Q' at this point, you will exit right back to DOS. The Main Menu ~~~~~~~~~~~~~ Your options are pretty well self explanitory: C)hange PopUp size - allows you to change from one size PopUp to the other. D)isk write PopUp - allows you to save your present PopUp without having to exit to DOS. This opens up your working screen so that you may create another PopUp screen. E)dit current PopUp - allows you to edit the PopUp screen H)elp with PopEdit - will display a short tutorial on using PopEdit and its associated PopUp screens O)rder Form - There is a built in licensing agreement/order form which will print out either to your screen or printer - your option. WARNING to ALL USERS: You MUST comply with the information contained in this section. R)ead in an existing PopUp - prompts you for a filename, reads in that file and goes immediately to the edit section. Be SURE the filename you specify is the same size as the choice you made upon startup! S)et border and colors - allows you to choose between two different types of borders and a multitude of foreground and background colors for both text and border. Q)uit PopEdit - This is your exit command. If you have made any changes to the PopUp you were editing, your present screen will be displayed and you will be asked if you wish to save it. Editing the PopUp Screen ~~~~~~~~~~~~~~~~~~~~~~~~ You will have the full PopUp displayed to you while in the Edit mode. You simply have to specify which line you wish to edit and the cursor will be placed on that line. When you have finished with that line, simply hit [ENTER] and your text will be stored into the PopUp. Don't worry if you go past the end of the line during your input as only the one line will be stored. The entire screen will be restored once you hit [ENTER]. Several points here: While editing a line, hitting the [Home] key will erase the present line and return you to the start of that line. While editing a line, hitting [ENTER] alone will erase the previous line, thus blanking out that line in the PopUP buffer. If you have just completed editing a line, if you hit [ENTER] at the 'which line' prompt, you will be returned to that line once again. Remember that an additional [ENTER] at this point will erase whatever you had on that line! Once you have finished editing, simply enter 0 and you will be returned to the main menu screen. Setting Border and Colors ~~~~~~~~~~~~~~~~~~~~~~~~~ Again, you will be working with the full PopUp screen. This time there wont be any line numbers though as your changes here effect the overall screen. Your prompt line in this section depicts the 4 arrow keys with explanations as to what colors each one controls. The adjacent text will reflect the current foregraound and background colors so if you are altering colors on a blank PopUp screen, you will still have a general idea of what the finished scree will look like. The last option (Line) allows you to select between the current Block border and a double line border. This option change to be the opposite of the current displayed border is. Pressing 'L' (or 'B') will toggle between the two border options. Press the 'Q' option when you are satisfied with the appearance of the PopUp screen. Quitting PopEdit ~~~~~~~~~~~~~~~~ If you have made any changes to the current PopUp screen in memory, that screen will be displayed to you and you will be asked if you wish to save it. A word of caution here: There isn't any pactical way of insuring against all of the possible filename combinations you can enter here. So, the only checks that are made are in the filename extension - which MUST be .COM - and the total length of the specified filename - which MUST be between 5 and 12 characters. BE EXTREMELY CAREFUL when entering your filename. If there is an error, PopEdit will inform you of the error, but if the save is being made through the Q)uit option, you will be returned to DOS WITHOUT saving the edited screen. The filename that appears in the square brackets is the default fielname. If you simply hit [ENTER] at the filename prompt, the default filename will be used. If that file already exists, PopEdit will inform you of that fact and ask if you wish to overwrite the existing file. Reading in an existing PopUp ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ What applies for saving a PopUp also applies to reading in an existing PopUp. Be careful with filenames and MAKE SURE you are reading in the same size file as what you specified upon starting up PopEdit. If the filesize is not the same as you specified with the Small or Large choice, PopEdit will inform you of the error and return you to the main menu. Disk Writing PopUp ~~~~~~~~~~~~~~~~~~ This option allows you to save your current PoUp screen and start another of the same size. Be sure to specify a different filename for the next screen so that you don't overwrite the previous one by mistake! Changing PopUp Sizes ~~~~~~~~~~~~~~~~~~~~ This option allows you to to switch from editing one size PopUP screen to the other size. If you have made any changes, PopEdit will ask if you wish to save your current PopUp before switching. If you wish to save the current screen regardless, use the D)isk write PopUP option. The Main Menu prompt line will display the current PopUp size in the square brackets. Lastly, there are areas of checking I specifically left out - such in the area of DOS filename conventions - as I felt it would be better for the program to abort rather than damaging any existing PopUp files. Regardless, I recommend that you copy your working copy of PopEdit and any existing PopUp files that you intend to read in and edit onto a separate diskette or into an empty directory. Do your editing there out of 'harm's way'! If you use PopEdit in this manner, you can then save the PopUp files you create using the default filename. Then, once you exit PopEdit, you can copy the PopUp files and rename them at the DOS level. Enjoy... Underdog- Version 1.00 - 11/15/86 - Original release Version 1.01 - 11/19/86 - Minor refinements of the original coding Version 1.02 - 11/21/86 - Added Change border option - Block or Double Line - Moved text editing from line below display to within the displayed PopUp Version 1.03 - 11/25/86 - Rewrote code to accomodate revised Ass'y code for new PopUps .COM files Version 1.04 - 11/26/86 - Added the first pass at setting colors - Finished POPUP.COMs are the exact size as the originals now - Closed up the 'window' while editing so you don't overwrite the borders on all lines except the second and last - If nothing is changed when you enter the E)dit section, you will not be prompted to create a new PopUp - While editing, hitting [ENTER] alone, for input to a line will write a blank line (quick removal of previous text) Version 1.05 - 11/27/87 - Changed coding of Set Colors routine to show actual PopUp as opposed to mockup screen Version 1.05A - 11/28/86 - Corrected bug in color display during Color Set and Editing Version 1.06 - 11/28/86 - Combined the Change Border and Set Colors routines - Command line in the Set Border and Colors routine now reflects the actual ForeGround and BackGround colors - Border select option now displays only the other border type ie: when PopUp Border is Block, command line prompts for Line when PopUp Border is Line, command line prompts for Block Version 1.07 - 11/29/86 - Cleaned up the code eliminating the redundancy Version 2.00 - 11/29/86 - Combined SPOPED and LPOPED into POPEDIT - Added built in licensing agreement/order form/warranty information with either print to Screen or print to Printer option - Added file/filename checking and file overwrite protection - Added write PopUp to disk without exit to DOS option - Added switch PopUp size without exit to DOS option - Added current PopUp size (L or S) to main menu prompt line - First public release Take care... Underdog- LICENSE All versions of Underdog's PopUp Editor and the associated PopUp files it creates are not public domain software, nor are they free software. PLEASE NOTE: For the sake of clarity, all references and restrictions to the use of the PopUp Editor, POPEDIT also apply to the associated POP.COM files this editor creates. POPEDIT, SPOP and LPOP are copyright (C) 1986 by Crater Rim Software Non-registered users are granted a limited license to use POPEDIT on a trial basis for the purpose of determining whether these programs are suitable for their needs. Use of POPEDIT, except for this limited purpose, requires registration. Use of non-registered copies of POPEDIT by any person, business, corporation, governmental agency or other entity institution is strictly forbidden. Registration permits a user the license to use POPEDIT to create an unlimited number of SPOP and/or LPOP files only on a single computer. a registered user may use the program on a different computer, but may not use the program on more than one computer at the same time. No user may modify POPEDIT in any way, including but not limited to decompiling, disassembling or otherwise reverse engineering the program. All users are granted a limited license to copy POPEDIT only for the trial use of others subject to the above limitations, and also the following: POPEDIT must be copied in unmodified form, complete with the file containing this license information. Any and all POPEDIT documentation must be included with the copy. No fee, charge or other compensation may be accepted or requested by any licensee. POPEDIT may not be distributed in conjunction with any other product. Operators of electronic bulletin board systems (Sysops) may post POPEDIT for downloading by their users only as long as the above conditions are met. Distributors of public domain or user supported software may distribute copies of POPEDIT subject to the above conditions only after obtaining written permission from Crater Rim Software. Such permission usually is granted. Please write or call for details. See the Ordering section for more information on registration, corporate licensing and similar topics. WARRANTY Crater Rim and Procrustion Software make no warranty of any kind, express or implied, including without limitation, any warranties of merchantability and/or fitness for a particular purpose. Crater Rim and Procrustion Software shall not be liable for any damages, whether direct, indirect, special or consequential arising from a failure of this program to operate in the manner desired by the user. Crater Rim and Procrustion Software shall not be liable for any damage to data or property which may be caused directly or indirectly by use of the program. IN NO EVENT WILL Crater Rim or Procrustion Software BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. ORDERING INFORMATION Registration of POPEDIT licenses you to use the product on a regular basis. Registration includes mailed notification of updates and priority support on Underdog's MiniNet BBS. Users need register only one version of POPEDIT. Registration includes licensed use of all upgrades. Individual registrations for POPEDIT come in two forms. The first, registration only, costs $25 and assumes you have already received a copy of the program from whatever source. We do not provide diskettes or manuals. The registration fee covers the use of the program. For $35 dollars we offer a combination registration/diskette package. The diskette includes the latest version of the program, assorted ready made PopUp Screens and the PopEdit documentation. In addition, evaluation disks are available at any time for $10. These disks do not include registration. The fee covers diskette, postage and handling. You can also send us a formatted disk, along with a postage-paid, self-addressed return mailer to receive a copy. Please use the enclosed order form when placing an order. ORDERS OUTSIDE THE US: Please send checks drawn on US banks in US dollars. We cannot accept non-US currency. Corporate and Quantity Purchases All corporate, business, government or other commercial users of POPEDIT must be registered. We offer quantity discounts starting at the eleventh copy. Corporate or site licensing is also available. For single unit orders, use the enclosed order form. We accept purchase orders in amounts over $100 only. All other orders should be prepaid. Orders in quantities of less than 75 units are handled as bulk purchases. We can provide you with the registration/disk combo. Purchases of over 75 units may be handled as quantity purchases or as corporate licensing agreements. Licensing agreements allow duplication and distribution of specific numbers of copies within the licensed institution. Duplication of multiple copies is not allowed except through execution of a licensing agreement. Please write or call for details. The quantity purchase discounts are as follows: 0 - 10 copies: no discount 11 - 25 copies: 15% discount 26 - 50 copies: 20% discount 51 - 100 copies: 25% discount 101 - 200 copies: 30% discount 201 - 300 copies: 35% discount 301+ copies: 40% discount ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE. Discounts are not cumulative. They apply to single orders of like products only. Unit prices are the same as for individual users. WARNING: YOU MAY NOT USE POPEDIT WITHIN YOUR ORGANIZATION WITHOUT A PRIOR PURCHASE OR LICENSE ARRANGEMENT. Remit to: Crater Rim Software Order Form 4028 41st Ave South Seattle, Wa 98118 Please send: ____ POPEDIT Disk (current version) ............ @ $ 10.00 ea $ ______ (includes program and manual on disk, no registration) ____ POPEDIT Registration ...................... @ $ 25.00 ea $ ______ (does not include disk) ____ POPEDIT Registration and Disk Combo ....... @ $ 35.00 ea $ ______ (registration, program, ass'ted PopUps and manual on disk) Subtotal ______ Less Discount <______> (Washington residents please add 7.9% sales tax) Tax ______ Total $ ______ Payment by: ( ) Check ( ) Money Order ( ) PO # ______________ Name: ____________________________________________________________ Company: ____________________________________________________________ Address: ____________________________________________________________ : ____________________________________________________________ : ____________________________________________________________ Day Phone: (______)___________________ Eve: (______)_____________________ ORDERS OUTSIDE THE US: Use check or money order drawn on US bank in US dollars. Sorry, no C.O.D. orders will be accepted.