Welcome to Qedit, the fast, full-screen
text editor for MPE and HP-UX. To get into Qedit/UX, enter this command:
Qedit version 6.3 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.
They are also available as PDF or HTML files. You can download the
files from the Robelle web site at: 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.
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.
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 289 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.
·
Qedit for HP-UX now writes out
the size of a fixed length file when making a file fixed length, with set keep
var off. It will also write out a file
as to whether or not Line Feeds are on or off.
The files are local to your working directory under the names .qxrecsize
and .qxlf.
·
The Qedit Server now supports
login via PAM and which supports LDAP.
This is an overview of all the changes
implemented in this version.
·
The Qedit for Windows Server
would not honour an administrative lock and other reasons why an account would
not be accessible.
This is an overview of all the changes
implemented in this version.
·
The Verify command incorrectly
parsed certain entries near the end of the verb table such as ZZ, String etc.
·
The Calendar intrinsic is being
phased out of Qedit and all Robelle products, which will help all products run
past 2028.
·
Qedit
on HP-UX now has the command set compatvarsub on which does not replace
$-variables that are not defined with spaces. It simply passes the $token, thru
to the Qedit command interpreter if the variable is not defined.
·
Qedit
now recognizes files with the extension of .COB and .cob as Cobol files on
HP-UX.
·
Qedit
now support long user names on HP-UX 11.31, implemented by lugadmin.
·
Qedit
now supports the HP-UX Long Password feature on HP-UX 11.31. Error messages
have been improved for login issues.
·
Qedit
would return a status code of 123 upon exit even if an error had not occurred.
Here we describe how to install and configure
Qedit. The following are general notes about installing Qedit.
The system manager should use the following installation
instructions to install Qedit/UX. No one can be using Qedit/UX during the
installation. The installation should only take a few minutes.
To install Qedit/UX, follow these steps:
1.
You must log on as root.
2.
You must create the correct
directory structure.
3.
Qedit/UX and its associated
files must be restored from the distribution tape.
4.
You can set up a PATH for
Qedit/UX or copy it to an existing directory in your PATH. (optional step)
5.
If you have the Qedit for
Windows server, you need to start the daemon process. (optional step)
There are two ways to log on as root:
1.
Exit from HP-UX and log on with
root as the user name.
2.
If you are already logged on,
you can execute this command:
su -
In either case, you have to supply the
user password for root.
Qedit/UX is installed in /opt/robelle.
Before restoring the Qedit/UX files you must first create the /robelle
directory.
Use the following command to restore the
Qedit/UX files from the distribution tape:
This command assumes your tape device is
/dev/rmt/0m. If it is not, you need to specify your tape device by using the
"f" option in the tar command. For example, if your tape device is
/dev/rmt/1m, you need to use the following command to restore the files:
tar xvf /dev/rmt/1m
/opt/robelle
Once the files have been restored, you
can run the new version of Qedit/UX:
You invoke Qedit with this command:
If you just type
to invoke Qedit/UX, you must either add
/opt/robelle/bin to your PATH or copy /opt/robelle/bin/qedit to a directory
that is currently on your PATH. Similarly, the man pages for Qedit are found in
/opt/robelle/man/man1/qedit.1. To make the man pages available to everyone, you
can either add /opt/robelle/man to your MANPATH or you can copy the man pages
to a directory that is currently on your MANPATH.
Details of how to set up either PATH or
MANPATH on a system-wide or user basis can be found in the chapter
"Running Qedit under HP-UX."
If you have the Qedit for Windows server software, you must start
the Qedit/UX daemon process before any Qedit clients can connect to your HP-UX
machine. To allow users to connect to the Qedit/UX daemon process, you must log
on as root and issue this command:
The Qedit server process requires three
log files. By default, these files are located in the following directory:
If you have moved Qedit to a different
directory, Qedit tries to identify its current location and adjust the location
of the log files. If it is not able to correctly identify its location, it will
default back to /opt/robelle.
If you wish to explicitly identify the
logfiles location, you can perform the following steps:
1.
Set the ROBELLE environment
variable with the new directory name before you start the Qedit server process.
2.
Make sure the new directory has
exactly the same structure as the /opt/robelle directory.
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 39.
|
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
