Qedit 5.8 for HP-UX

User Manual

Doc-To-Help Standard Manual


 

Program and manual copyright 1977-2008 Robelle Solutions Technology Inc.

Permission is granted to reprint this document (but not for profit), provided that copyright notice is given.

Updated Monday, August 11, 2008

 

 

Qedit and Suprtool are trademarks of Robelle Solutions Technology Inc. Windows is a trademark of Microsoft Corporation. Other product and company names mentioned herein may be the trademarks of their respective owners.

I

Robelle Solutions Technology Inc.

7360 137 Street, Suite 372

Surrey, B.C. Canada V3W 1A3

Phone: 604.501.2001

Fax: 604.501.2003

E-mail: sales@robelle.com

E-mail: support@robelle.com

Web: www.robelle.com


Contents

Welcome to Qedit 1

Introduction. 1

Documentation. 2

User Manual 2

Change Notice. 2

Printed Documentation. 2

Customer Support 2

Robelle Newsletter 2

Additional Software. 2

Qcat 3

Qaccess. 3

Compare. 3

Notation. 3

New to Qedit 5.8. 4

Installing Qedit/UX 5

General Installation Notes. 5

Who Should Use These Instructions?. 5

Summary of Installation Steps. 5

Step 1: Log On as Root 5

Step 2: Create Robelle Directory. 6

Step 3: Restore Files. 6

Step 4: Set Up PATH (Optional) 6

Step 5: Start the Qedit for Windows Server (optional) 6

Getting a Quick Start with HP Full-Screen Editing 9

Introduction. 9

Starting Visual Mode. 10

Screen Layout 11

Home Line. 11

Status Line. 11

Text Lines. 11

Template Line. 11

Special Indicator Columns. 12

Using Your Keyboard. 12

Moving the Cursor 12

Editing the Text Lines. 12

Control Functions. 13

Reflection for DOS Keyboards. 13

Other PC Keyboards. 14

Function Keys. 14

Browsing Through Your File. 15

Cut-and-Paste. 16

Cutting Operations. 16

Pasting Operations. 17

Resetting Cut-and-Paste. 17

Copying a Block of Text 17

Cut-and-Paste Between Files. 18

Dividing and Gluing Operations. 18

Dividing Lines in Visual Mode. 18

Gluing Lines in Visual Mode. 19

Excluding Lines From Visual Mode Display. 19

Justifying Lines in Visual Mode. 19

Renumbering Lines. 20

Inserting Blank Lines. 20

Hold Files. 20

Marking Changes Without Using Line Numbers. 20

Paste from a Non-Qedit File. 20

Home Line Commands. 21

Finding Strings. 21

Changing Strings. 22

Help on Visual Mode. 22

Formatting Paragraphs. 22

Undoing Changes in Visual Mode. 22

Refreshing the Screen. 23

Other Line Mode Commands. 23

Truncated Home Line. 23

Exit from Visual 23

Getting a Quick Start with VT Full-Screen Editing 25

Introduction. 25

Home and End keys. 25

Starting Screen Mode. 25

Troubleshooting. 26

Screen Layout 26

Status Line. 27

Text Lines. 27

Message Line. 27

Using Your Keyboard. 28

Moving the Cursor 28

Editing the Text Lines. 29

Control Functions. 29

Browsing Through Your File. 29

Cut-and-Paste. 30

Resetting Cut-and-Paste. 31

Copying a Block of Text 31

Splitting and Joining Lines. 31

Getting a Quick Start with Line Mode Editing 33

Introduction. 33

Adding Lines to a File. 33

Looking at the File. 34

Browsing the File. 35

Searching the File. 35

Editing Lines. 36

Global Changes. 37

Copying Lines. 38

Moving Lines. 38

Deleting Lines. 39

Help Command. 40

Saving the File. 40

Open and Shut for Instant Access. 40

Running Qedit under HP-UX 43

Running Qedit 43

Visual Mode for HP Terminals. 43

Screen Mode for VT Terminals. 44

Edit Several Files at Once. 44

How to Edit Several Files?. 44

Starting a New Scratch File. 44

