home *** CD-ROM | disk | FTP | other *** search
- Welcome to QEdit Advanced - version 2.1
-
- This is a licensed, commercial version of QEdit Advanced v2.1. Please
- help us stay in business by respecting our copyright and keeping this
- version private. Also, be sure to return the postage-paid registration
- card that came with your package. That is the only way we have of
- making sure that your name is in our database, without which you will
- not receive update notices (and discounts!) and technical support.
-
- Is this a borrowed copy of this software? If so, then please consider
- ordering your own personal copy, or persuading your company to purchase
- a license for it. QEdit has taken many work years, and hundreds of
- thousands of dollars, to develop and produce. Yet, QEdit is very
- reasonably priced, and we also offer attractive multi-user site
- licenses.
-
- There is also a shareware version of QEdit. This is *NOT* that version.
-
- Please review the contents of this file before using QEdit. It contains
- helpful information on the operation of QEdit and how to get assistance
- when you need it. The Release Notes for version 2.1 (section 3) contain
- an explanation of all features and changes in this release and some
- additional features not documented in the 2.1 addendum.
-
- Late-breaking news:
- ------------------------------------------------------------------------
- QEdit TSR is now available! For those of you who would like to have
- access to your favorite editor at virtually anytime, in the middle of
- anything else, we at SemWare are proud to offer you QEdit TSR v1.1.
- Please call SemWare for details.
-
- ------------------------------------------------------------------------
- QEdit is the winner of the Data Based Advisor Reader's Choice Award for
- best text or program editor of 1989. We thank our users for this vote
- of confidence and their continued support!
-
- ------------------------------------------------------------------------
- QEdit for OS/2 is now available. If you'd like to have THE FASTEST
- editor available for OS/2, give SemWare a call!
-
- ------------------------------------------------------------------------
- There is now a special German version of QEdit available. It is based
- on version 2.1 of QEdit. All text displayed by the program (including
- the status line!) is in German; plus the reference manual was
- painstakingly translated by a native German. For information on
- ordering the German version you can give SemWare a call, or if you
- prefer, you can call our German distributor directly at: 49-761-87419.
- Ask to speak to Manfred Luft.
-
- ------------------------------------------------------------------------
-
- Contents
- --------
-
- I Contents of QEdit Distribution Disk
- II Technical Support
- III Version 2.1 - Release Notes - February, 1990
- IV Various Keyboard Definition Files Supplied
-
-
-
- I Contents of QEdit Distribution Disk
- ---------------------------------------
-
- File Description
- ------------ ----------------------------------------------------
-
- Q.EXE The editor program. This is the only file required
- to run QEdit.
-
- QCONFIG.EXE The configuration program.
- QCONFIG.DAT The default Keyboard Definition File.
- QHELP.TXT The default Help text.
- READ.ME The file you are currently reading.
-
- Keyboard Definition Files for the following editors are provided:
-
- QCONFIG.B Brief 2.1
- QCONFIG.NE Norton Editor 1.3
- QCONFIG.PE2 PE II
- QCONFIG.WP WordPerfect 5
- QCONFIG.WS WordStar 3.3 / SideKick 1.5
-
- Help files for the above:
-
- QHELP.NE
- QHELP.PE2
- QHELP.WP
- QHELP.WS
-
- QUPDATE.EXE Will copy the configuration information from QEdit
- versions 2.07 ,2.07A, or 2.08 to 2.1. Just run
- QUPDATE and follow the prompts. If you are NOT
- upgrading from 2.07, 2.07A or 2.1, you don't need
- this file.
-
- QDISK.EXE Run QDISK to obtain the amount of available memory
- and space on the current drive.
-
- SHOWKEY.EXE Displays the scancode for extended keys.
- CHUNKER.EXE Splits large files into chunks for editing by QEdit.
- Will also merge these chunks back into a single
- file.
-
- ATKYFAST.COM This program will speed up the keyboard response
- time on AT and 386 style computers. It is NOT a
- TSR. Just type ATKYFAST. Note that this program
- will not work on all clones, but it will not cause
- any problems on them either.
-
- QMAC.EXE Macro translator for QEdit.
- QMAC.DOC Macro translator documentation.
-
- The following files are courtesy of Karl Brendel, author of QFonEdit
- and ProFonEdit.
-
- MACROS.MIS Sample macros.
- MACROS.PAS Sample macros for Pascal programming.
-
- The following files are courtesy of Jerry Houston.
-
- QM.COM Mouse driver for QEdit.
- QM.DOC Mouse driver documentation.
-
-
- Notes
- -----
-
- Other product names are trademarks or registered trademarks of their
- respective holders.
-
- The ONLY file required to run QEdit is Q.EXE - the others are not
- required or used by the program.
-
- QEdit comes pre-configured to work on a large range of monitors.
- Because of this, the default colors are set up for a monochrome
- system. If you have a color system and would like to edit in color,
- then run the configuration program (QCONFIG), select the
- C)olors/screen options, and change the default colors.
-
- NOTE: We do NOT release patch files for QEdit, under any
- circumstances. We release only fully-executable files. If
- you encounter a "patch" or "modification" file that modifies
- your Q.EXE file, be aware that it does not originate from us,
- and we cannot be responsible for the behavior of a patched
- QEdit. The only program you should use to modify your copy
- of Q.EXE, is the QCONFIG program that came with it. Keep this
- in mind when calling for technical support.
-
- Please, make sure you read this entire file to take full advantage
- of the new commands/features in QEdit.
-
-
- II Technical Support
- ---------------------
-
- Due to the tremendous popularity of QEdit, we can give technical support
- ONLY to registered QEdit users. Please have your QEdit SERIAL NUMBER
- handy when you call.
-
- Please! Before you call us with a problem, make sure you have read
- this entire READ.ME file to determine if it solves your problem. If
- you should have to contact us, please provide or have available the
- following information:
-
- QEdit version number, date of Q.EXE on the original diskette,
- and serial number
- DOS version
- Computer model
- Amount of RAM
- Whether you are using a hard disk or floppy disk based PC
- The names of any memory-resident programs you have loaded
-
-
- You may obtain technical support directly from SemWare as follows:
-
- 1. Call our remote electronic bulletin board service. The
- board is operational 24 hours a day, 7 days a week. Modem
- settings are <N81>, 9600 HST, 2400 or 1200 baud. The
- telephone number is: (404) 641-8968.
-
- 2. Write us at: (We've moved!)
-
- SemWare
- Technical Support
- 4343 Shallowford Rd., Suite C-3
- Marietta, GA 30062-5003
-
- 3. Send Compuserve E-Mail to userid 71520,67
-
- 4. Call us directly at SemWare, (404) 641-9002. Support hours
- are 9 am to 5 pm (ET), Monday through Friday.
-
- 5. Send us a Fax at: (404) 640-6213
-
- SemWare is committed to supporting registered users. However, we
- request that you reserve telephone support only for questions or
- problems requiring immediate attention.
-
- As always, if you have a suggestion that you think would improve our
- product, don't hesitate to let us know.
-
- By the way, SemWare has grown! We now have eight full-time people
- on staff to help serve you better, and we have also moved to larger
- facilities.
-
- III Version 2.1 - Release Notes - February, 1990
- ------------------------------------------------
-
- 2.1 summary of changes:
- -----------------------
-
- QCONFIG:
- --------
-
- Deletions:
-
- "number of rows on physical screen option" has been removed. QEdit
- now retrieves this information from the bios data area, so this option
- is no longer needed.
-
- "go to line number on command line option" has been removed. This has
- been replaced with a command line option.
-
- Additions:
-
- Under Advanced options:
-
- "Swap to Expanded memory or DISK on Dos and Shell commands?"
- "Drive to use for disk swapping [A..Z] *=default-drive ?"
- "Should the editor restore the starting drive/dir on program exit?"
- "Should the editor change the DOS PROMPT during a shell?"
- "Should [TabRt]/[TabLt] be allowed to shift an entire block?"
-
- Under general options:
-
- "Do you want the bell to sound on warning messages and missed
- searches?"
-
- Under printer options:
-
- "Default top margin for printing [0..100]?"
- "Default bottom margin for printing [0..100]?"
-
- QEdit CHANGES:
- --------------
-
- New command line option:
-
- -n command line option. For example:
- q filename -n36
- goes to line 36 in filename after initial load.
-
- Operational changes:
-
- The [Dos] and [Shell] commands can now optionally swap QEdit out to
- disk or EMS leaving only a 2k kernel in memory, thus allowing much
- more memory for running memory-hungry programs from QEdit, especially
- compilers. This option is configurable via QCONFIG as well as
- interactively using the [ToggleSwap] command, found on the "Other"
- pulldown menu.
-
- Once in the shell, QEdit will optionally append "[QE]" to the DOS
- prompt string, provided that:
-
- 1) You have defined the prompt environment variable.
- 2) There is enough space left in the environment.
- 3) You have set the "Change DOS PROMPT during a Shell" option to
- [Y]es. See QCONFIG, under Advanced options.
-
- If you have NOT defined the prompt environment variable, then we
- suggest you do so. It is helpful with DOS command line operations in
- general. A suggested prompt is (this should go in your AUTOEXEC.BAT
- file):
-
- set prompt=$p $t $g
-
- If you do have a prompt string defined, but you do not get the "[QE]"
- prompt in the QEdit shell, add the following to your AUTOEXEC.BAT:
-
- set x=x
-
- ----------------------------------------------------------------------
-
- Column blocks can now be deleted [DeleteBlock] <Alt G>, printed
- [PrintBlock] <Esc><PB>, and written [WriteBlock] <Alt W> to disk.
-
- [TabRt]/[TabLt] when pressed while the cursor is inside a marked
- block and insert mode is on, shifts the entire block by the current
- cursor tab width.
-
- The window resize command allows up and down movement, instead of only
- up or only down.
-
- .cpp, .hpp, .cxx, .hxx have been added to the list of valid C Mode
- file extensions.
-
- Prompt boxes show prompt strings in the block attribute while they
- will be overwritten when a character is typed; once a character or
- editing key has been typed, prompt strings revert back to their
- default color.
-
- [CurrentFilename] is now available outside of prompt boxes. In
- previous versions, the [CurrentFilename] command was active only
- during a QEdit prompt box. This command now functions while editing,
- too.
-
- Find/Replace command changes:
-
- "L" option added to [Find], [FindReplace]. Limits the
- Find/FindReplace to the currently marked block. If the cursor is
- outside the marked block, or the "G" option is also selected, the
- search starts at the beginning of the block. Otherwise, the search
- starts at the current cursor position inside the block.
-
- "G" option in [Find], [FindReplace] now works as it does in WordStar
- and the Borland editors; i.e., it starts the search at the beginning
- of the file.
-
- In [FindReplace] you can now enter a number to limit the number of
- replaces.
-
- The find string is now highlighted after a successful find.
-
- You can press <^Break> to halt a repeated command and/or macro, and to
- halt a long [FindReplace].
-
- New commands:
- -------------
-
- Summary list:
-
- CenterLine <^OT>
- FillBlock <^KL>
- JFalse
- JTrue
- Jump
- RepeatCmd <^QQ>
- SetPrintBotMargin <ESC><P><O>
- SetPrintTopMargin <ESC><P><T>
- ToggleSwap <ESC><O><S>
-
- Detailed list:
-
- [CenterLine] <^OT>
-
- If the cursor is inside a column block, the lines encompassed by the
- block are centered using the left and right columns of the block as
- the margins.
-
- If the cursor is inside a line block, the lines encompassed by the
- block are centered using column 1 and the right margin as the margins.
-
- Otherwise, the line the cursor is on is centered, using column 1 and
- the right margin as the margins.
-
- [FillBlock] <^KL>
-
- The user is prompted for a character with which to fill the block.
- With this command, you can now use the following macro to move a
- block, and blank fill the space used by the block, instead of the
- text closing in around the block. The macro assumes a block is
- already marked. The block will be [Cut] to the clipboard or system
- scrap buffer. You can then insert the block where you like by
- pressing the [Paste] key <Grey *>:
-
- f10 MacroBegin GotoBlockBeg Cut Paste FillBlock ' ' Return UnmarkBlock
-
- Choose a key (<f10> in the above example), and assign this macro to it
- in the QCONFIG.DAT file. Run QCONFIG, configure the keyboard, and you
- now have a "copy with wipe" command!
-
- [JTrue], [JFalse] and [Jump] commands.
-
- These commands are intended for macro use. All QEdit commands set an
- internal QEdit result code of "True" if they executed successfully, or
- "False" if they did not. The [JTrue] and [JFalse] commands can be
- used to take advantage of that fact. [Jump] is just an unconditional
- jump. You can also define labels for branching, in the format
- "label:". The maximum label length is 15 characters. For Example:
-
- A command to delete from the cursor position to the beginning of the
- line, assigned to the f10 key:
-
- f10 MacroBegin
- begin:
- CursorLeft
- JFalse done:
- DelCh
- Jump begin:
- done:
-
- This MUST all occur on ONE LINE in your QCONFIG.DAT file.
-
- [RepeatCmd] <^QQ>
-
- Repeats the last executed command and/or macro "n" times. You are
- prompted for "n". You can stop the repeating at any time by pressing
- the <^Break> key. If the result code from the command is FALSE, or if
- a result code from any of the commands in the macro is FALSE,
- repetition halts.
-
- [SetPrintTopMargin] <ESC><P><T>
- [SetPrintBotMargin] <ESC><P><O>
-
- Set the top and bottom margins used when printing. If QEdit's print
- page size is set to 0, these commands have no effect.
-
- [ToggleSwap] <ESC><O><S>
-
- Toggles Expanded memory/Disk swapping for the [Dos] and [Shell]
- commands. This option can also be set via QCONFIG.
-
- IV Various Keyboard Definition Files Supplied
- ----------------------------------------------
-
- DESCRIPTION
- -----------
- QEdit has an extraordinary capacity for customization. Almost every key
- on the keyboard can be assigned to any command, to achieve any sort of
- configuration the user might desire.
-
- In particular, users switching from another editor to QEdit can install
- QEdit to "emulate" the other editor. This decreases the amount of time
- spent learning QEdit.
-
- However, setting up the configuration file to emulate another editor can
- take a fair amount of time. We have provided a collection of
- ready-to-use keyboard definition files, to simplify the task of making
- QEdit work like a variety of other editors and word processors.
-
- Both a keyboard definition file (QCONFIG.*) and a help file (QHELP.*)
- are supplied for most of the emulations, allowing you to configure both
- your keyboard definition and help screen.
-
-
- CONTENTS
- --------
- The following keyboard emulations are provided:
-
- Brief
- QCONFIG.B
-
- Norton Editor 1.3c
- QCONFIG.NE
- QHELP.NE
-
- Personal Editor II (IBM)
- QCONFIG.PE2
- QHELP.PE2
-
- WordPerfect 4.2/5.0
- QCONFIG.WP
- QHELP.WP
-
- WordStar 3.3 (& SideKick/Borland Environments)
- QCONFIG.WS
- QHELP.WS
-
-
- INSTRUCTIONS
- ------------
- It is strongly recommended that, after choosing your emulation, you
- print out all the files associated with it. There are two reasons for
- doing this.
-
- First, by reading the keyboard definition file, you can see where each
- and every key on the keyboard is assigned, as well as the various notes
- and comments included inside.
-
- Second, several of the keyboard definition files include instructions on
- how to answer the other questions and prompts within the configuration
- program to best emulate that editor. You will need a print-out of this
- information to refer to while running the QEdit configuration program
- (QCONFIG.EXE)
-
- Looking at the various help files may also give you some ideas for
- formatting a good help screen, if you decide to customize your own.
-
- Follow these steps to install the desired keyboard definition:
-
- 1. Put your chosen keyboard definition and help files (e.g.,
- QCONFIG.WS and QHELP.WS) in the same directory with Q.EXE and
- QCONFIG.EXE.
-
- 2. Run QCONFIG, by simply entering the following from your QEdit
- directory: QCONFIG<Enter><Enter>
-
- 3. Select "K" from the configuration program menu to install
- K)eys. When prompted, enter the name of the desired keyboard
- definition file (e.g., QCONFIG.WS).
-
- 4. Select "H" from the configuration program menu to install
- H)elp. When prompted, enter the name of the appropriate help
- file (e.g., QHELP.WS).
-
- 5. If your keyboard definition file has comments indicating
- appropriate settings for other QCONFIG options, select those
- menu options and set them as required, or to your preference.
-
- 6. Press "S" to S)ave your modified Q.EXE to disk.
-
-
- And that's it! You should now be ready to go, with a version of QEdit
- that will act "just like" your former editor.
-
- ACKNOWLEDGEMENTS
- ----------------
- Several of these files were originally submitted by QEdit users on
- SemWare's BBS. Thanks to Randy Wallin, Steve Lynch, Tim Farley, and many
- others for their input.
-