Welcome to Qedit,
the fast, full-screen text editor for MPE and HP-UX. To get into Qedit/UX,
enter this command:
Qedit version 5.8
has screen-editing, function keys and commands:
Commands:
|
Add
|
FINDUp
|
Open
|
ZZ
|
|
Add(=copy)
|
FORM
|
Proc
|
%ext
|
|
Add(<move)
|
FORward
|
Q
|
shell
|
|
Add(=file)
|
GARbage
|
REDO
|
|
|
Append
|
Glue
|
RENum
|
|
|
Backward
|
Help
|
Replace
|
|
|
Before
|
HOld
|
Set
|
|
|
Change
|
Justify
|
SHut
|
|
|
COLcopy
|
Keep
|
SPell
|
|
|
COLMove
|
List
|
Text
|
|
|
Delete
|
LISTREDO
|
UNDo
|
COmp
|
|
DEStroy
|
LISTUndo
|
Use
|
RUN
|
|
Divide
|
LSort
|
Verify
|
mpe
|
|
DO
|
MErge
|
VIsual
|
Udc
|
|
Exit
|
Modify
|
Words
|
Cmdfile
|
|
Find
|
New
|
Zave
|
=calc
|
Function Keys:
|
F1 Upd Next/Visual
|
F2 Roll Up
|
F3 Findup
|
F4 Find
|
|
F5 Backward
|
F6 Forward
|
F7 Do ===>
/LISTREDO
|
F8 Exit
|
Qedit comes with a User Manual and
a Change Notice. You may have received printed copies of these. If you wish to
have printed copies, you can order them by filling out the form on our web
site.
See:
http://www.robelle.com/library/manuals/
The user manual contains the full
description of all the Qedit commands, as well as usage tips. The manual is
up-to-date with all the latest changes incorporated in Qedit. To see only the
changes in the latest version, see "New to Qedit 5."
on page 4 or see the change notice.
For a complete
description of the latest changes made to Qedit, the installation instructions,
and any compatibility issues, see the change notice that was included with the
release or you can view online at:
http://www.robelle.com/library/manuals/
The latest user manual and change
notice are available in Adobe PDF format. If you do not already have the Adobe
Acrobat reader, you can get a copy from http://www.adobe.com/prodindex/acrobat/readstep.html. If you wish to have printed
copies, you can order them by filling out the form on our web site.
When you purchase
Qedit, customer support is included for the first year. After the first year,
there is a yearly Maintenance fee. If you are a Right-to-Copy user at a branch
of a larger company, you have two options. If you pay only the one-time Extra
CPU surcharge, then you must obtain your support from your own corporate
resources. If you wish to have support at your own location, you may obtain
this by also paying the regular Maintenance fee. With this yearly support for
Qedit, you are entitled to call with questions. Service also supplies you with
a yearly update to Qedit.
Do you receive a
copy of What's Up, DOCumentation?,
our regular news memo about Robelle, MPE, and HP-UX? We distribute our news
memos only to sites with current service. Your copy may be going to your
corporate headquarters.
The lastest
newsletter is also available from our Web site at http://www.robelle.com/newsletter/.
Qedit comes with
additional software:
·
qcat for converting Qedit files,
·
qaccess archive library for reading Qedit files, and
·
Compare/UX for comparing two text files.
Qcat is a filter program similar to cat and
zcat. Qcat reads a set of Qedit
files and prints the lines on standard output. Type man
qcat for more information.
qcat
QeditFile > TextFile
Qaccess is an archive library for reading
Qedit files. It has two parts:
·
a header file qaccess.h in /opt/robelle/include,
·
and an archive library qaccess.a in
/opt/robelle/lib.
Type man qaccess for more
information.
Compare/UX compares two text files (Keep or
Qedit format) and prints out the differences. The basic comparison unit is a
line. Compare/UX identifies three types of differences:
·
lines that are in the first file but not in the
second;
·
lines that are in the second file but not in the
first;
·
and lines that are in both files, but don't
match.
Type man compare for more
information.
This manual uses a standard notation to
describe commands. Here is a sample definition:
VERIFY [ @ | ALL ]
[ keyword ...]
1.
UPPERCASE - If the commands and keywords are shown in
uppercase characters in a syntax statement, they must be entered in the order shown (example: ALL). However,
you can enter the characters in either uppercase or lowercase.
2.
Lowercase,
highlighted - These are "variables" to be filled in by the user
(example: keyword). The variables may
be highlighted by underlining or italics. Each such "variable" is
defined elsewhere (see the "Qedit
Glossary" on page 241 when you have trouble). In the Help
command, highlighting is not available, so these variables appear simply in
lowercase.
3.
Brackets - enclose optional fields (example: [ALL]).
4.
Braces - enclose comments which are not part of the
command. However, braces and comments are accepted in actual Qedit commands.
/listq filename {Q means without line numbers}
5.
Up lines - separate alternatives from which you select
(example: SET CHECK [ON|OFF]). The choices are sometimes listed on several
lines without "up lines".
6.
Dot-dot-dot (...) - indicates that the variable may be
repeated many times in the command.
7.
Other special characters - literal symbols that must
appear in the command as they appear in the manual (for example, "="
in Add linenum = rangelist).
In examples, there
is an implied Return key at the end of each line.
In examples in our
documentation, we generally show Qedit commands preceded by the Qedit
"/" prompt. However, in Qedit/UX the default prompt is actually
"qux/". Note that you can change the prompt string with Set Prompt.
Control characters, generated by holding down
Control while striking another key, are either spelled out (e.g., Control-H) or
abbreviated with a circumflex prefix (e.g., ^H).
When Qedit asks you a question, the default
answer is shown in [brackets]. The default is the answer that Qedit will assume
if you press only the Return key.
Here are a few highlights of the new features
in Qedit. For a complete list of changes, plus details on how to take advantage
of all the new features, see the change notice that accompanied your tape. See
the "Documentation" section on page 2 for
instructions on how to print the change notice. All changes discussed in the
change notice have been incorporated into the user manual and help file, but
the change notice gives you everything new in one convenient document.
This section
describes the latest enhancements to host-based Qedit and the server portion of
Qedit for Windows. For information about enhancements to the client portion of
Qedit for Windows, see the Qedit for
Windows User Manual.
·
Visual Mode updates would fail with Bad format
error if the length of the file was less than 52.
·
Qedit did not recognize .cpy files as being
Cobol.
·
Regular
Expressions. Qedit would improperly report the error "String longer than maximum
allowed" if the expression specified is longer than the window of the
rangelist.
·
Shadow
Passwords. Qedit for HP-UX did not support Shadow Passwords properly for all
versions of HP-UX.
Qedit aims to
provide everything an MPE or HP-UX programmer could need to write COBOL,
PowerHouse, or other programs, and to prepare documentation. Therefore, Qedit
has Line mode for batch editing and full-screen mode for interactive editing.
On HP terminals, Qedit's full-screen mode is called Visual mode. On VT
terminals, Qedit’s full-screen mode is called Screen mode. See “Getting a Quick Start with VT Full-Screen Editing” on page 27.
|
This feature does
not work on the hpterm terminal emulator at the moment.
|
As
of HP-UX 11.0, HP has dropped support for block-mode terminals. For this
reason, full-screen editing as implemented on HP3000 computers only works on
HP-UX versions earlier than 11.0. On HP-UX 11.0 or later, full-screen
editing
is available in Screen
mode
(Set Visual Screen On) on VT-type terminals or in Visual Blockemulation
emulation (Set
Visual Blockemulation On) on HP-type terminals.
|
As its name
implies, Blockemulation emulates block-mode operations by reading each line one
by one instead of reading the whole screen in a single operation. Depending on
the type of connection, this process might take a few seconds as the cursor
moves down the screen.
Qedit's Visual
mode is a powerful but friendly full-screen editor designed specifically for
programmers. It gives you full access to the editing capabilities of your
terminal in block-mode, with low system overhead. You can move, copy, mark and
delete blocks of text with Visual's cut-and-paste functions, and page backward
and forward through your file with function keys. To use Visual mode, you must
have an HP terminal or an HP terminal emulator (e.g., Reflection from WRQ).
In Visual mode,
you have access to all Line mode commands (including UDCs, command files,
compiling, linking and running programs, shell scripts, and string searching
and changing). Qedit's search and replace functions aim to be simple, fast and
powerful (e.g., ignore embedded words, etc.). The Undo command allows you to
cancel any previous edits to your file, working back to the state at which you
started. Using the optional Open and Shut feature, you can switch between files
instantly.
Visual mode is a
good introduction to the HP operating systems for users who don't work on HP
computers all day. Those who may particularly benefit are novice users, or
users who run Qedit only to update a report skeleton once a week. These
occasional users no longer have to memorize editing commands. Visual mode
provides a familiar environment where novices can make changes to the entire
screen, just as they do on PC editors. You can even configure some electronic
mail packages (HPDesk, elm), to put your users directly into Visual mode when
they edit a message.
After you have invoked Qedit, and Texted or
Opened a file, you switch from Line mode to Visual mode by typing VI or
pressing F1. If you don't have a file open, Qedit opens a scratch file and, if
empty, fills it with a screenful of blank lines.
VI [ linenum | "string" ] or press F1
(Default: linenum
= *)
Whereas in Line mode you type in command and
text lines ending each with a Return, in Visual you edit a full screen of text
in block-mode using the terminal keyboard. Since your terminal is off-line from
the computer, you can use its cursor and editing keys. You edit by moving the
cursor around the screen, inserting and deleting lines and characters. Press
Enter to save your changes. To move through the file, you have the convenience
of eight function keys, such as F6 Forward
One Page.
Visual mode in
Reflection for Windows, showing cut-and-paste indicators
You copy, move,
hold, and delete blocks of text easily by placing "cut-and-paste"
indicators at the start of the line. You may type Line mode commands at the
home line ===>
and execute them via the Enter or the F7 key. Combining the
cut-and-paste functions with the Open and Shut commands, you can also copy and
move text quickly between different Qedit files. Use the ZZ cut-and-paste
indicator with any command to mark text easily.
The Set Visual
command controls how Visual mode operates and allows great latitude in
configuring Visual to your own liking. For example, you can choose to have
automatic update; decide where the current line or cursor appears; and select
how many lines will carry over when you page up or down.
When you are done,
exit Visual mode using F8, then Keep or Shut your file. Press F8 again to leave
Qedit.
===>
Okay 1691.75
WFILE.DOC.TACCT
"verify"(u) Move Ready
*
procedure abc;
+1 begin
+2 integer def;
// ....+....10...+....20...+...
The screen starts with the home Line, followed by the status Line, several text Lines, and ends with the template Line. Columns 3 and 4 of text
lines sometimes contain special characters and are called the indicator columns.
You type commands, search for strings and for
line numbers after the ===>
on the home line.
These are executed
when the F7 or Enter key is pressed.
The home line is
also used by Qedit to print error messages. You must clear the error message by
pressing the F7 or Enter key before you can type another command in the home
line.
The second line shows the status, the current
line number (i.e., that of the * line), the name of the file you are editing,
the current string with its window, and any pending cut-and-paste task.
Okay 1691.75
WFILE.DOC.TACCT
"verify"(u) Move Ready
If you have Texted
a file into Qeditscr, the status line shows the name of the Text file, which is
also your default Keep file.
By default you see the * (current) line and
19 lines after it. Each line is prefixed by the relative line number, and two
columns for special indicators.
*
procedure abc;
+1 begin
+2 integer def;
Use Set Vis Above
and Set Vis Below to adjust the number of lines shown above and below the
current line.
The last line has // and a column template.
The // signals end-of-screen to Qedit and must not be erased.
// ....+....10...+....20...+...
Visual uses more than 76 columns for text on
Reflection, Qcterm, a 2393/97, 2626, or 700/9x terminals.
Qedit leaves
columns 3 and 4 of the text lines for you to enter cut-and-paste operators
(i.e., MM, CC, HH, etc.). Also, Qedit may print one of two special indicators
in these columns:
|
!
|
line extends
beyond the visible right margin
|
|
?
|
line contains
control characters, shown as dots
|
An ! means the line extends beyond the right
terminal margin. To shift the screen image left, type Set Left 55 at the Visual
home line and press F7.
A ? means the line contains nonprinting
characters such as Nulls, Escapes, Bells, Tabs or possibly Roman-8 extended
characters. Qedit replaces these characters with dots (.) in Visual mode, and
does not allow you to make changes. These ? lines are not updated when you
press Enter.
To edit Bells, Escape sequences, Tabs,
ShiftOuts and ShiftIns in Visual, use Set Vis Bell, Set Vis Esc, Set Vis Tab,
Set Vis SO and Set Vis SI. All these specify substitute characters to be shown
instead of dots. To edit other control codes, use Modify or Change from the
===> line. If you turn Set Editinput Extend Off, Qedit regards Roman-8
characters as nonprinting noise and show them as dots.
In Visual mode, the keyboard gives you the
power to move around the screen, edit text, and control the flow of Qedit.
You move around the screen using the cursor
keys and others:
|
Cursor Left
|
Move one space to
left
|
|
Backspace
|
Move one space to
left
|
|
Cursor Right
|
Move one space to
right
|
|
Cursor Up
|
Move one space up
|
|
Cursor Down
|
Move one space
down
|
|
Return
|
Down to next line,
back to column 5
|
|
Home Up
|
Move to ===>
line
|
|
Shift-Home
|
Move to bottom of
screen
|
|
Tab
|
Move to next right
Set TAB column
|
|
Shift-Tab
|
Move to next left
Set TAB column
|
|
Prev Page
|
Only moves around
terminal memory
|
|
Next Page
|
Only moves around
terminal memory
|
You revise the screen image using these keys:
|
Space bar
|
Move cursor right
and erase character
|
|
any char
|
Overwrite cursor
and move it right
|
|
Del Char
|
Remove character
at current cursor
|
|
Ins Char
|
Enable
"insert"; use again to disable
|
|
Ins Line
|
Insert blank line
above current line
|
|
Del Line
|
Delete line at
current cursor
|
|
Clear Line
|
Erase to the end
of the line
|
|
Clear Display
|
Avoid! Recovery: Home Up,*,F7
|
To save the changes you have made on the screen,
|
Enter
|
Send screen image
to Qedit, update file
|
To return from
Visual mode to Line mode:
Some other keys:
|
Select
|
Useless in Qedit
|
|
Stop
|
Do not use in
Visual
|
|
Break
|
Disabled in Visual
|
|
Reset
|
Use if screen
locks up, press Enter
|
|
Esc
|
First key of
Escape sequences
|
|
Del
|
Does not delete
anything!
|
If you are using a PC with Reflection for
DOS, you need to map the PC keys into the HP keys.
Note that the PC
keyboard has two keys labeled Enter, which are used differently in Qedit. The
Enter key above the Right Shift key is called the Return key in this manual,
and is used to execute commands in Line mode. In Visual mode, this key moves
the cursor down by one line. The other Enter key (on the numeric keypad) is
called the Enter key, and is used to update the screen in Visual mode.
Here are the
default Reflection keystrokes for common functions:
|
Terminal
Keyboard
|
Reflection Key
Sequence
|
|
Enter
|
Enter on the
numeric keypad. If that doesn't work, try the "+" on the numeric
keypad, or try Shift-F10
|
|
Home Up
|
Control-Home
|
|
Shift-Home
|
Control-End
|
|
Ins Line
|
Alt-I
|
|
Del Line
|
Alt-D
|
|
Clear Line
|
Alt-K
|
|
Clear Display
|
Alt-J (avoid in
Visual!)
|
|
User keys
|
F9
|
|
System keys
|
F10 (then F7 for
help)
|
|
Additional
Functions
|
Reflection Key
Sequence
|
|
Begin Line (Column
1)
|
Home
|
|
End Line
|
End
|
|
Help about
Reflection
|
Alt-H
|
|
Exit
|
Alt-X
|
AdvanceLink is similar (Alt-H is help, Alt-I
is Insert Line, Alt-D is Delete Line), but Clear Line is Alt-L, and Enter is
Alt-F3. Other terminal emulators have their own keystrokes for common
functions. See your emulator's manual for details.
Much of the
convenience of Visual mode is due to the power built into the eight user
function keys: F1 through F8.
|
F1
|
Update and go to
next page
|
|
F2
|
Roll Up Screen n lines, as per Set Vis Roll
|
|
F3
|
Findup (search
back for current string)
|
|
F4
|
Find (search ahead
for current string)
|
|
F5
|
Backward One Page
|
|
F6
|
Forward One Page
|
|
F7
|
Execute command
typed in ===> line
|
|
F8
|
Exit from Visual
back to Line mode
|
F1: Update and Go to Next Page
Qedit reads the current page and updates the
file, then displays the next page. The F1
key combines the Enter key and F6 (Forward) in a single key. However, F1
does not execute any command typed in the home line as the Enter key would.
F2: Roll Up Screen
Qedit clears the screen and displays a new
one that is rolled up n lines
(default: 6), where n is controlled
by Set Vis Roll.
F3: Findup - Previous String
Qedit searches backward in the file, starting
from the * line, until it finds a line that contains the current string. Qedit
clears the screen and displays a new page, with * positioned at the line that
contains the found string. Visual also displays the target string on the Status
line.
Before you can use
F3, you must establish the string for which to search. Type the string in
quotes prefixed by a circumflex (^"string")
at the ===>
on the home line and press F7, to do the first Findup.
F4: Find - Next String
Qedit searches forward in the file, starting
from the * line, until it finds a line that contains the current string. Qedit
clears the screen and displays a new page, with * positioned at the line that
contains the found string. Visual also shows the target string on the Status
line.
Before you can use
F4, you must enter the target string. Type the string in quotes ("string") at the ===> on the home line and
press F7, to do the first Find.
F5: Backward One Page
Qedit clears the screen and displays the
previous page. By default, the top line of the original screen becomes the
bottom line of the new screen. Use Set Vis Carry to change the number of lines
carried over to the new screen.
F6: Forward One Page
Qedit clears the screen and displays the next
page. By default, the bottom line of the original screen becomes the top line
of the new screen. Use Set Vis Carry to change the number of lines carried over
to the new screen.
F7: Execute a Command
Use the F7 key to execute commands. The
current screen is not updated, unless you have Set Vis Update On. Type whatever
command you want to execute after the ===>.
This includes "strings" to find, Qedit Line mode commands such as
Open or Justify, shell commands, calculator commands (=5/6), and special Visual
commands (e.g., * for Refresh, ? for Help). Then press F7. Qedit reads only the
home line and executes the function. To first save your screen changes and then
execute, use Enter instead of F7.
See the section
"Home Line Commands" for complete details.
F8: Exit from Visual
To return from Visual mode to Line mode, use
the F8 key. Press F8 again once you are in Line mode to exit Qedit and return
to HP-UX. If for some reason F8 fails to exit from Visual, type / at the ===> and
press F7 or the Enter key. This should get you back to Line mode.
Line
Number. Move to a specific line (e.g., to line 45).
===>45 F7
> and <. Move ahead or back a
page. Use with a number to move several pages (e.g., ahead 3 pages).
===>>3 F7
+ and -. Move forward or backward any
number of lines (e.g., back 200 lines). If you do not specify a number, the
default is the number of lines configured by Set Vis Roll.
===>-200 F7
~ The Tilde Key. Return to the
"most recent" screen. If you jump from line 1500 to line 451, ~ sends
you back to 1500. This is handy if you jump briefly to another part of your
file to check something then want to get back to your original location.
The tilde is also
available from line-mode but it has to be enabled by removing it from the list
of string delimiters. In order to do this, you could do the following:
/V
stringd
Set
STRINGDelimiters "|\~{}[]_@?!#>%&:'"
/S
stringd "|\{}[]_@?!#>%&:'"
Notice that tilde
has been removed from the delimiter list entered on the Set command.
===>~ F7
FIRST and LAST. Move to start or end of
file.
===>first F7
Scrollup
Character. This character can be entered
in the cut-and-paste columns to scroll up in the file. A single character
scrolls the number of lines defined by Set Visual Roll. If the character is
entered more than once, Qedit scrolls up that many times the number of Roll lines. For example, enter 4 minus signs anywhere to scroll
4 X Roll lines. The default scrollup character is a minus sign. It can be
changed to something else with Set Visual Scrollup.
It is never necessary to remember line
numbers in full-screen mode. Visual allows you to mark, hold, move, copy,
replicate, or delete a block of text, all visually. This is called
"cut-and-paste" and is done by putting special indicators in the two
blank columns at the left of each text line before you press the Enter key. For
example, DD indicates a block of text to be deleted.
Order Is Not Important (But One at a Time).
You can enter the indicators in any order and on different screens, but
10,000 is the maximum number of lines you can cut. When you have defined a
complete cut-and-paste task, Qedit completes the task and removes the
indicators. You can only perform one cut-and-paste task at a time.
|
Single Line
|
Block of Text
|
Function
|
|
M
|
MM
|
Move line or block
of text
|
|
C
|
CC
|
Copy line or block
of text
|
|
D
|
DD
|
Delete line or
block of text
|
|
H
|
HH
|
Hold a line or
block of text
|
|
|
HJ
|
Append block of
text to Hold file
|
|
|
JJ
|
Justify a block of
text
|
|
Z
|
ZZ
|
Mark a line or
block of text
|
|
A
|
Insert text
"after" this line (or use F for "following")
|
|
B
|
Insert text
"before" this line (or P for "preceding")
|
|
AH
|
Insert Hold file
after this line (or use FH)
|
|
BH
|
Insert Hold file
before this line (or use PH)
|
|
A0
|
Insert Hold0 file
after this line (or F0)
|
|
B0
|
Insert Hold0 file
before this line (or P0)
|
|
R
|
A line to be
replicated after itself
|
|
Rn
|
A line or block to
be replicated n times (max. 9).
(See "Copying a Block of Text" below.)
|
Display Enhanced. When
the cut-and-paste task is partly defined, Qedit highlights the indicated lines
and adds a warning to the status line.
You can cancel a pending cut-and-paste task
(if you have not pressed the final Enter) by entering a period (.) in the ===> line
and pressing F7.
===>. F7
Paste
One Copy at a Time. Suppose you want to copy a section of text from one
place in your file to another. Here is one way to do it. First, locate the
screen containing the start of the block that you want to copy, using a string
search via the home line. Move the cursor down to the first line you want to
copy, then press Cursor Left twice and type "CC" in the blank columns
provided. Press Enter and you should see that line highlighted in inverse
video.
Second, find the
end of the text section and mark the last line with another "CC".
After you press Enter, you should see the entire block highlighted.
Third, go to the screen
where you want to insert a copy of the text. Move the cursor down to the line before the desired insertion point,
Cursor Left once and type "A" (for after). Press Enter and the block
should appear.
Paste Multiple Copies at
Once.
When working with a block of text, you can
use the same cut-and-paste codes to mark the beginning and the end of the block
(i.e., HH on the first line of the block and HH again on the last line). The
only exception to this is the block replication code.
In this case, you
would use RR to mark the beginning of the block and Rn to mark the end of the block, where n represents the number of times you want that block replicated.
For example, to have the same block replicated five times, you would enter R5.
The new blocks are inserted immediately after the last line of the copied
block.
The original lines
marked for replication are written to the Hold0 file.
Using Visual mode's cut-and-paste functions,
you can copy and move blocks of text between
files.
You can only edit
one file at a time in Qedit, but you can switch quickly between different Qedit
files by Opening and Shutting them.
/o
file1
Open
file1 List * = 20
/o
file2 {implicitly shuts file1}
Shut
file1
Open
file2 List * = 48
/o
* {open the last file
that was shut}
Shut
file2
Open
file1 List * = 20
/o
* {open the second file
again}
Shut
file1
Open
file2 List * = 48
Note: The * shortcut
refers to the last Qedit file that was shut.
Now, to copy a
block of text from file1 to file2, use HH twice (just as you would
use CC) to hold the block in file1.
Then, open file2, and use AH or BH to
paste in the text from the Hold file. To move a block from file1 to file2, use the
DD function to delete the block of text from the first file. The deleted block
is stored in a temporary Hold file called Hold0 (Hold-zero). Now immediately
open file2 and use A0 or B0 to paste
in the text from Hold0.
Single line
|
V
|
a single line to
be diVided
|
|
G
|
a single line to
be glued
|
|
GJ
|
a single line to
be glued with a space inserted
|
Block of text
|
VV
|
begin or end of
the block to be diVided
|
|
GG
|
begin or end of
the block to be glued
|
To divide a line, use the V (diVide)
cut-and-paste function in column 3 or 4, then insert the special field
separator ("~") at each division point in the line. The default field
separator is tilde ("~" ), but you can override this with Set Vis
Field. If no "~" is found in the line, a blank line is added after
the line.
What about
dividing all the lines in a range? Use VV to mark the start and the end of the
line range, then place the field separators in the first line of the range.
Every line of the range is divided at the specified field columns. If no
"~" is found, a blank line is added after each line.
When marking
several division points, insert them into the first line of the block from right to left. As you insert them, they
shift the following text to the right one space each. Otherwise, if you insert
them from left to right, it is difficult to select the proper division point
for subsequent fields.
To Glue the next line to the current line,
use a G in column 3 or 4. To Glue two lines with a space inserted at the joint,
use GJ in columns 3 and 4.
To glue
"pairs" of lines within a block, use GG to mark the start and end of
the block.
By default, G and GG append text after the
last nonblank character in a line, but it is also possible to glue text to
specific columnar fields. You do this by inserting a field separator at the
start of each field (mark the first line only). The default field separator is
the tilde ("~"), but you may override this with Set Vis Field. If you
specify three fields, G glues the next three lines to the first line. GG glues
the next three lines to the first line, and then go on to the next group of four
lines. If the precise column number where each field starts is important to
you, insert the field separators from right to left, since each one that is
inserted shifts the column numbers that follow off by one more.
The XX indicators are used to mark
lines that you do not want displayed in full-screen mode. Once marked, the
block of text is replaced with a single line.
--- Excluded Area --- 10/34.5
This line shows the line numbers which are currently
excluded. An excluded area setting is saved in the workfile so it's preserved
across Open/Shut commands. To reset the excluded area and see the original
lines again, type .xx on the Homeline and press
Enter or F7.
The excluded area can also be defined using Set
Visual XX. The current excluded area is displayed on the Verify
Visual output.
Restrictions
The Excluded Area line must not be
removed, altered or used in any way. This also means that you can not enter any
indicators in the cut-and-paste area. If you wish to paste lines before or
after the excluded area, you should use the appropriate cut-and-paste
indicators on the line that immediate precedes or follows the Excluded Area line.
An excluded area can not be included in any other block
operation such as ZZ, CC, MM or other XX.
If any of these rules are broken, Qedit displays an
appropriate error message.
Justification in text alignment is available
in full-screen mode. To justify a block of text, simply mark the first and last
lines in the block with the JJ indicator. If Qedit uses any justify default
settings, they are defined by the Set Justify command. If there are no default
settings, Qedit assumes the text should be justified within the current display
width.
The justified
lines are written to the Hold0 file. A single J indicator is not valid.
When the insertion
point is on the current screen, Qedit renumbers the screen if needed (and if
Set Vis Renum is ON).
When entering a
lot of new text, it is tiresome to keep pressing Ins Line for each new line. To
insert a block of 10 blank lines quickly, press Ins Line to create one blank
line, Cursor Left twice, type R9, and press Enter. This reproduces nine copies
of the blank line immediately after it (as well as updating the paragraph you
just finished typing). Repeat as needed.
Visual has both an
implicit and an explicit Hold file.
The
Implicit Hold0 File. Any block processed by the CC, MM, JJ, RR, or DD
indicators is also written to a disc file called Hold0 (Hold-zero). This allows
you to copy the lines back into your workfile using A0 or B0 (add from Hold0, After or Before the line on which you place the indicator).
The
Explicit Hold File. The HH indicator writes a block to the Hold file
without moving or modifying it. Use H for a single line. To copy the line(s)
back into your workfile, use AH or BH. You may need a Hold file when creating a
file that you want to compile, or when using the Use command. You must use HH
(instead of CC) for copying text from one file to another.
When HH is used to mark the beginning and end
of a block, it copies the block of text to the explicit Hold file. With the HH
indicator, the current contents of the Hold file are erased and replaced with
the marked lines.
If you want to
append a block of text to the Hold file, you can use the HJ indicator. HH or HJ
can be used to mark the first line. However, HJ must be used to mark the last
line. You cannot hold-append a single line of text, which means you can append
only two or more lines. With the HJ indicator, the current contents of the Hold
file are preserved and the block of text is appended to it.
The ZZ indicators mark a group of lines that
you want Qedit to remember. Use Z to mark a single line. Note: "Z"
for a single line is valid only in Visual mode; in Line mode, use
"ZZ" to mark a single line. See the ZZ command in the "Qedit
Commands" chapter for further information. Once marked, the lines are
displayed at half-bright intensity and you can refer to them in any home line
command by using ZZ where the line numbers are expected. This is especially
useful when listing lines to the printer, changing or appending strings, and
formatting text:
===>
list $lp zz F7
===>
change "bob"Robert" zz F7
===>
verify zz F7 {check current ZZ
range}
===>
zz off F7 {cancel ZZ
range}
If you want to copy text into your current
workfile from another file that is not a Qedit file, you cannot use the methods
described above. You cannot Open the second file if it is not in Qedit format.
Instead, use the List command to find the portion of text that you want to add
from it (without Shutting the first file). Then, use the Add command to paste
in the text.
===>list
xxx
===>add
* = xxx 10.7/22.9
All Qedit commands are supported in Visual
mode. To do a command, such as Listf or ls, press the Home Up key to reach the
home line, then type your command after the ===> and press F7 or Enter. To
execute a command, such as Change, on a subset of the file, first use the ZZ
cut-and-paste indicators to mark the subset and then use ZZ in the command.
After most ===>
commands, Qedit prompts you for more commands ("Next command
[Visual]"). Type in more commands, or return to your Visual screen above,
by pressing the Enter or Return key.
Qedit accepts each
command, executes it and goes back to the "Next command" prompt.
There are a few exceptions to this process. By default, when you enter an Open
command, Qedit assumes you want to edit the file immediately and switches into
full-screen mode automatically. If you wish to disable this feature, enter Set
Visual Editonopen Off.
If the tilde has
been removed from the list of string delimiters (see Set
Stringdelimiters)
and you enter a tilde "~" at the "Next command" prompt,
Qedit uses the current line number associated with the tilde, makes it the
current line and goes back into Visual immediately.
To search for a string, simply type it in
quotes at the ===> line and press F7 or Enter.
===>"string" F7
Qedit will find
the next line containing that string,
display the page around it, and show the target string in the Status line. To
find the next occurrence of the same string, press F4.
To find the previous occurrence of a string, prefix
the string with a circumflex.
===>^"string"
F7
To find the next previous
occurrence, press F3.
You may delimit strings with any of the
following characters:
|
~
|
Tilde
|
|
|
|
Vertical line,
Up-line
|
|
"
|
Quotation mark
|
|
'
|
Apostrophe, Single
quote
|
|
:
|
Colon
|
|
%
|
Percent sign
|
|
\
|
Reverse slant,
Backslash
|
You may use single quotes (') if you do not
have Set Decimal On. Note that, with this syntax, Qedit permits a few less
characters in Visual mode than it does in Line mode because Visual mode uses
these characters for other purposes. For example, the question mark is used to
get quick help about Visual mode, instead of as a string delimiter. If you
insist on using other delimiters, you should use the Find command on the ===> line.
===>F
:string: F7
You can change
strings on the screen by entering a Change command on the ===> line.
===>c
"niether"neither" */*+19 F7
To get help, press
Home Up, type ? and press F7 or Enter.
===>? F7
The ? command
gives a one-screen summary of Visual mode. For complete on-line help on Qedit,
including Visual, type HELP in the ===>
line and press F7 or Enter.
===>help F7
For help on a
specific command, type HELP [command name].
See the Help command in the "Qedit Commands" chapter. To get out of
help, press F8.
To format a screen
paragraph, mark the paragraph with ZZ cut-and-paste indicators, then use a
Justify command that includes a ZZ. For example:
===>justify both margin 68 zz
F7
If every paragraph
ends with a blank line, you can Justify a paragraph by using the relative line
number on the screen. Justify will start at that point and continue until it
finds a blank line:
===>justify both margin 68 *+2
F7
For more
information on Justify, see the Justify command in the "Qedit
Commands" chapter.
After you have made some changes to your
screen in Visual mode and updated the file by pressing Enter, you may decide
you don't want those changes after all. You can use the Undo command to cancel
these changes.
All of the changes
you make on the screen before pressing Enter, are treated by Qedit as one
"undo-able" command, except for cut-and-paste operations. Qedit
always executes a cut-and-paste last after updating the file with any other
changes, no matter what order the changes were made in. This means that you can
choose to undo just the cut-and-paste operation, or undo it and all of the
other changes. You can continue undoing your previous changes until the file is
back to its original state.
If you make changes to the screen, then
decide not to keep them before you
press Enter to update your screen, how do you get your original text back? You refresh the screen by typing a * on the
home line, then pressing F7, F1 or Enter (or any function key with Set Vis
Update On). Use the Undo command if you press Enter and then decide that you
don't want to keep your changes.
If you insert so
many new lines that you push the column template line right off the bottom of
your screen, don't worry -- it's not really gone. Qedit won't update your
screen without the template line, however. Press Next Page (Pg Dn) to pull up
the next screen of display memory. You have a problem only if you inserted so
many lines that you pushed the template line right out of display memory, and
even then you can still recover your changes. See the Errors in Visual section of Appendix E, regarding qscreen.
Screen Refresh is particularly
useful if you've pressed Clear Display by accident.
===>* F7
When using Set Vis
Update On to automatically update the screen, use *> F7 or *< F7 to move
ahead or back one page, without updating the current page.
You may enter any
Line mode Qedit command in the ===>
line, including Opening another file, and calculator commands (=). The
ZZ cut-and-paste indicator can be used to mark a group of lines for use in any
Qedit Line mode command.
===>list
$char zz F7
When editing a file with short records (e.g.,
Set Lang Text, Set Len 20), the right margin of terminal display memory is set
to match the record length. This means that when typing home line commands you
wrap the status line at the same width as the records (very inconvenient if the
record length is 3 bytes!). You can, however, cursor past the right margin to
type a longer command. Therefore, Qedit expands the right margin when you use F7
to execute the home line command, making it possible to execute a long command
even when the data length is short. Qedit cannot expand the right margin if you
press Enter (and may cut short your command).
If your function
keys do not work for some reason, you may not be able to use F8 to exit from
Visual. Instead, press Home Up, type / and press Enter. This updates your
current screen and returns you to Line mode.
===>/ F7