Configuring Different Shells. 45

Bourne and Korn Shells. 45

C Shell 45

Setting Up a PATH for Qedit 45

Bourne and Korn Shells. 46

C Shell 46

Control Characters and stty. 46

Qeditmgr Configuration Files. 46

Default Set Commands. 47

On-Line vs. Batch Access. 47

Command Line Options. 47

Initial Command Line: -ccmdstring. 47

Editing a Single File: -s. 48

Exit with Verify: -v. 48

"Discard Changes?" on Exit 48

HP-UX Notes. 48

EDITOR Variable. 48

Scratch File. 49

Hold Files. 49

Shell Commands. 49

Shell Command History. 50

Tab Stops. 51

Hardcoded File Names. 51

/opt/robelle/qeditmgr 51

$HOME/.qeditmgr 51

/opt/robelle/help/qedit 51

Visual Mode. 51

Variables that Drive Qedit 52

Setting Variables in Your Shell 52

RCRTMODEL Variable. 53

RPCVERSION Variable. 55

RCRTWIDTH Variable. 55

Function Key Labels. 55

RCRTSTRAPSGH for Handshaking. 56

QEDITMGRTRACE Variable. 56

QEDCURWFILE Variable. 56

QEDSTOREDPWD and QEDPROMPTEDPWD Variables. 56

ROBELLE Environment Variable. 57

Converting Qedit Files with qcat 57

Differences Between MPE and HP-UX.. 57

Open/Shut 58

Current "*" File Name. 58

Missing Features. 58

Qedit for Microsoft Windows 59

Introduction. 59

Server Process. 59

HP-UX 10.0. 59

Port Number 60

Log Files. 61

Console Messages. 61

Access Log. 61

Error Log. 61

Trace Log. 61

Log File Names. 61

Qedit Issues and Solutions 63

Running Qedit with Reflection. 63

Alt-Y vs. :Reflect 63

Form Feed Causing Return/Line Feed. 63

Completion Codes. 64

Controlling the PC.. 64

Accidental Exit from Reflection. 64

Changing the Exit Keystroke. 65

Files without NewLine Characters. 65

Lines, Strings and Ranges. 66

Qedit Commands 69

Introduction. 69

General Notes. 69

Abbreviations. 69

Uppercase or Lowercase. 69

Multiple Commands per Line. 70

Comments on Command Lines. 70

Stopping Commands with Control-Y.. 70

Implicit Commands. 70

Function Keys. 71

Shell Commands. 71

Calculator Commands. 71

Add Command [A] 72

Add (Adding New Lines) 72

Add (Adding a String as a Line) 74

Add (Copying Lines within a File) 74

Add (Moving Lines within a File) 75

Add (Copying Lines Between Files) 75

Append Command [AP] 77

Backward Command [BA/F5] 78

Before Command [B] 79

CD Command [CD] 81

Change Command [C] 82

Change (Changing Strings) 82

Change (Changing Columns) 85

Close Command [CL] 86

Colcopy Command [COL] 87

Colmove Command [COLM] 90

Delete Command [D] 93

Destroy Command [DES] 95

Divide Command [DI] 96

:Do Command [DO] 97

Exit Command [E/F8] 98

Find Command [F/F4] 99

Findup Command [FINDU/F3] 100

Form Command [FORM] 101

Forward Command [FO/F6] 102

Garbage Command [GAR] 103

Glue Command [G] 104

Help Command [H/?] 105

Hold Command [HO] 106

Justify Command [J] 107

Keep Command [K] 113

List Command [L] 116

:Listredo Command [LISTREDO/F7] 126

:Listundo Command [LISTU] 127

LS Command [LS] 128

Lsort Command [LSO] 129

Merge Command [ME] 130

Modify Command [M] 132

New Command [N] 142

Open Command [O] 143

Proc Command [P] 147

Q Command [Q] 148

:Redo Command [REDO] 149

:Reflect Command [REFLECT] 150

Renumber Command [REN] 152

Replace Command [R] 153

Set Command [S] 154

Account 156

Alias. 156

Autocont 158

Check. 158

Decimal 158

DL size. 159

Editinput 159

Expandtabs. 160

Extentsize. 160

Extprog. 160

Filename. 160

FORTRAN.. 160

Halfbright 161

Hints. 161

Hppath. 161

Increment 161

Interactive. 161

Justify. 162

Keep. 162

Language. 165

Left 167

Length. 167

Lib. 167

Limits. 167

List 168

Maxdata. 168

Modify. 169

Open. 170

Pattern. 171

Priority. 171

Prompt 171

Redo. 172

Right 173

RL file name. 173

Shift 173

Spell 173

Statistics. 174

Stringdelimiters. 174

Tabs. 174

Term.. 175

Text 176

Totals. 177

UDC.. 178

Undo. 178

Varsub. 178

Visual 179

Warnings. 189

Whichcomp. 189

Window.. 190

Work. 190

Wraparound. 192

X.. 192

Zip. 195

Shut Command [SH] 197

Spell Command [SP] 198

Text Command [T] 199

Undo Command [UN] 204

Up Command [UP/F2] 206

Use Command [U] 207

Verify Command [V] 208

Visual Command [VI/F1] 209

Words Command [W] 211

Zave Command [Z] 212

ZZ Command. 213

Calculator Command [=] 214

Troubleshooting and Error Messages 217

Introduction. 217

Messages. 217

Quit Errors. 219

Errors in Visual 219

Using Visual with X.25. 219

Using Visual on HP-UX.. 219

Terminals Supported by Visual 219

Problems with 700/9x Terminals. 219

Visual Error Messages. 220

File Formats 223

Introduction. 223

Qedit Workfiles. 223

Original Format Workfiles. 223

Jumbo Workfiles. 224

External Files. 225

Regular Expressions 229

Introduction. 229

Metacharacters. 229

Character Class. 231

Escape Character 233

Escaped Sequences in Regular Expressions. 233

Backreferences in Regular Expressions. 234

Escaped Characters in Replacement String. 235

Qedit Glossary 237

Introduction. 237

Terms. 237

Abbreviating. 237

Batch. 237

Calculator 238

Column. 238

Command. 238

Control Character 239

CRT.. 239

Current Line. 239

Defaults. 239

External File. 240

File Names. 240

Full-Screen Editing. 241

Hold File. 241

J Option. 241

Jumbo Files. 241

Keep File. 241

Language. 241

Left 242

Length. 242

Line. 242

Linenum.. 242

Margins. 243

Memory Lock. 243

Patterns. 243

Quiet-Q Option. 244

Range. 244

Rangelist 244

Relative Line Numbers. 246

Right 246

Shifting. 246

String. 246

Tab. 247

Template-T Option. 247

Visual Editing. 247

Window.. 247

Workfile. 248

Special Characters. 248

? Means Help, Nonprinting Characters, Alphanumeric (in Patterns) or Optional (in Regexp) 249

$ Means Hex, Memory Lock, List Option, Previous File or End-Of-Line (in Regexp) 249

^ Means Findup, Control-Char, Start-of-line (in Regexp) or Negate (in Regexp) 249

. Means Nonprinting, Reset, Decimal Point or Any Character (in Regexp) 250

! Means Shell Script or Too Long. 250

% Means Octal or String. 250

* Means Current, Refresh, Multiply or Quantifier (in Regexp) 250

\ Means Previous, String, Literal Match (in Regexp) or Special Characters (in Regexp) 251

/ Means Prompt, Range Delimiter, Stop, Exit, or Divide. 252

[ Means FIRST, [default] or Start Class (in Regexp) 252

] Means LAST or End Class (in Regexp) 252

{ } Are for Comments or Indentation. 253

@ Means ALL. 253

& Means Literal Match. 253

: Means Shell Commands or String. 253

; Means Multiple Commands. 253

, Means a List 254

= Means Copy or Calculate. 254

< Means Move, I/O Redirection or Backward Page. 254

> Means Forward Page, I/O Redirection, Modify or Qhelp. 254

" Means String. 255

( Means Start Parameter, Command or Subpattern (in Regexp) 255

) Means End Parameter, Command or Subpattern (in Regexp) 255

+ Means Ahead Some Lines, Add or Quantifier (in Regexp) 255

- Means Back Some Lines, Minus or Range (in Regexp) 256

# Means Numeric Pattern. 256

~ Means Spaces (Pattern), Recent Page or Field. 256

How to Contact Robelle 257

Support 257

Index 260

 


Welcome to Qedit

Welcome to Qedit, the fast, full-screen text editor for MPE and HP-UX. To get into Qedit/UX, enter this command:

/opt/robelle/bin/qedit

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/

User Manual

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.

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/

Printed Documentation

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

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

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

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.


Installing Qedit/UX

Here we describe how to install and configure Qedit. The following are general notes about installing Qedit.

Who Should Use These Instructions?

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.

Summary of Installation Steps

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.

mkdir /opt/robelle

Use the following command to restore the Qedit/UX files from the distribution tape:

tar xv /opt/robelle

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:

/opt/robelle/bin/qedit

You invoke Qedit with this command:

/opt/robelle/bin/qedit

If you just type

qedit

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:

qedit -d

The Qedit server process requires three log files. By default, these files are located in the following directory:

/opt/robelle/log/qedit/

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.


Getting a Quick Start with HP Full-Screen Editing

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, Qedits 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[Help1]  is available in Screen mode[Help2]  (Set Visual Screen On) on VT-type terminals or in Visual Blockemulation[MN3]  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.

Home Line

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.

Status 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.

Text Lines

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.

Template 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.

Special Indicator Columns

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.

Moving the Cursor

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

 

Editing the Text Lines

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

 

Control Functions

To return from Visual mode to Line mode:

 

F8

exit from Visual

 

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!

 

Reflection for DOS Keyboards

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

 

Other PC Keyboards

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.

Cutting Operations

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

 

Pasting Operations

 

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.

Resetting Cut-and-Paste

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

Copying a Block of Text

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.

Cut-and-Paste Between Files

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.

Dividing and Gluing Operations

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

 

Dividing Lines in Visual Mode

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.

Gluing Lines in Visual Mode

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.

Excluding Lines From Visual Mode Display

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[Help4] . 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[Help5] , MM[Help6]  or other XX.

If any of these rules are broken, Qedit displays an appropriate error message.

Justifying Lines in Visual Mode

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.

Renumbering Lines

When the insertion point is on the current screen, Qedit renumbers the screen if needed (and if Set Vis Renum is ON).

Inserting Blank Lines

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.

Hold Files

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.

Marking Changes Without Using Line Numbers

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}

 

Paste from a Non-Qedit File

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[Help7] ) 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.

Finding Strings

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

Changing Strings

You can change strings on the screen by entering a Change command on the ===> line.

===>c "niether"neither" */*+19 F7

Help on Visual Mode

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.

Formatting Paragraphs

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.

Undoing Changes in Visual Mode

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.

Refreshing the Screen

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.

Other Line Mode Commands

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

Truncated Home Line

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).

Exit from Visual

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


Getting a Quick Start with VT Full-Screen Editing

Qedit's full-screen mode on VT terminals is called Screen mode, which works with most VT terminals (i.e., VT100 and VT220). To use Screen mode, you must have a VT terminal or terminal emulator, and you must have a terminfo entry for your VT terminal in your configuration (use untic vt100 or untic vt220 to check your terminfo entries).

Screen mode differs from Visual mode by not relying on the block-mode feature of HP terminals. It enables you to page forward and backward through your file, as well as to move, copy, mark and delete blocks of text with Screen mode's cut-and-paste functions.

Screen mode is a good introduction to the HP operating system 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. Screen 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 (e.g., HPDesk, elm) to put your users directly into Screen mode when they edit a message.

Home and End keys

On PC's running a terminal emulator, the Home and End keys correspond to the Home and End keys on your keyboard. On VT100 terminals, these keys correspond to keypad-7 for Home and keypad-1 for End because there are no keys labeled Home and End. In addition to the keypad equivalents, VT220 terminals also correspond Home to the Find key and End to the Select key.

After you have invoked Qedit, and used Text or Open to access a file, you can switch from Line mode to Screen mode by typing "vi." If you don't have a file open when you type "vi", Qedit will open an empty scratch file and fill it with a blank line.

In Line mode you must type command and text lines, and press Return after each line. In Screen mode you can edit a full screen of text by moving the cursor around the screen, inserting and deleting lines and characters, and joining and splitting lines. To move through the file, use PF3 and PF4 (or the Prev and Next keys if you have a VT220 or above).

You can perform additional editing functions by using control-key sequences. For example, to mark the first line in a cut-and-paste operation, press ^L. When you are finished editing, use ^E to exit Screen mode.

Troubleshooting

If your TERM environment variable is set to a VT terminal, Qedit will automatically use Screen mode when you type "vi." If you are running Reflection with HP and VT emulation, and Qedit is still using Visual mode, you should check the following items:

         The RCRTMODEL environment variable is set to 0.

         The TERM variable has been exported. Use export to see a list of your exported variables.

         The value used in your TERM variable is a valid terminfo entry. Type in untic $TERM or untic terminfo value to check this.

You can also manually put Qedit into Screen mode by typing in the following command:

set vis screen on

The screen starts with the Status Line, several Text Lines, and ends with the Message Line.

Qedit Full-screen editing (Reflection in VT220 emulation mode)

Status Line

The first line shows the current line number and column location of your position in the file, the insert/replace mode, and the name of the file you are editing. For example,

L 11 C 5 I monthly.report

Text Lines

By default, the number of lines on the screen is LINES-2. The default value of LINES is specified in the terminfo entry for your terminal. You can override terminfo's default value by setting the shell environment variable LINES.

Message Line

The last line on the screen is the message line. When you first enter Screen mode, this line displays a list of commonly used control keys. As you edit a file, Qedit uses this line to display messages about your editing operations. After a message is displayed, it remains on the screen until you move to another screen (e.g., by scrolling or by paging forward or backward). Then the list of commonly used keys will appear in the message line again.

In Screen mode, the keyboard gives you the power to move around the screen, to edit text, and to control the flow of Qedit.

Moving the Cursor

You can move around the screen by using the cursor keys and the numeric keypad.

VT100 and up

VT100 keystrokes:

Key

Action

Cursor Left

Move one space to left

Cursor Right

Move one space to right

Cursor Up

Move one space up

Cursor Down

Move one space down

PF1

Display help screen

PF3

Previous page of text

PF4

Next page of text

Home

Go to beginning of line

End

Go to end of line

Home Home

Go to beginning of file

End End

Go to end of file

Keypad Layout

VT100 keystrokes:

[ 7]

Home

[ 8 ]

Cursor Up

[ 9 ]

Previous Page

[ 4 ]

Cursor Left

[ 5 ]

Toggle Wordmove

[ 6 ]

Cursor Right

[ 1 ]

End

[ 2 ]

Cursor Down

[ 3 ]

Next Page

[ 0 ]

Insert

[ . ]

Remove

 

VT220 and Up

VT220 keystrokes:

Key

Action

Prev Page

Previous page of text

Next Page

Next page of text

Find

Home

Select

End

Insert

Toggle insert/overwrite mode

Remove

Delete current character

If you are using a modem to access your HP-UX computer, you can try pressing ^O to toggle the fast scroll option. This option, whose default is Off, may speed up single-line scrolling operations. However, the screen update with fast scroll may be visually annoying.

The toggle WordMove feature selects whether the left and right cursor keys will move by characters or by words. This feature is useful if you have a slow connection to your host machine.

Press keypad-5 to move by word. Qedit defines a word as a sequence of alphanumeric characters or a sequence of punctuation characters. For example, the line "if (a==b)" contains 6 words: if, (, a, ==, b, and ). Press keypad-5 again to move by full words. Qedit defines a full word as a sequence of non-blank characters. For example, "if (a==b)" contains these 2 full words: if and (a==b). Press keypad-5 once again to return to move by single character.

Editing the Text Lines

You revise the screen image by using these keys:

Key