Logitech_Mouse_Users_Manual_Feb87 Logitech Mouse Users Manual Feb87 Logitech_Mouse_Users_Manual_Feb87 manual pdf -FilePursuit Logitech_Mouse_Users_Manual_Feb87 Logitech_Mouse_Users_Manual_Feb87
User Manual: Logitech_Mouse_Users_Manual_Feb87
Open the PDF directly: View PDF .Page Count: 324
IDGITECH'"
MOUSE
User's Manual .
~LOGITECH
Serial Mouse
Bus Mouse
Series 2 Mouse
TM
LOGITECH Mouse
USER'S MANUAL
Copyright © 1984, 1985, 1986, 1987, by LOGITECH, Inc.
All Rights Reserved.
No part of this document may be copied or reproduced in any form or by any means
without the prior written consent of LOGITECH, Inc.
LOGITECH, Inc. makes no warranties with respect to this documentation and disclaims
any implied warranties of merchantability or fitness for a particular purpose. The
information in this document is subject to change without notice. LOGITECH, Inc.
assumes no responsibility for any errors that may appear in this document.
From time to time, changes may occur in the filenames and in the files actually included
on the distribution disks. LOGITECH, Inc. makes no warranties that such files or
facilities as mentioned in this documentation exist on the distribution disks or as part of
the materials distributed.
This edition applies to LOG/TECH Plus software, Version 3.40 or later for the
LOG/TECH Mouse.
Document#:
Initial issue:
Current revision:
Printed:
LU-UD-OO 12-1
February 1984
September 1987
September 1987
Trademarks
LOGIMOUSE is a registered trademark, and Click, LOGITECH, LOGICADD, LOGIMENU,
LOGIPAINT, PaintShow, POINT, and Point & Click are trademarks of LOGITECH, Inc.
IBM is a registered trademark, and PS/2 and TopView are trademarks of International Business
Machines Corporation.
Intel is a registered trademark of Intel Corporation.
Microsoft and MS-DOS are registered trademarks, and Windows is a trademark of Microsoft
Corporation.
UNIX andAT&T are registered trademarks of American Telephone and Telegraph Corporation.
BIX is a trademark, and Byte is a registered trademark of McGraw-Hill, Inc.
Summagraphics and SummaMouse are registered trademarks, andMM Series and Bit Pad One are
trademarks of Summagraphics Corporation.
Lotus, 1-2-3 and Symphony are registered trademarks of Lotus Development Corp.
ii
WordStar is a registered trademark and EASY is a trademark of MicroPro International Corp.
Compaq Portable is a trademark of Compaq Computer Corp.
AT&T 6300 and 6300 Plus are trademarks of AT&T.
Hercules Graphics Card is a trademark of Hercules Computer Technology
HP Vectra is a registered trademark of Hewlett Packard Company
Tandy is a registered trademark of Tandy Corporation
ClickArt Personal Publisher is a trademark of Software Publishing
GEM is a registered trademark of Digital Research
Norton Commander is a trademark of Peter Norton
PC Paintbrush is a trademark of ZSoft Corp.
Sigma Color 400 is a trademark of Sigma Designs, Inc.
Tecmar Graphics Master is a trademark of Tecmar, Inc.
AutoCAD is a registered trademark of Autodesk, Inc.
Generic CADD is a trademark of Generic Software
Cadkey is a registered trademark of Micro Control Systems
Cadvance is a trademark of CalComp
Drafix is a trademark of Foresight Resource
Dr Halo II is a registered trademark of Media Cybernetics
PCad is a registered trademark of PCad
VersaCADD is a trademark ofT&W
Personal Designer is a trademark of Computer Vision
Reflex is a trademark of Borland International
Smalltalk V is a trademark of Digitalk
smARTWORK is a trademark of Wintek
Telepaint is a trademark of LCS Telegraphics
MICROGRAPHX is a registered trademark,
MICROGRAPHX Inc.
and
IN*A *VISION is
Framework II is a trademark of Ashton-Tate
SuperCalc 3 is a registered trademark of Sorcim Corporation
Ventura Publisher is a trademark of Ventura Software
VP-Planner is a trademark of Paperback Software International
Xerox is a trademark of Xerox Corporation
XTREE is a registered trademark of Executive Systems
iii
a trademark
of
. . . - - - - - LOGITECH Software License Agreement --------,
THIS DOCUMENT IS A LEGAL AGREEMENT BE1WEEN YOU, THE UCENSEE, AND
LOGITECH, INC ("LOGITECH"). By USING THIS PROGRAM, YOU ARE AGREEING
TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO
THE TERMS OF THIS AGREEMENT, PROMPTLY RETURN THE DISK PACKAGE AND THE
OTHER ITEMS THAT ARE PART OF THIS PRODUCT IN THEIR ORIGINAL PACKAGE, WITH
YOUR PAYMENT RECEIPT (THE "RECEIPT"), TO LOGITECH FOR A FULL REFUND.
In consideration of payment of the License Fee, which is a part of the price
evidenced by the Receipt, LOGITECH grants to the Licensee a nonexclusive
right, without right to sublicense, to use this copy of this LOGITECH Software on
a single Computer at a time. LOGITECH reserves all rights not expressly
granted, and retains title and ownership of the Software, including all subsequent
copies in any media. This Software and the accompanying written materials are
copyrighted. You may copy the Software solely for backup purposes; all other
copying of the Software or the written materials is expressly forbidden.
As the only warranty under this Agreement, and in the absence of accident, abuse
or misapplication, LOGITECH warrants, to the original Licensee only, that the
disk(s) on which the Software is recorded is free from defects in materials and
workmanship under normal use and service for a period of ninety (90) days from
the date of payment as evidenced by a copy of the Receipt. LOGITECH's only
obligation under this Agreement is, at LOGITECH's option, to either (a) return
payment as evidenced by a copy of the Receipt or (b) replace the disk that does
not meet LOGITECH's limited warranty. and which is returned to LOGlTECH
with a copy of the Receipt. THIS WARRANTY GIVES YOU UMlTED, SPECIFIC LEGAL
RIGHTS. You MAY HAVE OTHER RIGHTS, WHICH VARY FROM STATE TO STATE.
THE SOFfWARE AND ACCOMPANYING WRITTEN MATERIALS (INCLUDING THE
USER'S MANUAL) ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND
INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABIUTY AND FITNESS FOR A
PARTICULAR PURPOSE, EVEN IF LOGITECH HAS BEEN ADVISED OF THAT PURPOSE.
LOGITECH SPECIFICALLY DOES NOT WARRANT THAT THE OPERATION OF THE
SOFfWARE WILL BE UABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR
INCIDENTAL DAMAGES ARISING OUT OF THE USE OF OR INABIUTY TO USE SUCH
PRODUCT EVEN IF LOGITECH HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR UMITATION OF
LIABIUTY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE
UMITATION MAY NOT APPLY.
iv
r----
LOGITECH Limited Lifetime Hardware Warranty - - - - ,
Non-Transferrable
LOGITECH mice and mouse boards are warranted to be free from failures due to
defects in material and workmanship for as long as you own them. During the
first two years, LOGlTECH will, at its sole option, replace or repair at no charge
the product which, in its opinion, is defective.
During the remaining years of the warranty, LOGlTECH will, at its sole option,
replace or repair the defective product; LOGlTECH will charge you a fixed fee to
cover handling and service costs based on LOGlTECH's then current price
schedules. LOGlTECH, at its sole option, may replace or repair the defective
product with a then-current product having similar features and functionality as
determined by LOGITECH.
You are responsible for packing the failed product properly for shipment, and for
the charges to ship the failed product to LOGlTECH, and LOGlTECH is
responsible for charges to ship the repaired or replacement product. If any charge
to you is involved, the replacement product will be sent C.O.D.
If the failed product has been modified without LOGlTECH's consent or if the
failure is the result of misuse, abuse or misapplication, LOGlTECH has no
obligation to repair or replace the failed product.
Before returning a failed unit, you must obtain a Return Merchandise
Authorization (RMA) number by calling LOGlTECH Customer Service: in the
U.S., phone (800) 231-7717; in California call (800) 552-8885. The RMA
number should be prominently displayed on the outside of the returned package
and on the accompanying packing list. LOGlTECH cannot be held responsible
for any package returned without an RMA Number.
EXCEPT AS EXPRESSLY PROVIDED ABOVE, THE HARDWARE AND ACCOMPANYING
WRITTEN MATERIALS (INCLUDING THE USER'S MANUAL) ARE PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND, INCLUDING THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, EVEN IF
LOGITECH HAS BEEN ADVISED OF THAT PURPOSE. IN NO EVENT WILL
LOGITECH BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR
INCIDENTAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE SUCH
PRODUCT EVEN IF LOGlTECH HAS BEEN ADVISED OF THE POSSIDILITY OF SUCH
DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR UMITATION OF
LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE
LIMITATION MAY NOT APPLY.
PLEASE RETURN THE ENCLOSED REGISTRATION CARD FOR YOUR WARRANTY TO BE
VAUD.
WARRANTY CLAIMS MAY NOT BE HONORED IS THERE IS NO
CORRESPONDING REGISTRATION CARD ON FILE AT LOGlTECH, INc.
v
Notes:
vi
The LOGITECH Mouse
~-----------------(IMPORTANT)------------------~
See the READ.ME file on Disk 1 for late breaking news about this version of
LOG/TECH Mouse Software.
Introduction
Introduction
Traditionally, the mouse has been used as a pointing device by CAD , PAINT, and other
graphics-oriented applications. Many software developers, recognizing the flexibility
and immediacy of the mouse as a productivity tool, are now building applications in nongraphics business and creative environments as well, with applications ranging from data
base and spreadsheet management on through telecommunications and desktop
pUblishing.
Recognizing the importance of the expanded uses for the mouse, LOGITECH Mouse
software has also been designed to be able to emulate cursor keys and implement
keyboard macros for your favorite non-mouse applications.
ix
Introduction
What have you purchased?
This manual tells you how to work with the range of LOGITECH Mice, including the
LOGITECH Serilll Mouse, Bus Mouse, and the LOGITECH Series 2 Mouse.
The LOGITECH Serial Mouse
The LOGITECH Serilll Mouse Package consists of:
•
•
•
•
•
The LOGITECH Serial Mouse
A 9- to 25 pin adapter.
LOGITECH Mouse driver software on 5 1/4" disk.
LOGITECH Mouse Plus software on 5 1/4" disk.
The LOGITECH Mouse User's Manual,
the manual you are now reading.
The LOGITECH Bus Mouse
The LOGITECH Bus Mouse Package consists of:
•
•
•
•
•
The LOGITECH Bus Mouse.
The Bus Board.
LOGITECH Mouse driver software on 51/4" disk.
LOGITECH Plus software on 5 1/4" disk.
The LOGITECH Mouse User's Manual,
the manual you are now reading.
The LOGITECH Series 2 Mouse
The LOGITECH Series 2 Mouse Package consists of:
•
•
•
The LOGITECH Series 2 Mouse.
LOGITECH Mouse Driver software and Plus software on a 3 1/2" disk.
The LOGITECH Mouse User's Manual,
the manual you are now reading.
x
Introduction
Other LOGITECH Products
At LOGITECH we pride ourselves on technical excellence and advanced engineering.
We also offer these fine products, which we believe to be the most advanced in their
product category.
LOGITECH Mouse Programmer's Toolkit (with software)
Contains information and guidelines for programmers who wish to develop
applications using the mouse and the standard mouse driver. Programming
interfaces are provided for Assembler, BASIC, C, Modula-2, and Pascal.
Note:
The Programmer's Toolkit does not address the problem of
interfacing the mouse directly through the serial port.
LOGITECH Mouse Technical Reference Manuals
Contain details about the LOGITECH Mouse electrical interface, data formats,
baud rates, and report rates.
LOGITECH Modula-2
LOGITECH Modula-2 offers these Modula-2 functions:
•
•
•
•
The LOGITECH Modula-2 base package, with tutorial, complete library
listings, and a post-mortem debugger, and a compiler that generates standard
DOS linker compatible. OBJ files.
The LOGITECH Modula-2 Toolkit, with the full-featured LOGITECH
Linker and a full complement of utilities to help you manage the
development and revision of your LOGITECH Modula-2 programs.
The Turbo-Pascal To LOGITECH Modula-2 Translator.
A VAXIVMS version of LOGITECH Modula-2.
Site licenses are available for all LOGITECH Modula-2 products.
For additional sales information, or to order these products, call the LOGITECH sales
office toll-free from anywhere in the continental U.S. at (800)231-7717, or
in California, call (800) 552-8885.
xi
Introduction
How to Read This Manual
The following conventions are used in this manual:
Keys to be pressed, look like this:
(Y)
[Esc}
QJ
Control sequences or characters entered with a Control or Shift key, look like this:
@ill-@]
(Ctrl HBreak]
( nShift
HF2)
00-0
Keys from the Numeric Keypad are shown like this:
(]]CDB5)
G
~~[±J
Keyboard input for the DOS Command line is in upper case and looks like this:
CLICK
QJ
Mouse buttons used are based on the LOG/TECH standard, and use three buttons, e.g,
(. 0 0 I means press the left mouse button,
[0 0 .) means press the right mouse button, and
(0 • D) means press the middle mouse button.
[• • ) means press both buttons on a two button mouse.
Variable names in the text are surrounded by angle brackets, as in
! .J
)
File names look like this:
MENU.EXE AUTOEXEC.BAT
DOS commands and statements look like this:
PATH,COPY
Product names look like this:
LOG/TECH Series 2 Mouse, DOS, Point & Click Shell
xii
Introduction
Reserved words and user-defined functions in LOG/MENU code look like this when
being discussed in the text:
CHORDS, BEGIN, MyFunction
These are not emphasized in screen display or program listings.
Screen output and some listings look like this when being discussed in the text:
Program Not Found
These are not emphasized in screen display or program listings.
LOG/MENU and other code listings look like this:
BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, 50, 100
LeftB:
MidB:
RightB:
TYPE ENTER
TYPE 3
TYPE ESC
LeftM:
RightM:
UpM:
DownM:
TYPE
TYPE
TYPE
TYPE
0,
0,
0,
0,
75
77
72
80
3 is CTRL-C
0,
0,
0,
0,
75
77
72
80
is
is
is
is
Left Arrow Key
Right Arrow Key
Up Arrow Key
Down Arrow Key
Sample Screens look like this:
open close HELP +next prev +WINDOW EDITING MOVING QUIT+ETC OPTIONS TOPLIST
xiii
Introduction
How this User's Manual is Organized
This manual assumes that you are somewhat familiar with the basics of DOS and with
basic programming concepts and terminology.
Beside this general introduction, this manual has four main divisions, or books:
•
•
•
•
An installation guide for the full LOGITECH Mouse line.
A user's guide to LOGITECH PLUS software
A user's guide to M123, the Point & Click Shell.
The POINT Editor User's Manual, with tutorial and reference chapters.
Each book/division is self-contained, with its own Table of Contents and Index. To
switch between books quickly, flex the manual to locate the black line where each
division begins.
Similarly, the pages in each division have a simple prefix at the bottom of each page, as
follows:
A-n
identifies the Installation division.
B-n
identifies the LOGITECH Plus Software division.
C-n
identifies the M123, Point & Click Shell division.
D-n
identifies the POINT Editor division.
xiv
Hardware Installation
Contents
Table of Contents
Introduction
A-I
Chapter I
LOGITECH Mouse Installation
A-3
1.1 The LOGI1ECH Serial Mouse ...................................................................... A-4
1.1.1 General Description .............................................................................. A-4
1.1.2 System Requirements and Compatibility .............................................. A-5
1.1.2.1 System Requirements ................................................................... A-5
1.1.2.2 LOGI1ECH Serial Mouse Compatibility ..................................... A-6
1.1.2.3 Connector Pin Assignments ......................................................... A-6
1.1.3 Install your LOGI1ECH Serial Mouse ................................................. A-7
1.2 The LOGI1ECH Bus Mouse ......................................................................... A-8
1.2.1 General Description .............................................................................. A-9
1.2.2 System Requirements and Compatibility .............................................. A-9
1.2.2.1 System Requirements ............................................................... ~ ... A-9
1.2.2.2 LOGI1ECH Bus Mouse Compatibility ........................................ A-9
1.2.3 Install your LOGI1ECH Bus Mouse .................................................. A-10
1.2.3.1 Configure Your Bus Board ......................................................... A-10
1.2.3.2 Install Your Bus Board ...............................................................A-12
1.2.3.3 Connect Your Mouse ..................................................................A-13
1.3 The LOGI1ECH Series 2 Mouse ................................................................. A-14
1.3.1 General Description ............................................................................. A-14
1.3.2 System Requirements and Compatibility ............................................A-15
1.3.2.1 System Requirements .................................................................A-15
1.3.2.2 LOGI1ECH Series 2 Mouse Compatibility ............................... A-15
1.3.3 Install your LOGI1ECH Series 2 Mouse ............................................ A-16
1.4 How to Hold the Mouse ............................................................................... A-17
a - iii
Contents
Appendix A
LOGITECH Mouse Maintenance
A-21
Appendix B
Product Support Plan
A-23
Copy Protection .................................................................................................. A-23
Technical Support ............................................................................................... A-23
LOGITECH Bulletin Board Service ............................................................. A-23
BIX ................................................................................................................ A-23
Getting Help from the Hotline ......................................................................A-24
Index
A-27
a - iv
Installation
Introduction
The LOG/TECH Mouse can be used directly with most applications or can be easily
programmed to work with others.
LOGITECH Mouse software configures your mouse for different software applications
and helps you build time-saving pop-up menus for those applications.
LOG/TECH Mouse drivers work with all applications that use the Microsoft mouse
driver.
Your LOGITECH Mouse is programmable. This means that, in addition to using your
mouse with most mouse-based applications, you can use it with ordinary keyboard cursor
based programs to move a point or cursor on your computer screen; the mouse buttons
can then be used to position data, create graphics, or select, copy, and edit text.
And because it's programmable, your LOGITECH Mouse also works with virtually any
application.
A-I
Installation
Notes:
A- 2
Installation
Chapter 1
LOGITECH Mouse Installation
This chapter tells you how to install your LOGITECH Mouse in an IBM PC/XT/AT
or compatible computer.
Section 1.1
covers the LOGITECH Serilll Mouse, which plugs into a serial port.
Section 1.2
covers the LOG/TECH Bus Mouse, which plugs into the bus board
and frees up your serial port.
Section 1.3
covers the LOG/TECH Series 2 Mouse, which plugs into the mouse
port on your IBM PS/2 computer.
Section 1.4
shows you how to hold the mouse for maximum ease of use.
A-3
Installation
1.1 The LOGITECH Serial Mouse
1.1.1 General Description
In addition to working with all applications that use the Microsoft mouse driver, the
LOGITECH Serial Mouse emulates other computer mice, including the earlier
LOGITECH C7 Mouse, the Mouse Systems Corporation PC Mouse, the Torrington
Manager Mouse, and the Visi-On Mouse. This means that, even if an application
doesn't list your LOGITECH Serial Mouse in the installation menu, if it lists one of
these other mice, your LOGITECH Serial Mouse will work.
Figure A·l LOGITECH Serial Mouse, 9·Pin Connector, and 9· to 25· Pin Adapter
A·4
Installation
1.1.2 System Requirements and Compatibility
Your LOGITECH Serial Mouse is designed for use with IBM PC/XT/AT or compatible
computers. It connects to your microcomputer system through a 9- pin or 25- pin
RS·232 serial port configured to COMI or COM2. You can use with either a dual
floppy disk system or one with one or more floppy disk drives and a hard disk.
1.1.2.1 System Requirements
Here are the system requirements for the LOGITECH Serial Mouse:
Personal
Computer
IBM PC, XT or AT,
IBM PS/2, Model 30, 50,60, 80 (through the serial port)
or other 100% IBM PC compatibles
Drives
Two disk drives, or a hard disk and at least one disk drive
Memory
256 KofRAM
Graphics
Adapter
Cards
Serial Port
IBM Monochrome Adapter
IBM Color Graphics Adapter
IBM Enhanced Graphic Adapter with Enhanced Color Monitor or
compatibles.
COMIorCOM2
Operating
System
IBM PC DOS or MS-DOS 2.0, or later
A-S
Installation
1.1.2.2 LOGITECH Serial Mouse Compatibility
The LOGITECH Serial Mouse driver works like the Microsoft Mouse driver with all
application programs that use the Microsoft Mouse. MOUSE.COM and MOUSE.SYS
from LOGITECH are functionally compatible with files of the same name from
Microsoft for the Microsoft Mouse. Applications that use the Microsoft driver usually
refer to it as the Microsoft Mouse driver, the Microsoft compatible mouse driver, or as
MOUSE.COM.
When you set your mouse driver to the appropriate protocol (5b) and baud rate (1200),
your LOGITECH Serial Mouse is fully compatible with PC Mouse from Mouse
Systems Corporation, Visi-On Mouse, and Torrington Manager Mouse.
1.1.2.3 Connector Pin Assignments
LOGITECH Serial Mouse comes with a standard RS-232C subminiature female
connector compatible with the IBM AT, and with a 9- to 25 pin adapter to make it
compatible with the IBM PCIXT.
Here are the connector pin assignments for the 9- to 25 pin adapter.
25-pin Connector
1
2
3
4
5
6
7
20
Data Signals
Protective Ground
Receive Data (To Mouse)
Transmit Data (From Mouse)
Request to Send
Clear to Send
Data Set Ready
Signal Ground
Data Terminal Ready
Figure A-2 9- to 25-Pin Adapter Pin Assignments
A-6
9-pin Connector
Shell
3
2
7
8
6
5
4
Installation
1.1.3 Install your LOGITECH Serial Mouse
Your LOGITECH Serial Mouse has a 9-pin RS-232 connector for IBM AT
compatibles t and a 9- to 25-pin adapter for connection to IBM PC/XT compatibles.
The procedure to attach either connector to the computer is the same:
Step 1: Switch your computer OFF and unplug all peripheral equipment.
Step 2: Locate the RS-232 Serial Port Connector 1 or 2 on the back of your computer.
Refer to the owners manual for your computer and/or to any documentation for
your add-in boards. This will normally be a "male" connector with pins sticking
out from the computer. Gently press the mouse connector into place and
tighten the screws.
r - - - - - - - - - - - - - NOTE - - - - - - - - - - - - - ,
Your LOGITECH Serial Mouse also works with a converter cable,
either 25- to 9-pin or 9- to 25-pin.
Step 3: Get ready to tum on your computer.
Reconnect any peripheral equipment and close your computer. If you had your
computer opent (to install a serial card etc.) close it and reconnect any peripheral
equipment. You are now ready to tum on your computer, install your mouse
driver software t and put your mouse to work.
If this is the first time youtve used a mouse tum first to Section 1.4, How to
Hold Your Mouse. If you are already familiar with a mouse product t .tum to
Book 2, LOGITECH Plus Software, for instructions on setting up your system
to work with the LOGITECH Plus software that comes with your LOGITECH
Mouse.
A-7
Installation
1.2 The LOGITECH Bus Mouse
08-9 Female
Connector*
Figure A-3 LOGITECH Bus Mouse, Bus Board, and Two Connector Types
A-8
Installa tion
1.2.1 General Description
The LOGITECH Bus Mouse supports all applications that use the Microsoft Mouse
driver. In addition, it can be programmed to use all three buttons for most applications
that do not specify their own mouse interface.
1.2.2 System Requirements and Compatibility
Your LOGITECH Bus Mouse is designed for use with computers that are 100% IBM
PC/XT/AT, and IBM PS/2 (Model 30) compatible computers. It connects to your
microcomputer system through a printed circuit board with either a 9-pin D-Ring,
or 9-pin Mini-DIN circular connector.
1.2.2.1 System Requirements
Here are the system requirements for the LOGITECH Bus Mouse:
Personal
Computer
IBM PC, XT or AT,
IBM PS/2, Model 30
or other 100% IBM compatibles
Drives
Two floppy drives, or one floppy and a hard disk.
Memory
256 KofRAM
Graphics
Adapter
Cards
IBM Monochrome Adapter
IBM Color Graphics Adapter
IBM Enhanced Graphic Adapter
with Enhanced Color Monitor or compatibles.
Expansion
An open Slot for the Bus Board.
Operating
System
PC DOS or MS-DOS 2.0, or later
1.2.2.2 LOGITECH Bus Mouse Compatibility
The LOGITECH Bus Mouse driver works like the Microsoft Mouse driver with all
application programs that use the Microsoft Mouse. MOUSE.COM and MOUSE.SYS
from LOGITECH are functionally compatible with files of the same name from
Microsoft for the Microsoft Mouse. Applications that use the Microsoft driver usually
refer to it as the Microsoft Mouse driver, the Microsoft-compatible mouse driver, or as
MOUSE.COM.
A-9
Installation
1.2.3 How to Install Your LOGITECH Bus Mouse
Your LOGITECH Bus Mouse has two components to install: a Bus Board and a Mouse.
First, install the Bus board; then, connect your mouse.
1.2.3.1 Configure Your Bus Board
Step 1: Remove the Bus Board from its Antistatic Protection Packaging
The Board is shipped in this packaging for protection from static electricity. To
protect the Bus Board while you are installing it in your computer, avoid manual
contact with electrostatic substances such as plastic or styrofoam.
Step 2: Find the position of the Bus Board components.
a8
2 345
1_1_1-
Jump 1 (IRQ Jumper)
=-=II
III•
III-• I• _11
- _ ii
••
Figure A-4 LOGITECH Bus Board with Typical Jumper Setting
A ·10
Installa tion
Step 3: Set the Jumpers on your Bus Board.
Set the jumper on your Bus Board to be compatible with your computer.
The following tables show correct settings for the type of computer you have:
Computer
Use
Don't use
IBM AT
IBM PC
IBMXT
5
2
2
2
5
5
, - - - - - - - - - - - Optional Settmgs
Here are the interrupts that can be used by the LOGITECH Bus Mouse.
Notice: IRQ3 is normally used by COM2, and IRQ4 by COMI. Avoid
these interrupts if you are using either COM port on your computer.
Interrupt Setting
IBM AT
2
3
extended interrupt
unused
COM2
COM1
Printer #2
COM2
COM 1
4
5
IBMPC/XT
Fixed Disk
The Bus Board is set at I/O address 23C to 23F.
Determine the correct configuration for your computer. Then place the jumper
clip on the appropriate pin pair for your system, as shown in Figure A-4, above.
A-II
Installation
1.2.3.2 Install Your Bus Board
After you set the jumper, install the Bus Board in the expansion slot in your computer.
Before you install your LOGITECH Bus Board you must prepare your computer.
Step 1: Turn your computer OFF.
Make sure the system unit power switch is OFF. To be sure, disconnect the
power cord and all other cables from the back of your system unit.
Step 2: Remove the cover from your system unit.
Consult the user manual for your computer on installing add-in boards.
Step 3: Locate a free expansion slot in your computer.
Jfyou are not sure which slot to use, consult the user manual for your computer.
For example, slot 8 is reserved on the IBM PCIXT.
Step 4: Insert the Board in your computer.
Make sure that the gold-striped bottom edge of the Board sits firmly in the
expansion slot groove and that the bracket of the Board is in the groove which
previously held the slot cover.
A ·12
Installation
1.2.3.3 Connect Your Mouse
To connect the LOGITECH Bus Mouse to your Bus Board:
Step 1: Check to make sure that the the computer is OFF
Step 2: Secure mouse cable connection.
Locate the 9-pin connector on the back of your Bus Board and gently press the
Bus Mouse connector in place.
If you have a D-ring connector, tighten the screws on the sides of the cable
connector to secure it.
If you have a circular Mini-DIN connector, simply plug it in.
If this is the first time you've used a mouse turn first to Section 1.4, How to
Hold Your Mouse. If you are already familiar with a mouse product, turn to
Book 2, LOGITECH Plus Software, for instructions on setting up your system
to work with the LOGITECH Plus software that comes with your LOGITECH
Mouse.
Figure A-5 Alternate Cable Connectors
A -13
Installation
1.3 The LOGITECH Series 2 Mouse
1.3.1 General Description
Your LOGITECH Series 2 Mouse is designed for use with all models of IBM PS/2
or compatible computers. It plugs directly into the mouse port and emulates the
IBM PS/2 Mouse. You can use it with either a dual floppy system or with a hard disk.
Figure A·6 LOGITECH Series 2 Mouse and 6·pin Connector
A·14
Installation
1.3.2 System Requirements and Compatibility
1.3.2.1 System Requirements
Here are the system requirements for the LOGITECH Series 2 Mouse:
Personal
Computer
IBM PS/2, Model 30, 50, 60, 80
or other 100% IBM PS/2 compatibles
Drives
Two disk drives, or a hard disk and at least one disk drive
Memory
256 K of RAM
Graphics
IBM Monochrome Adapter
Adapter Cards IBM Color Graphics Adapter
IBM Enhanced Graphic Adapter
with Enhanced Color Monitor or compatibles.
Port
PS/2 dedicated mouse port
Operating
System
PC DOS or MS-DOS 2.0, or later
1.3.2.2 LOGITECH Series 2 Mouse Compatibility
The LOGITECH Series 2 Mouse driver works like the IBM PS/2 Mouse driver with all
application programs that use the IBM PS/2 Mouse. MOUSE.COM and MOUSE.SYS
from LOGITECH are functionally compatible with files of the same kind from IBM for
the IBM PS/2 Mouse.
A-IS
Installation
1.3.3 Install your LOGITECH Series 2 Mouse
Your LOGITECH Series 2 Mouse comes with a 6-pin Mini-DIN connector that
connects to the mouse port on your IBM PS/2 computer. To connect your mouse:
Step 1: Switch your computer OFF.
Step 2: Find the mouse port on your IBM PS/2 computer.
Consult the system documentation for the location of the mouse port on the
model you are using.
Step 3: Plug in your LOGITECH Series 2 Mouse.
Check the orientation of the plug and receptacle. The Mini-DIN connector will
fit securely and easily.
If this is the first time you've used a mouse tum first to Section 1.4, How to
Hold Your Mouse. If you are already familiar with a mouse product, tum to
Book 2, LOGITECH Plus Software, for instructions on setting up your system
to work with the LOGITECH Plus software that comes with your LOGITECH
Mouse.
A-16
Installation
1.4 How to Hold the Mouse
Before you actually run your mouse software and start using your mouse, make sure you
are well-situated for using your mouse. Place the mouse near your keyboard. The
LOG/TECH Mouse doesn't need a special pad or grid - just a few inches of clear desk
space.
Figure A-7 Holding Your LOGITECH Mouse
Position the mouse with the cable pointing away from you. The cord should move freely
when you move the mouse.
Now, feel how the mouse moves on your working surface.
•
•
•
•
•
Hold the mouse in a relaxed manner, with your thumb and little finger at either
side of the mouse.
Place your index, middle, and ring fingers above the three mouse buttons.
For a two-button mouse, use your index and middle fingers on the two buttons.
Rest your wrist naturally on the desk surface.
To move the mouse, let your hand pivot from the wrist.
Be relaxed and use a light touch.
Now go to the next division and install your LOG/TECH Mouse software.
A-I7
Installation
Notes:
A-IS
APPENDICES
Notes:
LOGITECH Mouse Maintenance
Appendix A LOGITECH Mouse Maintenance
The LOG/TECH Mouse has been tested for 1,000 miles of continuous use with no
deterioration in any of its functions. It will continue to run well beyond 1,000 miles and
will perform optimally for longer than most people require over a period of years.
Figure A-8 How Your Mouse is Assembled
Recommended Cleaning Procedure
The LOG/TECH Mouse has a self-cleaning ball-cage mechanism that prevents a buildup
of dust or lint around the ball or the tracking mechanism in normal conditions.
If you need to clean the ball of dust or lint:
Step 1: Switch your computer OFF.
Step 2: Turn the mouse upside down.
A- 21
Appendix A
Step 3: Remove ball housing cover.
Turn the ball housing cover counterclockwise to remove.
Step 4: Remove the ball.
Step 5: Clean the ball.
Use tap water, or tap water and a mild detergent. Use a clean, lint-free cloth to
dry the ball.
Step 6: Remove remaining dust or lint.
Blow into the ball cage to remove remaining dust or lint.
Step 7: Put the ball back into the mouse.
Step 8: Replace cover.
Fit ball housing cover over ball and turn clockwise until it locks.
A- 22
Product Support Plan
Appendix B Product Support Plan
Remember to send in your product registration card. It qualifies you as being
eligible for customer support, and helps us keep you current with update and other
important product information.
Copy Protection
LOGITECH software is not copy-protected. This doesn't mean you can make unlimited
copies. LOGITECH software is covered by the copyright laws that protect computer
software. It is illegal to make copies of the contents of these disks, except for your own
backup, without written permission from LOGITECH, Inc. In particular. it is illegal to
give a copy to another person.
Technical Support
LBBS
We know that effective communication with our customers is the key to quality service.
Therefore we have set up the LBBS (LOGITECH Bulletin Board Service), an
electronic bulletin board where you can contact us at your convenience, 24 hours a day,
seven days a week.
To logon to the LBBS, dial:
(415) 795-0408
using a 300, 1200 or 2400 baud modem.
The menu of available options is self explanatory.
BIX
LOGITECH also sponsors an electronic conference on BIX, the Byte Information
EXchange system from Byte magazine. If you have access to BIX, join us in the
LOGITECH conference, and communicate with us there.
A-23
AppendixB
Getting Help through the Hotline
You should be able to rely on your manual or your dealer to answer questions about
using your package. If you do encounter a technical problem with your package, our
Technical Support Specialists will be glad to help you.
We ask you to follow these steps before you call or write.
•
Read the section of the manual that describes the procedure you are trying to perform.
•
If the problem relates to your software, check to make sure that the software is
properly configured.
•
Please include the following information in your letter, or have it in front of you when
you phone.
•
•
•
•
•
Mouse type and serial number
LOGITECH software type and serial number
LOGITECH Mouse driver version
DOS version
Hardware and peripherals used
Contents of your AUTOEXEC.BAT file, if any
Contents of your CONFIG.SYS file, if any
Any RAM resident programs used (Sidekick, Superkey, etc.)
If, after following these steps, you are still not able to solve the problem, give us a call at
(415) 795-0427, or write to us. If you write, please include your daytime phone number
and the best time to reach you. Also, please add "Attn: Technical Support" somewhere
on the envelope.
We want to help you make the most effective use of your package.
A-24
INDEX
Installation Index
c
M
Compatibility, Hardware, 5, 9, 15
Microsoft Compatibility, 6
Mouse Compatibility, 6, 9
Compatibility, Software, 5,9, 15
Compatibility,
Mouse Systems Corporation PC Mouse, 4, 6
Compatibility, Manager Mouse, 4,6
Compatibility, Vision Mouse, 4, 6
Compatibility, Microsoft Mouse, 4, 6
Compatibility, mM PS/2 Mouse, 15
s
System Requirements and Compatibility, 5,9,15
D
DOS and your mouse, 5,7, 9
RS-232, 5,7
COM1,5,ll
COM2,5,ll
J
Jumper settings, 10, 11
L
LOGlTECH Bus Mouse, 8-13
LOGlTECH Serial Mouse, 4-7
LOGlTECH Series 2 Mouse, 14-16
LOGlTECH Mouse Maintenance, 21
Cleaning Procedure, 22
A-27
Installation Index
Notes:
A- 28
LOGITECH PLUS Software
Contents
Table of Contents
Introduction
B-1
The IN"STALL Program ........................................................................................B-l
MOUSE.COM and MOUSE.SYS ......................................................................... B-2
The LOGIMENU Menu Generator .......................................................................B-2
CLICK Mouse Control ..........................................................................................B-2
Chapter 1
Getting Started
B-3
1.1 Back Up Your LOGITECH Mouse Disks ......................................................B-4
1.2 IN"STALL, the Mouse Installation Program ...................................................B-5
Chapter 2
Mouse Drivers
B-7
2.1 Time-Saving AUTOEXEC.BAT Commands ................................................ B-8
2.2 LOGITECH Serial Mouse - Special Parameters ......................................... B-9
Chapter 3
Using LOGIMENU
B-13
3.1 Menus Supplied by LOGITECH .................................................................. B-14
3.2 How to Build Your Own Menus .................................................................. B-15
3.3 A LOGIMENU TutoriaL ..............................................................................B-17
3.3.1 The EXTYPE Program.: ......................................................................B-18
3.3.2 The EXBEGIN" Program ......................................................................B-21
3.3.3 The EXEXECUT Program .................................................................. B-24
3.3.4 The EXCHORDS Program .................................................................. B-25
3__ 3.5 The EXMENU Program ......................................................................B-27
3.3.6 The EXPOPUP Program .....................................................................B-29
b • iii
Contents
3.4 LOGIMENU Reference ................................................................................... 31
3.4.1 LOGI1ffiNULanguage ........................................................................... 31
3.4.2 Extended ASCII Code ............................................................................. 32
3.4.3 Color in LOGI1ffiNU Programs ............................................................. 34
3.4.4 LOGI1ffiNU Syntax ................................................................................ 36
3.5 Advanced LOGI1ffiNU Programs ...................................................................41
Chapter 4
CLICK Mouse Control
4.1
4.2
4.3
4.4
43
How to Run CLICK .........................................................................................44
Click Sensitivity Control ..................................................................................45
Add Serial Mouse Applications to CLICK ..................................................... .46
CLICK Commands ...........................................................................................49
Chapter 5
Popular Mouse Applications
5.1
5.2
5.3
5.4
5.5
51
Applications with No Set-Up Procedures ........................................................ 51
Programs That Use the LOGITECH Mouse .................................................... 54
Definition Files for Other Applications .......................................................... .55
If Set-Up Procedures Are Needed .................................................................... 56
Installing Applications ..................................................................................... 57
5.5.1 LOGITECH Serial Mouse .......................................................................57
5.5.2 LOGITECH Bus Mouse .......................................................................... 58
5.5.3 LOGITECH Series 2 Mouse ................................................................... 58
b· iv
Contents
Chapter 6
General Installation Notes
59
6.1 Automatic Installation ...................................................................................... 59
6.2 AutoCAD ........................................................................................................ 60
6.3 CADVANCE .................................................................................................... 61
6.4 FrameWork II ...................................................................................................61
6.5 GEM .................................................................................................................61
6.6 Generic CADD .................................................................................................62
6.7 PC PaintBrush ................................................................................................. 62
6.8 Symphony .......................................................................................................63
6.9 Ventura Publisher .............................................................................................63
6.10 Windows .......................................................................................................64
6.11 Microsoft Word .............................................................................................64
Appendix A
Mouse Status Messages
67
Appendix B
Mouse Command Language
71
LOGITECH PLUS Index
75
b-v
Contents
Notes:
b - vi
Introduction
Introduction
LOG/TECH PLUS software provides the programmed intelligence to transform your
LOG/TECH Mouse from a simple pointing device into an easy-to-use desktop tool that
can move your workload as fast as you can think.
A simple installation program gets you ready. Next, mouse driver software gets you
running. And then you are ready to run the two programs that are a major key to
productivity - two programs that help your mouse to keep track of applications with
speed and accuracy - LOG/MENU and CliCK.
The INSTALL Program
INSTALL is the first program your LOG/TECH Mouse will use. It tests your mouse to
determine whether it is working and what kind of mouse it is; it then establishes the
"handshaking " ritual that lets it talk to your computer screen. For example, if you are
using a LOG/TECH Serial Mouse, it finds out whether to use COMI or COM2 to
communicate with your microcomputer system.
B-1
Introduction
MOUSE.COM and MOUSE.SYS
MOUSE.COM or MOUSE.SYS driver software contains the standard interface
instructions between an application and your mouse. It tracks mouse position, gets data
from the mouse buttons, and displays a text cursor or graphics pointer on screen, based
on information from your mouse and your application.
LMOUSE.DRV, a driver for Microsoft Windows, is also included. This driver may be
more recent than the driver in the Windows package. For information on updating your
Windows driver, refer to Section 6.9.
The LOGIMENU Menu Generator
MENU, the LOGIMENU program lets you write mouse procedures for non-mouse
(keyboard cursor-key based) applications. LOOIMENU lets you tell the mouse buttons
how to perform functions that would take several steps on the keyboard, it assigns menu
options to difficult-to-remember keystrokes, and simplifies the way you move around in
your application.
LOGIMENU command language, lets you build a file with a .DEF extension that tells
your mouse how to perform. Then you compile the .DEF program with the NEWMENU
compiler. This produces a file with the same prefix, and an extension of .MNU. This
.MNU file can then either be run as a single parameter to the MENU command, or it can
be listed with the other .MNU files in the CLlCK.SRC file to be ready to use whenever
you run the CLICK program.
Several working examples of these .DEF and .MNU files along with complete
instructions on how to build your own menus are fully described in Chapter 3.
CLICK functions as the control center for the LOGITECH Mouse with your application
software. It sets operating parameters for the mouse and selects a menu designed for
your application from among either the standard application . MNU files or those you
construct with the LOGIMENU Menu Generator.
You can use CLICK as it comes, already configured for many popular applications; or
you can add your own applications and menus to the list in CLlCK.SRC, to customize
your LOGITECH Mouse for other application software.
B-2
Getting Started
Chapter 1
Getting Started
~-------------------------NOTE--------------------------~
Before you install your software to either floppy drive or hard disk system,
we strongly recommend that you take a few minutes to:
1)
Put Write-Protect tabs on all your LOG/TECH diskettes.
2)
Use DISKCOPY and DISKCOMP from your DOS version to back up
your diskettes. Then put your original diskettes in an archival area and use
the copies for all installation.
3)
If you are using a dual disk floppy system, prepare formatted disks with
readable labeling, before you copy the files in the Installation procedure
which follows.
4)
Read the READ.ME file on your LOG/TECH diskette, for last minute
information that may not have been available when this manual was sent to
the printer.
B-3
Chapter 1
1.1 Back Up Your LOGITECH Mouse Disks
If You are Using a Dual Floppy Computer:
Step 1: Insert your DOS diskette in drive A. At the A> prompt, type:
DISKCOPY A: B: QJ
Step 2: Follow the instructions on the screen. Insert your LOGITECH Mouse (source)
diskette in drive A, and a blank (target) diskette in drive B.
PressQJ.
If You are Using One Floppy Disk and a Hard Disk:
Step 1: At the DOS A> prompt or c> prompt, type,
DISKCOPY A: A: QJ
Step 2: Follow the instructions on your screen. The source is your LOGITECH Mouse
diskette, and the target is a blank diskette.
If you are using 5 1/4" disks, note that:
•
•
LOGITECH Mouse Driver Disk is labeled Disk 1.
LOGITECH Mouse Plus Disk is labeled Disk 2.
Ifyou are using 3 1/2" disks, note that:
•
Both Driver Disk and Plus Disk are on one disk labeled Plus Package.
B-4
Getting Started
1.2 INSTALL, the Mouse Installation Program
These instructions tell how to install your software onto either a floppy drive or hard disk
system. Instructions on screen tell you how to proceed.
If You are Using a Dual Floppy Disk Computer:
Step 1: At the A> prompt insert LOGITECH Mouse Disk #1 into drive A (if you are
using 3 1/2 " disks there is only one disk to install), and type:
INSTALLQ]
Step 2: Read the rest of the information on the screen and follow the instructions.
If You are Using One Floppy Disk and a Hard Disk Drive:
Step 1: At the c> prompt insert LOGITECH Mouse Disk #1 into drive A (if you are
using 3 1/2 " disks there is only one disk to install), and type:
A:INSTALLQ]
Step 2: Read the rest of the information on the screen and follow the instructions.
B-S
Chapter 1
Notes:
B-6
Mouse Drivers
Chapter 2
Mouse Drivers
Two versions of the mouse driver are provided in the LOG/TECH Mouse software.
Both programs are functionally similar - you can use either one.
MOUSE.COM is the standard driver. It can be used by itself on a command
line, or made part of an AUTOEXEC.BAT file.
MOUSE.SYS is the alternate driver. It conforms to the DOS standard for
installable device drivers. To use MOUSE.SYS, one (but not both) of these
lines must appear in a CONFIG.SYS file on your DOS disk:
DEVICE=MOUSE.SVS
DEVICE=MOUSE.SVS 12
for all LOGITECH Mice, except
(for the Serial Mouse, on COM2)
I NOTE]
For information about modifying your CONFIG.SYS file, refer to your DOS
manual.
B-7
Chapter 2
2.1 Time-Saving AUTOEXEC.BAT Commands
When your installation is complete, you may want to add some commands to your
AUTOEXEC.BAT file in DOS to automatically load the mouse driver and the menu
driver each time you start the computer. (Refer to your DOS manual for instructions on
creating or modifying an AUTOEXEC.BAT file.) Make the following additions to your
AUTOEXEC.BAT file.
During software instailation, you may be asked to create a file named GOMOUSE.BAT.
To display the contents of GOMOUSE.BAT, type,
TYPE \GOMOUSE.BAT
QJ
GOMOUSE.BAT contains command lines that you can add to your AUTOEXEC.BAT
file that will automatically load the mouse driver and the menu driver each time you start
your computer. Refer to your DOS manual for instructions on creating and modifying an
AUTOEXEC.BAT file.
If you do not want to use the gomouse.bat file, you can add the following to your
AUTOEXEC.BAT file:
\DIRNAME\MOUSE
\DIRNAME\MENU
\DIRNAME\CLICK
where \DIRNAME is the directory where you have installed your mouse software. The
default directory created by install program is \MOUSE. Remember also to add the
directory name to your PATH statement as displayed in the GOMOUSE.BAT file.
If you are running your mouse with a DEVICE=MOUSE.SYS statement in your
CONFIG.SYS file, you can still use your AUTOEXEC.BAT file to run Logitech Plus
software automatically when you start your computer. Remember to include the PATH
statement that locates the corresponding files in your system. Then add these commands
to your AUTOEXEC.BAT file.
MENU
CLICK
B-8
Mouse Drivers
2.2 LOGITECH Serial Mouse - Special Parameters
If your computer has limited memory, you can set parameters manually instead of listing
them in the CLICK file. However, if you do not use CLICK, you will need to do this
manually each time before you call an application. The parameters for this are described
in Chapter 4. Here are the settings:
COM
Port
Baud
Rate
Report
Rate
1 *
2
1200
2400 *
4800
9600
10
20
35
50
70
100
* 150
or continuous
Buttons
Used
Protocol
2k
3k *
* LOG/TECH Serial Mouse default setting.
** Protocol abbreviations:
3b:
Three byte packed binary
5b:
Five byte packed binary
(default power-up without driver,
Mouse Systems Corporation PC Mouse compatible)
Ab:
Absolute bit pad one
He:
Hexadecimal
Mm:
MMSeries (default with driver)
Re:
Relative bit pad one
The command and parameters for the mouse driver are:
MOUSE [COM Port #] [Baud Rate] [Report Rate] [(I of buttons) k] [Protocol] (?)
B -9
**
3b
5b
Ab
He
Mrn*
Re
Chapter 2
The following steps explore this capability.
Step 1: Change to the drive and directory that has your mouse software and type:
MOUSE
1GD
Step 2: On the screen, you'll see the current mouse parameters. These are the default
parameters identified by an * (asterisk) in the previous table.
r NOTE - - - - - - - - - - - - - - - - - - - - - - - - ,
If you change parameters, you can list them in any order:
after MOUSE (if your mouse is using COM1), or
after MOUSE 2 (if your mouse is using COM2).
If you omit a parameter, it will not be changed. The mouse driver will
maintain the last set value, usually the default setting.
Step 3: Your LOGITECH Serial Mouse can imitate a Mouse Systems Corporation
PC Mouse:
If your LOGITECH Serial Mouse is using the COM1 serial port, type,
MOUSE 1200 58 150
GD
If it is using COM2, type,
MOUSE 2 1200 58 150
GD
Step 4: To check the new mouse parameters, type,
1I11"11~~
IVIV"".., ....
,,1'"iI
I~
Step 5: To restore the mouse to its default parameters, type,
MOUSE
INITGD
Step 6: To be sure the default settings are working, type,
MOUSE
1GD
By following Steps 1 through 3, you can manually set new parameters on your mouse to
make it work with a particular application.
Refer to Appendix B for a summary of mouse command language.
B ·10
Mouse Drivers
NOTE
If the application you are using tells you to install the LOG/TECH Serial Mouse as a
Mouse Systems Corporation PC Mouse or compatible mouse, make sure you set the
mouse driver to this mode.
Option A:
Copy MSC.BAT from Disk #1 to your mouse directory.
Type MSCGD.
Run the application that uses the Mouse Systems PC Mouse.
Option B:
Use the command, MOUSE PC GD
Option C:
Enter the mouse specifications for the application in your CLlCK.SRC
file and use NEWCLICK to generate a new CLlCK.EXE file. See
Section 4.3.
If the applications does not list support of the LOG/TECH Serial Mouse, but does list
the Mouse Systems Corporation PC Mouse or compatible, you can still use one of the
above-mentioned options.
B -11
Chapter 2
Note:
B ·12
Using LOGIMENU
Chapter 3
Using LOGIMENU
LOG/MENU lets you use your mouse with software not originally designed for mouse
use.
You can use LOG/MENU to create "pop up menus" that you can call onto your screen
while you're using your application. A LOG/TECH Mouse pop up menu will give you
options that you can select with the mouse.
You can also use LOG/MENU to define precisely how the mouse moves and how you
want the mouse buttons to function.
We have provided you with several working examples of LOG/MENU files that you can
either copy and alter for your own purposes, or use as prototypes for menus that more
closely meet your needs.
Once you create a menu source file (using a a word processor or editor), with an
extension name of .DEF, you compile that file with the NEWMENU Compiler.
This creates a new file with a format that can also be recognized by the CLICK Mouse
Control system; this file has an extension of .MNU.
B -13
Chapter 3
3.1 Menus Supplied by LOGITECH
A number of useful menus are already supplied on the LOGITECH Mouse diskette.
These are listed with .DEF extensions .
.DEF files are LOGIMENU programs or menus that must be compiled before they can
be used. See the next section for instructions on how to create and compile LOGIMENU
programs and menus.
To compile the menu for VP-Planner from Paperback Software, type
NEWMENU VP
QJ
If you do not have this menu already loaded in your CLICK file, then to load the menu
for VP-Planner, type:
MENU VP
W
You will see a message telling you that the Pop Up Menu is loaded. Now you can
proceed to load VP-Planner by typing
VPW
On Microsoft Menu Compatibility - - - - - - - - . . . . ,
Microsoft Menu Source files can be compiled by NEWMENU. Do not use
MENU directly with a .MNU file made by Microsoft's MAKEMENU utility.
B -14
Using LOGIMENU
3.2 How to Build Your Own Menus
LOGIMENU programs involve simple programming. LOG/MENU is designed to make
this process simple and straightforward, for beginners and experienced programmers.
A LOGIMENU program tells the mouse what to do. This chapter shows how to write
these simple programs. To create LOGITECH Mouse programs and menus, you
perform the following steps:
Step 1: Use the POINT Editor or the nondocument mode of a word processing program
like WordStar to write a LOGIMENU program .DEF, where
is the same name as the .EXE or .COM file.
Step 2: After you save your file and return to DOS, type:
NEWMENU
GD
(without the .DEF extension)
NEWMENU compiles your menu so that you can use it. You do not need to
specify the .DEF extension when you compile your menu.
Step 4: If there are no errors, your menu is compiled and ready to use.
If NEWMENU does finds error in your program, it will not compile. If this
happens, refer to Appendix A for an explanation of the error message. Return
to the .DEF file and make the corrections. Then start over at Step 2.
r - - - - - - - - - - On Microsoft Menu Source Files - - - - - - - - - - ,
When compiling a .DEF file that was intended for a Microsoft two-button mouse,
the (~ .) option is replaced by the (0 0 .). If you want it replaced by (0 • 0 ) ,
simp y add the /lrm option to the NEWMENU command, like this:
NEWMENU /Irm
GD
B ·15
Chapter 3
Once a LOG/MENU program or menu has been compiled, it can be called up by typing:
MENU Q]
See Chapter 4 for instructions on how to modify CLICK so that applications menus will
be loaded automatically by the system .
. - - - - - - - - - - - - - - NOTE - - - - - - - - - - - - - - - ,
For very large Menu Files: The menu driver has a default limit of 5000 bytes.
To produce a larger .MNU file, load MENU with a larger capacity. To do so,
start MENU but add / where is a number of thousand bytes, up to 20.
For Example:
MENU /11
GO
reserves 11,000 bytes (11 Kb) for the menus to be used.
This option is valid only when you first activate MEN U.
B -16
Using LOGIMENU
3.3 A LOGIMENU Tutorial
This tutorial shows you how to create six common LOGIMENU programs and menus.
It explains the LOGIMENU language and how each program works. Key terms in
LOGIMENU language are underlined the first time they are mentioned, and are defined
in Section 3.4.
Before beginning the tutorial, perform the following steps:
If You are Using a Dual Floppy Disk Computer -
Copy NEWMENU.EXE to a blank, formatted diskette.
"practice diskette" for the tutorial.
This will be your
If You are Using One Floppy Disk and a Hard Disk -
Create a new working directory. Your new directory will be where you will do
your practice work throughout the tutorial. For more information on managing
directories refer to your DOS manual.
Get acquainted with the POINT Editor At LOGITECH, we use the POINT Editor for all our program development.
Even newcomers here are pleased and surprised at how easy it is to learn. You
may find this an ideal time to also begin learning the POINT Editor.
Differences Between Listings and Disk Files - - - - - - . . . . ,
Your LOGITECH Mouse diskette contains the files for all programs and menus
covered in this chapter. Some file listings may be different.
. - - - - - - - - - (. 0 0) and (. 0 .) in Menu Listings - - - - - - - . . . . ,
The examples covered in this tutorial addresses both 3-button and 2-button mice.
With a two-button mouse such as the IBM PS/2 compatible LOGITECH Series 2
Mouse, MidB means both buttons; CHORD statements are disabled. (0 • 0) for
a 3-button mouse is equivalent to ( • • ) for a 2-button mouse.
B -17
Chapter 3
3.3.1 The EXTYPE Program
EXTYPE programs the LOGITECH Mouse buttons to perform the DOS TIME, DATE,
and VERsion functions.
To create EXTYPE:
Step 1: Open a file named EXTYPE.DEF.
Step 2: On line 1, type:
BEGIN LeftB, MidB, RightB W .
Step 3: Enter a blank line by pressing
W .
Step 4: On line 3, type:
LeftB:
TYPE "TIME", ENTER, ENTER W
.
Step 5: On line 4, type:
; This calls the TIME command without changing the time W
Step 6: Enter a blank line by pressing
.
W .
Step 7: On line 6, type:
MidB:
TYPE "DATE", ENTER, ENTERW.
Step 8: On line 7, type:
; This calls the DATE command without changing the date W
Step 9: Enter a blank line by pressing
.
W .
Step 10: On line 9, type:
RightB:
TYPE "VER", ENTERW.
Step 11: On line 10, type:
; The VER command gives you the DOS version numberW.
Step 12: Your screen should match the listing in Figure B·l.
Step 13: Make needed corrections, and save the file on your practice diskette or in your
working directory. Return to your DOS prompt.
B ·18
Using LOGIMENU
Step 14: Compile EXTYPE. Type.
NEWMENU EXTYPE
0
Step 15: If NEWMENU finds an error in your program, it will not compile. If this
happens, refer to Appendix A for an explanation of the error message. Then
repeat Steps 12 through 14.
If N EWM EN U finds no errors, it compiles your program. The program is ready
to use. Now click each mouse button in tum.
Step 16: Press each mouse button and see what appears on the screen.
SEGIN LeftS, MidS, RightS
LeftS:
TYPE "TIME", ENTER, ENTER
; This calls the TIME command without changing the time
MidB:
TYPE "DATE", ENTER, ENTER
; This calls the DATE command without changing the date
RightS: TYPE "VER" , ENTER
; The VER DOS command gives you the DOS version number
Figure B-1 The EXTYPE Program
B -19
Chapter 3
How EXTYPE Works
EXTYPE starts with a BEGIN statement:
BEGIN LeftB, KidB, RightB
The BEGIN statement assigns LABELS to mouse buttons:
LeftB = [.00)
MidB = 10.0]
RightB
=
[00.)
These same labels are also listed near the left margin of your program.
When you press a mouse button, your program looks for the label that matches it. Then
it performs the action listed next to that label.
This means that when you press [. 0 0), EXTYPE looks for the label LeftB and
performs the action next to it. The action here is a TYPE statement:
TYPE "TIME", ENTER, ENTER.
This causes the program to type the word TIME and to "press" the QJ key twice. This
causes DOS to display the time.
In a TYPE statement, you must put quotation marks around a word you want to be
typed as a word. Because ENTER in the listing is not in quotation marks, EXTYPE
interprets it as QJ .
Three lines of your program start with a ; (semicolon). Those lines are comments. A
COMMENT is a note you make to yourself that makes the program clearer when you or
someone else goes back to see what you wanted to do and how you planned to do it.
LOGlMENU ignores any information following a semicolon up to the end of the line.
B -20
Using LOGIMENU
3.3.2 The EXBEGIN Program
EXBEGIN programs the mouse buttons to perform specific functions and detennines
how mouse movement affects the cursor. Here, you will make the mouse buttons
simulate CD , @!ill-@] , and ( Esc). Your program will make the cursor move when
the mouse moves 50/200" horizontally or 100/200" vertically. To create EXBEGIN:
Step 1: Open a file named EXBEGIN.DEF.
Step 2: On line 1, enter:
BEGIN LeftB, MidS, RightB, LeftM, RightM, UpM, DownM, 50, 100
Step 3: Enter a blank line by pressing CD .
Step 4: On lines 3 through 5, enter:
LeftB:
MidB:
RightB:
TYPE ENTER
TYPE 3
TYPE ESC
3 is CTRL-C
Step 5: Enter a blank line by pressing CD •
Step 6: On lines 7 through 10, enter:
LeftM:
RightM:
UpM:
DownM:
TYPE
TYPE
TYPE
TYPE
0,
0,
0,
0,
75
77
72
80
0,
0,
0,
0,
75
77
72
80
is
is
is
is
Left Arrow Key
Right Arrow Key
Up Arrow Key
Down Arrow Key
Step 7: Your screen should match Figure B-2. Make corrections, if necessary.
Step 8: Save the file on your practice diskette or in your working directory.
Step 9: To generate EXBEGIN.MNU from your EXBEGIN.DEF file, enter:
NEWMENU EXBEGINCD
Step 10: If NEWMENU finds any error in your program, it will not compile, and will
display an error message. If this happens, see Appendix A for an explanation of
the error message. Then repeat Steps 7 through 9.
If NEWMENU finds no error, your program is compiled and ready to use. Now
move the mouse and click each mouse button in tum.
Step 11: See how the mouse controls movement of the cursor on the screen. Observe the
function performed by each mouse button.
B -21
Chapter 3
SEGIN LeftS, MidS, RightS, LeftM, RightM, UpM, DownM, 50, 100
LeftS:
MidS:
RightS:
TYPE ENTER
TYPE 3
TYPE ESC
3 is CTRL-C
LeftM:
RightM:
UpM:
DownM:
TYPE
TYPE
TYPE
TYPE
0,
0,
0,
0,
0,
0,
0,
0,
75
77
72
80
75
77
72
80
is
is
is
is
Left Arrow Key
Right Arrow Key
Up Arrow Key
Down Arrow Key
Figure B-2 The EXBEGIN Program
How EXBEGIN Works
The EXBEGIN program starts with a BEGIN statement.
BEGIN LeftB,
~dB,
RightB, LeftM, RightM, UpM, DownM, 50, 100
BEGIN starts by labeling mouse buttons.
LeftB
(_ 0 oj
~dB
(O_oj
RightB
(00 _j
BEGIN also labels mouse movements:
LeftM
(movement left),
UpM (movement up), and
DownY (movement down).
Seven labels are listed at the left-hand side of your program. Each click of a mouse
button or movement of the mouse tells the program to look for the label that corresponds
to that mouse button or that movement.
Note:
Any label can be used to name a mouse button and its movement, as long as
matching labels are listed down the left-hand side of the program.
B - 22
Using LOGIMENU
In a BEGIN statement LOGIMENU always recognizes these labels:
t
Item one
Item two
Item three
Item four
Item five
Item six
Item seven
[_DO]
t
[0_0]
(00_)
t
t
t
t
t
t
movement left
movement right
movement up
movement down.
This means that when you press (_ 0 0] your program first looks for the label LeftB.
Then it performs the action listed next to that label. The EXBEGIN program executes an
t
0·
When you move the mouse to the right a similar chain of events occurs. Your program
looks for the label RightM. Then it performs the action listed next to that label: TYPE
0, 77. The numbers 0, 77 are ASCII code for the
cursor key. When the mouse
moves to the right, your program executes (~) and the cursor moves to the right. (More
ASCII codes are listed in Section 3.4.2).
t
(3
The eighth and ninth items in the BEGIN statement refer to the sensitivity of the mouse
or how far the cursor will move when you move the mouse on the work surface. The
eighth item indicates the mouse's horizontal sensitivity. The ninth item indicates the
mouse's vertical sensitivity.
t
In EXBEGIN, the number SO indicates that when you move the mouse
horizontally, LOGIMENU registers a move to the left or right.
50/200"
The number 100 indicates that when you move the mouse 100/200" vertically,
LOGIMENU registers a movement up or down.
In other words, if you move the mouse less than 50/200" horizontally or 100/200"
vertically, no action is registered.
(NOTEI
If items eight and nine are not included in the BEGIN statement the LOGITECH
t
Mouse will use its default values: 4 and 8.
B ·23
Chapter 3
3.3.3 The EXEXECUT Program
EXEXECUT programs the mouse buttons to display the directory for the current drive,
drive A, and drive B. EXEXECUT shows you how to "chain" a sequence of commands,
which is useful in programs with long statements. To create EXEXECUT:
Step 1: Create EXEXECUT.DEF as it appears in Figure B-3.
Step 2: Compile EXEXECUT. Type,
NEWMENU EXEXECUTGD
If N EWM EN U finds errors in your program, it will not compile. If this
happens, see Appendix A for an explanation of the error message. Then correct
the file and repeat this step.
Step 3: If N EWM EN U finds no errors, then your program compiles and is ready to use.
Click each mouse button in tum.
BEGIN
LeftB,
MidB,
RightB
LeftB:
MidB:
RightB:
EXECUTE TDIR, TRETURN
EXECUTE TDIR, TSPACE, TA, TRETURN
EXECUTE TDIR, TSPACE, TB, TRETURN
TDIR:
TSPACE:
TA:
TB:
TRETURN:
TYPE "DIR"
TYPE""
TYPE "A:"
TYPE "B:"
TYPE ENTER
Figure B-3 The EXEXECUT Program
How EXEXECUT Works
EXEXECUT starts with a BEGIN statement that labels the mouse buttons. A mouse
button click sends program control toa label and does what that label says to do.
An EXECUTE statement here sends program control to a combination of additional
labels: TDIR, TSPACE, TA, TB, and TRETURN. Each of these labels triggers a
TYPE statement. Combinations of labels create different final messages.
In !0 • D), for example EXEXECUT finds MidB and the EXECUTE statement next
to it. EXECUTE then sends the program to a sequence of four labels: TDIR, TSPACE,
T A and TRETURN. These in tum trigger TYPE statements that come together as:
DIR A:GD.
B -24
Using LOGIMENU
3.3.4 The EXCHORDS Program
EXCHORDS is a program for a three-button LOG/TECH Mouse. It sets mouse button
combinations to perform certain functions. These combinations ([ • • 0 j , [. 0 .j ,
[0 • • j , and [• • • j ) are called CHORDS. Here, each CHORD causes a line of type
identifying the chord to appear on the screen, after which the CHORD will cancel its
action by sending a @!ill{Q) .
INOTEl
Chords do not apply to a two-button mouse, since [ • • j replaces [0 • 0 j .
To create the EXCHORDS program:
Step 1: Create EXCHORDS. DEF as it appears in Figure B-4.
Step 2: To compile EXCHORDS.DEF, type,
NEWMENU EXCHORDS
GD
When NEWMENU finds no errors in EXCHORDS.DEF, it is compiled and
ready to use.
Step 3: See how each button combination displays a different message on the screen. If
your message is different than what you have pressed, check your listing.
BEGIN
CHORDS LMB, LRB, MRB, ALLB
; 3 stands for CTRL-C, canceling the input
LMB:
LRB:
MRB:
ALLB:
TYPE
TYPE
TYPE
TYPE
"Left and Middle Buttons Pressed", 3
"Left and Right Buttons Pressed", 3
"Middle and Right Buttons Pressed", 3
"All Three Buttons Pressed", 3
Figure B-4 The EXCHORDS Program
B -25
Chapter 3
How EXCHORDS Works
The EXCHORDS starts with an empty BEGIN statement and a CHORDS statement
that labels the mouse button chords:
LMB
LRB
MRB
ALLB
!__ o)
!_o_)
!o __ )
(---)
When you click one of these combinations, EXCHORDS looks in the program for the
appropriate label and performs the action next to it.
Suppose you press [ __ 0]. The program finds the label LMB and performs the TYPE
statement next to it:
TYPE "Left and Middle Buttons Pressed", 3
[;iJ
This types
Left and Middle Buttons Pressed
on the screen.
Then it types the ASCII code
3
which causes the program to cancel by executing @fill-@] .
In this EXCHORDS, each chord executes a@fill-@] as its final action. You can easily
""nA,f" th"" .t'.&.vO""
1"\?'nl"M"~"" h.., ""h,,t't"t'nrr ",th.o.. A Cf"'TT ,.",rI.oco 4='.."'....,. tho +".'h1.o 'n Cnn4-:""Mo ~ II "
..u .... VJ
&.1.1\..1
..
'&&'&"'''''''A£.J
W.l.V
~uu...,u."UU.,1I·6
VI,.l.l.V.l. ~"""""'&'.L ...,VU"'., .&..I.V.lIJ.
B ·26
Lall.l.\.I 1.11 tJ~"' J.UU . . , . , . . . .
Using LOGIMENU
3.3.5 The EXMENU Program
EXM EN U creates a menu on your screen and then programs mouse buttons and button
chords to perform certain functions related to the menu. Here, a click of any mouse
button or chord displays the menu. Then, by moving the mouse, you can highlight any
of the menu options. Any single button click then selects the highlighted option, while a
chord click cancels the menu.
To create EXMENU:
Step 1: Create EXMENU.DEF as it appears in Figure B-S.
Step 2: Compile EXMENU. Type,
NEWMENU EXMENU
GO
If there are no errors, EXM EN U. DE F is compiled and ready to use.
Step 3: Click any mouse button or mouse button chord to display the menu and click
any chord to remove the menu from the screen.
With the menu on the screen, move the mouse to highlight your selection. Click
any mouse button to select a highlighted menu option.
BEGIN menul, menul, menul
CHORDS menul, menul, menul, menul
menul:
MENU "title", 8, 30, BOLD
OPTION "DIR - LIST DIRECTORY", dir
OPTION "PRINT file(s)", print
OPTION "CHKDSK - check disk", chkdsk
OPTION "RENAME file", rename
MEND
dir:
print:
chkdsk:
rename:
TYPE
TYPE
TYPE
TYPE
"DIR", ENTER
"PRINT"
"CHKDSK", ENTER
"RENAME"
Figure B-S The EXMENU Program
B -27
Chapter 3
How EXMENU Works
EXM EN U starts with a BEGIN statement:
BEGIN menul, menul, menul
This makes each mouse button call for label menul.
The CHORDS statement,
CHORDS manul, menu 1 , rr.anul, manul
also programs each chord, or mouse button combination, to call the label menul.
The line next to the label menul defines the menu.
menul: MENU "Title", 8, 30, BOLD
Titles in quotation marks appear on the screen as the menu titles.
The first number, 8, defines the line number at which the menu appears.
The second number, 30, defines the column number at which the menu appears.
The word BOLD says to display the characters on screen in bold. You can also choose
NORMAL or INVERSE, or a number to indicate a color code (see your graphics
adapter manual).
The next four lines are OPTION statements. The words in quotation marks appear as
menu options:
DIR - LIST DIRECTORY,
PRINT file(s),
CHKDSK - Check Disk
:RENAME file
The word at the end of each line is the label that the Opti9n will look for. MEND -- the
MEND statement -- ends the menu definition.
EXMENU works like this: When you click a mouse button to select an option, you also
select a label. The program goes to that label and performs the action next to it.
Suppose, for example, that you select CHKDSK - check disk. This selects the label
chkdsk. The program finds this label and performs the action next to it, ie. it executes
CHKDSKQJ.
B·28
Using LOGIMENU
3.3.6 The EXPOPUP Program
EXPOPUP creates a pop-up menu on your screen. It is similar to EXMENU, but allows
you much more flexibility in design of the menu. Menu items may be positioned
anywhere on the screen, not just one below the other.
EXPOPUP also programs the mouse buttons and chords to perform certain functions. A
click calls the menu. A click also selects a highlighted option.
To create the EXPOPU P program:
Step 1: Create EXPOPUP.DEF as it appears in Figure B·6.
Step 2: Compile EXPOPUP.DEF. Type,
NEWMENU EXPOPUP
QJ
When NEWMENU finds no errors in EXPOPUP.DEF, it is compiled,
generated, and ready to use.
Step 3: Click any mouse button or chord to display the pop up menu. Then click any
chord to remove the menu from the screen.
Step 4: With the pop up menu on screen, move the mouse to highlight an option. Click
a mouse button to select the highlighted option.
BEGIN popup1, popup1, popup1
CHORDS popup1, popup1, popup1, popup1
; WARNING: The following line is a comment
; 123456789012345678901234567890123456789012345678901234567890
popup1:
POPUP 12, 20, NORMAL
TEXT" DIR - LIST DIRECTORY
PRINT file(s}
TEXT " CHKDSK - check disk
RENAME file
SELECT 1, 3, 20, dir
SELECT 1, 26, 13, print
SELECT 2, 3, 19, chkdsk
SELECT 2, 26, 11, rename
PEND
dir:
print:
chkdsk:
rename:
TYPE
TYPE
TYPE
TYPE
"DIR", ENTER
"PRINT"
"CHKDSK", ENTER
"RENAME"
Figure B-6 The EXPOPUP Program
B - 29
Chapter 3
How EXPOPUP Works
EXPOPUP starts with a BEGIN statement and a CHORDS statement that causes any
click to call the menu with the label popupl.
On line four, the line next to the label popupl defines the menu you create:
popup1: pOPUP 12, 20, NORMAL
The numbers 12 and 20 define where the pop-up menu appears - at line 12, column 20.
NORMAL defines the properties of the menu characters as having normal type.
Lines that begin with semicolons are comments which the program does not read. The
numbers help you count characters and spaces so that you can enter other information.
The next two lines of EXPOPUP are TEXT statements. The words in quotation marks
appear as options in the menu exactly as they are arranged and spaced in the listing.
The quotation marks indicate the outer edge of the menu.
The four SELECT statements tell the program what to do when you select an option.
Each SELECT statement consists of three (3) numbers and a label.
The first number is the menu line on which the option appears. The option
DIR - LIST DIRECTORY appears on line 1 of the menu, so the number is 1.
The second number is the column number of the menu at which the option begins. This
is where the numbers you used in the comment line help.
The option DIR - LIST DIRECTORY begins at column 3, so the number is 3.
The third number is the length of the option, counting both characters and spaces.
ForDIR - LIST DIRECTORY, that number is 20.
PEND - the PEND statement - ends the pop-up menu definition.
When you highlight an area of the menu and click a selection, the program matches the
parameters of that selection with these numbers.
DIR -
LIST DIRECTORY, for example, sends control to SELECT 1, 3, 20, dire
The program then goes to the label dir listed at the left and performs the action next to
it. In this case, it executes:
DIRQJ.
B -30
Using LOGIMENU
3.4 LOGIMENU Reference
This section provides a reference to LOGIMENU language and syntax.
3.4.1 LOGIMENU Language
Key terms in the LOGIMENU language are described in the following table.
Term or
Statement
Definition
ASSIGN
Assigns new behavior to mouse buttons and movements.
BACKSP
TYPE function statement; simulates ( f - Back) .
BEGIN
Defines function of mouse buttons at the start of a program.
CHORDS
Defines a function of combinations of mouse buttons.
;
Not read by the program. ; (semicolon) precedes the comment
ENTER
TYPE function statement; simulates
ESC
TYPE function statement; simulates ( Esc I .
EXECUTE
Chains together a sequence of commands.
Name assigned to a statement or statements.
MATCH
Defines a string on the screen; sends the program to one label
if the condition exists and to another if it does not.
MEND
Ends a menu definition.
OPTION
Lists a menu option.
PEND
Ends a pop up menu definition.
SELECT
Corresponds to a pop up menu selection.
TEXT
Lists text line of pop up menu.
TYPE
Sends characters and commands as if typed from a keyboard.
B ·31
0 .
Chapter 3
The following table lists extended ASCII codes that can be used with a TYPE statement.
3.4.2 Extended ASCII Code
Meaning
Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
@!ill-0
(Ctrl )-(]J
@!ill@
@@([)
@!illffi
@!ill-(£)
@@-@J
@!ill-(BJ
@@-OJ
@@-QJ
@Iill-(EJ
CQ!ill{g
@ill{0
@!ill-@
@!ill-@)
@!ill-®
@!ill-@]
@!ill-(ID
@!ill-@]
@!ill-(!)
@@-(ill
@!illffi
0,15
[llShift H -.1 ]
0,59
(ill
Ale.:
rA'it'
ri=\)
~
V,OV
A
[F2)
[Ctrl!®
@!ill-0
@!ill-{])
@!ill-(I)
V,J.V
0,17
0,18
0,19
0,20
0,21
0,22
0,23
0,24
0,25
0,30
0,31
0,32
0,33
0,34
0,35
0,36
0,37
0,38
0,44
0,45
0,46
0,47
0,48
0,49
0,50
Meaning
OO®
00ffi
OO®
(][)ffi
OO{Y)
@@
oo-cD
@@
OO®
CID-0
OO®
OO@
@ill
OO@
@(BJ
rAftl{J1
OO{KJ
oo-cg
oom
CID0
@@J
00-0
[ID([)
@®
~
B -32
Code
Meaning
Code
,A
0,61
0,62
0,63
0,64
0,65
0,66
0,67
0,68
0,71
0,72
0,73
0,74
0,75
0,77
0,78
O}9
0,80
0,81
0,82
0,83
[F3]
[F4]
[FS]
[F6]
lID
[Fa)
[F9]
IF1O)
[Home]
CD
~
G
8
B
CD
IEndl
~
CD
~
~
[Del]
Using LOGIMENU
Code
Meaning
Code
Meaning
0,84
0,85
0,86
0,87
0,88
0,89
0,90
0,91
0,92
0,93
0,94
0,95
0,96
0,97
0,98
0,99
0.100
0,101
0,102
0,103
0,104
0,105
0,106
0,107
0,108
0,109
0,110
0,111
0,112
0,113
[ 1tShift HF1 ]
[1tShift H F2]
[1tShift H F3]
[ 1tShift HF4 ]
[ 1tShift H FS]
[1tShift H FS)
0,114
0,115
0,116
0,117
0,118
0,119
0,120
0,121
0,122
0,123
0,124
0,125
0,126
0,127
0,128
0,129
0,130
0,131
0,132
0,133
0,134
0,135
0,136
0,137
0,138
0,139
0,140
[ Ctrl HPrtSc I
I1tShift HF7]
I1tShift H Fa)
I1tShift H F9)
I1tShift HF1 0 ]
@!ill{ffi
I CtrlH F2]
I CtrlH F3]
[CtriH F4]
[CtriH FS]
[CtriH FS]
[Ctrl HF7]
[CtriH Fa]
I Ctrl H F9]
[CtriH F10]
(][}{Ii]
~
CIDillJ
~
OO@
CIDillJ
00illJ
~
~
(][}(ill)
B -33
[CtrltEl
[Ctrlt5]
ICtrl HEnd 1
~
[ Ctrl HHome 1
(][)-GJ
00-0
oo-@J
OOGJ
(]D@J
(][}ill
000
OO®
(][}®
~
CID-O
(][}G
~
CITD
[F12]
(1tShift H F11 ]
[ 1tShift H F12]
@!ill-CITD
(Ctrl HF12]
[ID-(£DJ
oo-rIill
Chapter 3
3.4.3 Color in LOGIMENU Programs
A color monitor lets you have menus in color as well as menus in black and white. The
MENU command in the LOGIMENU Definition file, lets you set the color with the last
parameter. The syntax is:
MENU , , ,
The fourth parameter may be a number ranging from 0 to 255. You can calculate the
number, using the tables below:
=
(Text Colors) + (Background/Bar Colors) + (Blink On/Off)
Text Colors
. Value
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Menu Text Color
Selected Text Color
Black
Blue
Green
Cyan
Red
Magenta
Brown
White
Dark Gray
Light Blue
Light Green
Light Cyan
Light Red
Light Magenta
Yellow
Intensified White
White
Orange
Magenta
Red
Cyan
Green
Blue
Black
Intensified White
Yellow
Magenta
Light Red
Light Cyan
Light Green
Light Blue
Dark Gray
B -34
Using LOGIMENU
Background/Bar Colors
Value
+0
+16
+32
+48
+64
+80
+96
+112
Background Color
Selection Bar Color
Black
Blue
Green
Cyan
Red
Magenta
Brown
White
White
Orange
Magenta
Red
Cyan
Green
Blue
Black
Blink On/Off
Value
Blinking Menu and Selected Text
Text is NOT Blinking
Text IS Blinking
+0
+128
Example
Refer to Section 3.3.5 and, if you have a color monitor, change the BOLD attribute in the
menu syntax to:
Text Colors =
Background Base =
Blink on/off =
Color Number =
10
0
128
Light Green on Magenta
Black on White
Blinking Text
138
And the new statement is
MENU "title", 8,30,138
B·35
Chapter 3
3.4.4 LOGIMENU Syntax
The syntax of LOGIMENU statements is diagramed below, where:
L is a label, the name associated with statement or statements
N isanumber
Statements That Define Mouse Buttons and Movements
BEGIN Statement
BEGIN has three (3) labels that indicate each mouse button, four (4) labels that indicate
mouse movement, and two (2) numbers that indicate how much movement is needed to
trigger the specified action.
BEGIN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, HSen, VSen
(L)
(L)
(L)
(L)
(L)
(L)
(L)
(N)
(N)
I
I
I
I
I
I
Labels for button
actions
I
I
I
I
I
I
Labels for mo~
movements
Number for horizontal sensitivity
Number for vertical sensitivity
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
CHORDS Statement
CHORDS has four (4) labels that tell what to do with each chord, or combination of two
or more keys. Chords is only applicable on a three- button mouse.
CHORDS LMB, LRB, MRB, ALLB
(L)
(L)
(L)
(L)
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
for ( _ _ _ )
I
I _Label
I
for (0 __ )
I _ _ _Label
Label for
I- 0_)
Label for (_ -
B -36
0)
Using LOGIMENU
ASSIGN Statement
ASSIGN is the dynamic version of BEGIN. It lets you re-initialize for new situations.
label:
ASSIGN LeftB, MidB, RightB, LeftM, RightM, UpM, DownM, HSen, VSen
(N)
(N)
(L)
(L)
(L)
(L)
(L)
(L)
(L)
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
Labels for button
Labels for mouse
I
I
actions
movements
I
I
I
I
Number for horizontal sensitivitY _____________ 1
I
Number for vertical sensitivitY____________________
1
How to Generate Input Characters
TYPE Statement
TYPE generates characters as if they were typed at the keyboard.
label: TYPE
I
I
This can be a sequence of any of the following,
separated by commas:
"string"
character number
0, extended ASCII code number
ENTER
BACKSP
ESC
TAB
EXECUTE More Than One Statement
EXECUTE defines a sequence of statements to be executed, so that more than one action
can be executed for a mouse/menu action.
label: EXECUTE label, label,
•..
I
I
I _____ I __ (L) Statements to be executed in sequence
B -37
Chapter 3
MENU, OPTION, and MEND for a One-Column Menu
MENU, OPTION, and MEND statements define and produce a menu that will stay on
the screen until a mouse button is clicked (a mouse button chord will cancel the menu).
When one mouse button is clicked to select a menu item, the associated label is executed
and the menu disappears. There can be approximately 20 OPTION statements, which is
close to the number of lines that can appear on the screen.
label: MENU "Title", VPos, l:lB-os, Attribute
I
I'
I
I
I
I
I
I_NORMAL/INVERSE/BOLD/nurnber
I
I
I
I
I
I_Column number of upper left corner
I
I
I
I_Line number of upper left corner
I
I
Menu title string, to appear on the top line
-(optional, but keep the comma)
OPTION "Item", label
I
I
(L) Statement executed if menu item is chosen
_String to appear on the menu
MEND
I
I
MEND statement to end menu definition
B -38
Using LOGIMENU
POPUP, TEXT, SELECT, and PEND for a Free-Format Pop-Up Menu
As with the one-column menu, the pop-up menu will stay on until a mouse button is
clicked to select an item, or until the menu is canceled by using a chord. With the
POPUP, TEXT, SELECT, and PEND statements, you can build a menu with more
than one column and with items that are not necessarily aligned. SELECT statements
define the possible mouse selections.
label: POPUP VPos, HPos, Attribute
I
I
I
I
I
I __NORMAL/INVERSE/BOLD/number
I
I (N) Column number of upper left corner
(N) Line number of upper left corner
TEXT "string"
I
I String line to appear on the menu
--(you choose the layout)
SELECT VPos, HPos, Width, label
I
I
I
I
I
I
I Statement to be executed if
I
I
I
the item is chosen
I
I
I
(N) Number of characters of the
I
I
item
I
I
(N) Column number (inside the menu) of
I
the item
I
(N) Line number (inside the menu) of the item
I
PEND
I
I __PEND statement to end pop-up menu definition
B - 39
Chapter 3
MATCH Checks for Something on the Screen
Actions can be made context-sensitive by checking for the presence of certain signals
from the application. For example, in most spreadsheet applications, a mode string or a
prompt appears to indicate what is expected as input. The MATCH statement allows
such checking.
label:
MATCH VPos, HPos, Attribute, "string", label, label
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
(L) Statement to be
executed if there is
no match
(L) Statement to be executed
- - - i f there is a match
String to be matched on the screen
NORMAL/INVERSE/BOLD/number/nothing
--attribute to match
(optional, but leave comma)
(N) Screen column number where the match
--should start
(N) Screen line number where the match should start
B -40
Using LOGIMENU
3.5 Additional LOGIMENU Programs
Once you master LOG/MENU. there are two additional programs you might want to
create or modify: EXASSIGN and EXMATCH.
The EXASSIGN Program
The listing for EXASSIGN is in Figure B-7. The program assigns different modes to
the mouse. With EXASSIGN. your LOGITECH Mouse can work as a normal mouse. a
reverse mouse. a speedy mouse. or a slow mouse.
BEGIN Menul
Menul:
MENU "EXASSIGN.MNU", 5, 20, NORMAL
OPTION "Normal Mouse", Normal
OPTION "Reverse Mouse", Reverse
OPTION "Speedy", Fast
OPTION "Slow", Slow
MEND
NormalMouse: ASSIGN Menul,MidB,RightB,LeftM,RightM,UpM,DownM,4,8
ReverseMouse: ASSIGN RightB,MidB,Menul,RightM,LeftM,DownM,UpM,4,8
FastMouse:
ASSIGN" " '"
1, 1
SlowMouse:
ASSIGN " " ' "
500, 500
MidB:
RightB:
TYPE ENTER
TYPE ESC
LeftM:
RightM:
UpM:
DownM:
TYPE
TYPE
TYPE
TYPE
0,
0,
0,
0,
75
77
72
80
0,
0,
0,
0,
75
77
72
80
is
is
is
is
Le ft Arrow Key
Right Arrow Key
Up Arrow Key
Down Arrow Key
Figure B-7 The EXASSIGN Program
B -41
Chapter 3
The EXMATCH Program
The listing for EXMATCH is in Figure B-S. EXMATCH programs the mouse to act one
way in a certain situation and a different way in another. Here, the program looks in a
certain position on the screen to find the letters ABCDE. If it finds them, it displays the
first of two screens. If it does not find the letters, it displays the second screen. On the
second screen, one of the options is to call for the letters ABCDE to appear in the exact
position on the screen where they were supposed to be.
BEGIN CheckMatch
CheckMatch:
MATCH 3, 1, , "ABCDE", Matching, Notmatching
Matching:
POPUP 3, 30, NORMAL
**u
TEXT ,,** ABCDE now appears on this line
TEXT
Select:
*"
TEXT ,,*
*"
CLEAR SCREEN
CANCEL
TEXT "*
*"
TEXT "*******************************************,,
SELECT 4, 7, 14, ClearScreen
SELECT 4, 30, 8
PEND
ClearScreen:
TYPE "CLS", ENTER
Notmatching:
POPUP 3, 30, BOLD
TEXT ,,** ABCDE does not appear on this line **11
TEXT ,,*
Select:
*"
TEXT ,,*
*"
TEXT ,,*
GET ABCDE TO APPEAR CANCEL
*"
TEXT "*******************************************"
SELECT 4, 6, 21, GetString
SELECT 4, 32, 8
PEND
GetString: TYPE "CLS", ENTER, "ECHO ABCDE", ENTER
Figure B-S The EXMATCH Program
B -42
CLICK Mouse Control
Chapter 4
CLICK Mouse Control
CLICK Mouse Control is a small program that stays "resident" in your computer's
memory. Then, when a program requires special mouse settings or menus, CLICK
automatically makes sure things are correctly set up.
With CLICK, your LOG/TECH Mouse reaches its full potential as a multimode mouse.
CLICK lets you move freely from task to task without resetting the mouse for each
separate application.
For mouse-based applications, CLICK configures mouse hardware so an applications that
needs the mouse can read the signals the mouse sends. CLICK is configured for many
popular applications. For the current list see Section 4.4.
For non mouse-based applications, CLICK loads the available LOG/MENU
specifications from a .MNU file. When the .MNU files are not present, you can create
one with LOG/MENU for insertion into the CLlCK.SRC file.
Thus, you can easily customize CLICK to automatically install your LOG/TECH Mouse
with virtually any program you use.
B -43
Chapter 4
4.1 How to Run CLICK
To load CLICK into your computer, type:
CLlCKGD
~---------------------n(N~O~TTE~]----------------------~
You may prefer to insert CLICK in the AUTOEXEC.BAT file of your DOS disk
so that it is loaded automatically each time you start your computer. Refer to
Chapter 2.
CLlCK.SRC is a list of application names and parameters that automatically sets the
mouse to work with different applications and also loads the appropriate menus.
In CLlCK.SRC, applications are called by the names of their .EXE or .COM file. The
command to set LOGITECH Mouse parameters then consists of the application's .EXE
or .COM name followed by a list of relevant parameters.
TopView, for example, is referred to as TV for TV.EXE. The following line sets the
mouse to function at 1200 baud, 150 reports/second, and 5 bytes (packed binary
protocol):
TV 1200 150 5b
The command to load LOGIMENU consists of the application's .EXE or .COM name
followed by the word "MENU," thus:
MENU
For example, the command in CLlCK.SRC to load the menu for VP-Planner is:
VPMENU
To see which application programs are supported by CLICK, look at the file
CLlCK.SRC with a word processor, with the POINT Editor, or with a DOS TYPE
command.
B -44
CLICK Mouse Control
If your application is listed in CLlCK.SRC, then every time CLICK is loaded, it
automatically sets the mouse and the appropriate menu.
If your application is not currently listed in CLlCK.SRC and the mouse requires special
settings or the use of a LOG/MENU menu, see the Section 4.3.
4.2 Click Speed/Sensitivity Control
This feature lets you change the sensitivity of the mouse by holding down the (
and
em
keys and then clicking either (0 0 .) or (. 0 D) on the mouse to speed up or slow
down the movement of the cursor on the screen.
Ctrl )
For a faster, more sensitive mouse, press
~DD.)
For a slower, less sensitive mouse, press
~.DD)
To reset mouse sensitivity to its default value, press
~ 0 • D) (not available with the LOG/TECH Series 2 Mouse)
In all cases, the computer will respond"with a beep. The pitch of the beep will give you
an idea of current sensitivity: the mouse becomes faster at the higher pitch and slower at
the lower pitch.
This sensitivity control feature is extremely useful for handling the mouse within certain
applications.
You can run an application at your own tempo, and increase
sensitivity/speed at your own rate. Many applications even let you change the
sensitivity/speed within the session.
B -45
Chapter 4
4.3 Add Serial Mouse Parameters to CLICK
CLICK can work automatically with your applications by adding a line for each
application to the CLlCK.SRC file. The line you add refers to your application by its
.EXE or .COM file name, and then either lists appropriate parameters, or calls the menu.
A CLlCK.SRC entry is written in the style described in the previous section and
specifies any of the information in the following table.
COM
Port
Baud
Rate
1 *
2
1200
2400*
4800
9600
*
**
***
****
Report
Rate
10
20
35
50
70
100
* 150
or
continuous
Buttons
Used
Protocol
**
MENU
***
****
2k
3k *
3b
5b
Ab
He
Mm*
Re
If the word "MENU"
comes after the
application name, the
corresponding menu
will be loaded.
LOGITECH Serial Mouse default setting.
Protocol abbreviations.
MENU is the only active parameter for a LOGITECH Series 2 Mouse.
MENU and 2buttons or 3buttons are the only active parameters
f'"... u'" h.,('O
..... ".,('Ot1 ""nf1tTl1"'!lOt1nn
uu.;, &1.J.vu';''v '""v ............. o ........ ""....."" ••.
.LV.&.
Baud Rate
(Serial Mouse)
The number of information bits exchanged per second between the
mouse and the computer.
Report Rate
Number of times per second that the mouse reports to the computer.
(Serial Mouse)
Buttons Used
(3 Button
mouse only)
Buttons on the mouse. For some applications, it is convenient to
define a two-button mouse. In such cases, (0 _ 0 1 functions
as (_ -Ion a two-button mouse.
B -46
CLICK Mouse Control
Protocol
(Serial Mouse)
3b:
5b:
Ab:
He:
Mm:
Re:
Refers to the data format and baud rate used by the serial mouse to
communicate with your computer.
Three byte packed binary
Five byte packed binary
(default at power-up without driver, Mouse Systems Corp. PC Mouse
compatible)
Absolute bit pad one
Hexadecimal
MMSeries (default with driver)
Relative bit pad one
The user's manual for your application may identify the parameters to set for your
application to work with a mouse. If it doesn't, the LOG/TECH Mouse should work if
you define it as either a Microsoft Mouse or a Mouse Systems Corporation PC Mouse.
When you load the LOG/TECH Mouse driver with any parameters, it will work like a
Microsoft Mouse driver.
If you want your LOG/TECH Serial Mouse to emulate a Mouse Systems Corporation
PC Mouse, set the following parameters in the CLlCK.SRC file:
1200 150 5b
~---------------------n[N~O~TTE~I-------------------------~
If a parameter is not entered (such as the number of mouse buttons in the above
example), then that parameter stays at its default value. Refer to the preceding
chart for mouse parameter default values.
B ·47
Chapter 4
To add a new application and its parameters to CLICK:
Step 1: Open the CLlCK.SRC file for editing.
This can be done with the POINT Editor or with the nondocument mode of a
word processing program like Microsoft WORD.
Step 2: Add a line in the CLlCK.SRC file that includes the .EXE or .COM file name of
the application followed by a list of the parameters to use with that application.
MENU is
the only active parameter for a LOGITECH Series 2 Mouse.
and 2buttons or
mouse configuration.
MENU
3buttons
are the only active parameters for a bus
(NOTE)
In the following example, part of the line is a comment. Comments are
notes you make to yourself that make an entry clearer when you read it
later. All comments begin with a semicolon. When CLICK reads the
CLlCK.SRC file, it ignores any information following a semicolon.
This line in CLICK sets LOGITECH Serial mouse parameters for TopView:
TV 1200 150 Sb
; TopView (IBM)
CLICK will then change to these parameters automatically when you load
TopView. In this example, the parameters are used to configure the serial
mouse to emulate a Mouse Systems Corporation PC Mouse.
Step 3: Save your revised CLlCK.SRC file.
Step 4: At the DOS prompt, type:
NEWCLlCKW
NEWCLICK uses CLlCK.SRC to update CLlCK.EXE and also revise the
version of CLICK that is currently resident in memory. Each time you start
your application, CLICK automatically loads the current mouse parameters.
B ·48
CLICK Mouse Control
4.4 CLICK Commands
You can control CLICK with the following commands from your DOS prompt:
NEWCLICK
Reads revised CLlCK.SRC file and updates CLICK.
CLICK OFF
Switches CLICK OFF until you type CLICK ON. Use in
troubleshooting to see whether a problem is
in CLICK or in MENU. Does not take CLICK out of
memory.
CLICK ON
Switches CLICK ON.
CLICK PATH
Shows the PATH used by CLICK to find the menu files.
Notice that this is the PATH that was in effect when CLICK
was loaded.
CLICK QUIET
Switches CLICK VERBOSE OFF.
CLICK VERBOSE
CLICK displays the full name of all programs when they are
executed.
B -49
Chapter 4
Notes:
B -SO
Popular Mouse Applications
Chapter 5
Popular Mouse Applications
This chapter tells you how to manage your applications with the CLICK Menu Control
system.
5.1 Applications with No Set-Up Procedures
Mter you connect your LOG/TECH Mouse and install the mouse software, experiment
with the installation procedure for the application program that you will be using. In
many cases, you can install and use the mouse with your application with no additional
external setup.
(NOTE)
The procedures on this section are not necessary if you have modified your
AUTOEXEC.BAT file to load MOUSE, MENU, and CLICK automatically.
B·51
Chapter 5
With a Dual Floppy System:
Step 1: At the A> prompt, remove the DOS disk.
diskette in drive A. Type:
Insert the LOGITECH Mouse
MOUSEW
If your LOGITECH Serial Mouse is using COM2, type:
MOUSE2W
Eiiher command loads the Mouse Driver into memory.
Step 2: Now type:
MENUW
This puts the LOGIMENU Menu Generator into memory.
Step 3: Type:
CLlCKW
This loads CliCK Mouse Control into memory.
Step 4: Remove the LOGITECH Mouse disk and insert your program disk in drive A.
At the A> prompt, type the name of your application.
B - 52
Popular Mouse Applications
With a One Floppy Disk and a Hard Disk Drive:
Step 1: Load the mouse driver.
For a LOG/TECH Serilll Mouse connected to COM1, a Bus Mouse, or a
LOG/TECH Series 2 Mouse, at the DOS prompt, type:
MOUSEW
If your LOG/TECH Serilll Mouse is using COM2, then type:
MOUSE2W
Step 2: Load the LOGIMENU driver and CLICK.
Type:
MENUW
Type:
CLlCKW
Step 3: Run your application program.
If no further settings are necessary, the calls to CLICK and MOUSE put your
mouse to work with your application. Move the mouse and experiment with it.
If there is a LOG/MENU program for your application, calls to CLICK and MENU let
you:
•
Call the application menu with a mouse button.
•
Choose menu options:
Move the mouse to highlight a screen option.
Click a mouse button to select the option.
•
Cancel the menu with a chord click
(two or more mouse buttons pressed at the same time).
After you do the steps in this section, if the mouse works automatically with your
application, then you are ready to go. If not, read the next section.
B -53
Chapter S
5.2 Programs That Use the LOGITECH Mouse
CLICK Mouse Control is configured to handle mouse settings automatically for the
following applications.
AutoCAD - (registered trademark of Autodesk)
Generic CADD - (trademark of Generic Software)
Cadkey - (registered trademark of Micro Control Systems)
Cadvance - (trademark of CalComp)
DesqView - (trademark of QuarterDeck Office Systems)
DotPlot - (trademark of Generic Software)
Drajix - (trademark of Foresight Resource)
Dr Halo II- (registered trademark of Media Cybernetics)
EE-Designer - (trademark of Visionics)
IBM Drawing Assistant - (trademark of IBM)
IBM DisplayWrite 4 - (trademark of IBM)
LaserCAD - (trademark of DSL, Inc.)
Newsroom-Pro - (trademark of Springboard Software Inc.)
PCad - (registered trademark of PCad)
TopView - (trademark of IBM)
Ventura Publisher - (trademark of Ventura Software, Inc)
VersaCADD - (trademark of T & W)
When the mouse driver is loaded, LOGITECH Mouse works with any of the following
applications.
AutoSketch - (trademark of Autodesk)
ClickArt Personal Publisher (trademark of Software Publishing)
Easy - (trademark of MicroPro)
Flight Simulator - (registered trademark of Microsoft)
GEM - (registered trademark of Digital Research)
Harvard Professional Publisher - (trademark of Software Publishing)
Norton Commander - (trademark of Peter Norton)
OrCAD - (trademark of OrCAD Systems)
PC Paintbrush Plus - (trademark of ZSoft)
Personal Designer - (trademark of Computer Vision)
pfs: First Publisher - (trademark of Software Publishing)
B· S4
Popular Mouse Applications
Point Text Editor - (trademark of LOGITECH, Inc.)
Publishers Paintbrush - (trademark of ZSoft)
QuickBasic - (registered trademark of Microsoft)
Reflex - (trademark of Borland)
RoboCAD-PC (trademark of ROBO Systems)
Smalltalk V - (trademark of Digitalk)
ShowPartner - (trademark of Brightbill Roberts)
smARTWORK - (trademark of Wintek)
Telepaint - (trademark of LCS Telegrapbics)
TurboCad - (trademark of Pink Software)
Word - (registered trademark of Microsoft)
LOGITECH Mouse works with the following applications because they use their own
driver to run the mouse.
IN*A*VISION - (trademark of Micrograpbics)
PageMaker - (trademark of Aldus)
Windows - (registered trademark of Microsoft)
LOGITECH Mouse software provides a ready-to-use menu for the
applications.
following
Edlin - (Microsoft)
Framework - (trademark of Ashton-Tate)
QMODEM - (trademark of The Forbin Project)
SuperCalc - (registered trademark of Sorcim Corporation)
Symphony - (registered trademark of Lotus Development Corp.)
Turbo Pascal - (trademark of Borland International)
Turbo Prolog - (trademark of Borland International)
VP-Planner - (trademark of Paperback Software)
WordPerfect - (trademark of WordPerfect Corporation)
WordStar - (trademark of MicroPro Corporation)
XTREE - (registered trademark of Executive Systems)
For the latest list of compatible software, use the POINT editor or your word processor to
look at CLlCK.SRC.
B -55
Chapter 5
5.3 Definition Files for Other Applications
Your LOG/TECH Mouse diskette also contains definition files for many other menus.
To see the complete list, insert your LOG/TECH Mouse diskette in drive A and type:
DIR *.DEFGI]
Files with the .DEF extension can be compiled with the NEWMENU compiler into
.MNU files for use with CLICK.
For more information on the creation and use of these menus, see Chapter 3.
5.4 If Set-Up Procedures Are Needed
If your LOG/TECH Mouse does not work automatically with an application (or if it
does, but clicking a mouse button fails to produce a menu), some additional set-up
procedures may be necessary:
•
You may need to configure the computer and its input/output devices to use the
mouse with your application. Use the installation program of the application
software. (Refer to Section 5.5.)
•
You may need to set the LOG/TECH Mouse parameters to work with your
application.
r - - - - - - - - - - - - - - NOTE - - - - - - - - - - - - ,
If your application is listed in Section 5.2, it either requires no special
parameters, or CLICK is setting the parameters automatically. See the
READ.ME files also for the latest information about applications that are
handled automatically by your LOG/TECH Mouse.
Parameters define how your mouse communicates with the computer.
To add your application's parameters to CLICK so that the LOG/TECH
Mouse can be used automatically any time you call your application,
refer to Chapter 4.
•
If LOG/TECH Mouse software does not provide a menu for your application
you can build a menu with LOG/MENU. (See Chapter 3.)
B -56
Popular Mouse Applications
5.5 Installing Applications
Most applications support an input device as well as a keyboard. During selection of the
input device to use with the application, you will see different mouse types. If your
LOGITECH Mouse and mouse type is listed, then select it and proceed.
5.5.1 LOGITECH Serial Mouse
If you have a LOG/TECH Serial Mouse, select:
LOGITECH C7, R7 or Serial Mouse
This installs your application for use with the LOG/TECH Serial Mouse.
Mouse Systems Corporation PC Mouse
Select this and follow directions on screen. Then go through Section 3.1 again,
to be sure that your LOG/TECH Serial Mouse works correctly when installed
as a Mouse Systems Corporation PC Mouse.
NOTE
----------------------~
In Section 3.1, for Step 1 substitute the following:
At the DOS prompt, if your mouse is using COM1, type:
MOUSE PCQ]
If your mouse is using COM2, type:
MOUSE 2 PCQ]
If your mouse works with the application, Steps 3 and 4 in Section 3.1
are not necessary.
Microsoft Mouse
Often refers to the Microsoft Bus Mouse (or MOUSE.COM).
Follow directions on screen. Go through Section 3.1 again to confirm that your
LOG/TECH Serial Mouse will work as a Bus Mouse. (This option forces the
application to use the resident mouse driver.)
One of the above options should configure the application to work with your mouse.
For some applications, configure input and output devices to use the LOG/TECH
Mouse. Chapter 6 has notes on several popular application installation procedures.
B - 57
Chapter 5
5.5.2 LOGITECH Bus Mouse
If your application has a mouse installation menu, you may select either LOGITECH
Bus Mouse or Microsoft Bus Mouse. Afterwards your LOGITECH Bus Mouse should
work with your application.
When you install an application that uses a Bus Mouse, you can choose to install it as a
Microsoft Bus Mouse.
5.5.3 LOGiTECH Series 2 Mouse
If your. application has a mouse installation menu, you can choose to install it as an
IBM PS/2 Mouse. Afterwards your LOGITECH Series 2 Mouse should work with your
application.
When you install an application that uses a LOGITECH Series 2 Mouse, you can choose
to install the program for the IBM PS/2 Mouse.
B -58
General Installation Notes
Chapter 6
General Installation Notes
Before using your LOGITECH Mouse with application software, you must configure the
computer and its input/output devices to use the mouse. Do this when you install the
software.
The following pages describe this procedure for several of the more popular applications.
6.1 Automatic Installation
The LOGITECH Mouse works with most software packages without special set-up
procedures.
In addition, CliCK Mouse Control software and LOGIMENU Menu Generator
software make it easier than ever to tailor both mouse-based and non mouse-based
applications to be used with your LOGITECH Mouse.
Refer to Section 5.2 for a list of programs that run with the LOGITECH Mouse.
B - 59
Chapter 6
6.2 AutoCAD
Step 1: From the AutoCAD Main Menu, select: Configure Auto CAD.
• If you have a LOGITECH Serial Mouse, go to Step 2.
• If you have a LOGITECH Bus or Series 2 Mouse, go to Step 4.
Step 2: Select: Allow I/O port configuration.
Step 3: At the prompt:
Do you really wish to do I/O port configuration?
Type: l!.J for yes.
Step 4: Select: Configure digitizer.
•
If you have a LOGITECH Serial Mouse, select: Logitech Logimouse.
Listings may alternately show Logitech R5, R7, C7, or Logitech
Serial Mouse, depending on your version of AutoCAD; Go to Step 5.
•
If you have a LOGITECH Bus or Series 2 Mouse, select Microsoft
Mouse or whichever name reflects your mouse type; Go to Step 9.
Step 5: At the prompt:
Enter port nama, or address in hexadecimal
if your mouse is using the COMI serial port, type:
3FSW
or, if your mouse is using COM2, type:
2FSW
Step 6: At the prompt:
Do you want to adjust the Logimouse scaling factors?
Type: Y for yes.
Step 7: At the prompt: Fast motion factor, 0 to 255 <3>,
choose a factor between 5 and 20.
Step 8: At the prompt:
Fast motion threshold, 0 to 2047 <100>,
choose a threshold of 1 or 2.
Step 9: Return to the AutoCAD Main Menu. At the prompt:
Do you want to keep these changes?
Type: Y for yes.
If you run AutoCAD with a Serial mouse without CLICK, you must set the Baud Rate
each time to 9600 by issuing the command MOUSE 9600 before starting AutoCAD.
B·60
General Installation Notes
6.3 CADVANCE
CADVANCE has an internal driver for the LOGITECH Serial Mouse. The installation
procedure is detailed in the CADVANCE manual. To install the mouse driver, type:
INSTALL GI MSYS[;D
6.4 FrameWork IT
FrameWork II requires no special LOGITECH Mouse installation procedure.
To use the supplied FrameWork II menu with this application, however, you need to
make sure that the communications facility for FrameWork II does not address the same
serial port used by the LOGITECH Serial Mouse.
6.5 GEM
Step 1: Start the GEMPREP install program.
Step 2: At the GEM prompt:
What kind of mouse do you have?,
select Microsoft Bus Mouse.
Step 3: At the GEM prompt:
Do you have a Microsoft Bus Mouse?
YIN,
respond: Yes.
Step 4: At the prompt:
Insert the Microsoft Mouse distribution disk in drive A
insert the LOGITECH Mouse diskette in drive A.
Step 5: Follow the rest of the instructions on the screen.
The above selection will force the application to use the mouse driver in resident
memory. If you are using a LOGITECH Serial Mouse and selected the Mouse Systems
PC Mouse,refer to Section 2.2 for instructions.
B -61
Chapter 6
6.6 Generic CADD
Generic CADD expects the LOGITECH Serial Mouse to run in the Mouse Systems (PC
Mouse) emulation mode. CLICK will configure your LOGITECH Serial Mouse to run
in this mode. If you are not using CLICK, refer to Section 2.2 for proper settings.
If you have a LOGITECH Bus Mouse, please follow instructions in the CADD
installation menu.
6.7 PC PaintBrush
To use this application with the LOGITECH Serial Mouse, replace the PC PaintBrush
file LOGIMOUS.COM with the LOGITECH file MOUSE.COM.
Then, in the Install session, choose LOGlTECH
Mouse
B -62
as the drawing device.
General Installation Notes
6.8 Symphony
The SYMPHONY.MNU LOG/MENU file is on one of your LOG/TECH Mouse disks.
Also SYMPHONY.DEF can be modified and compiled by NEWMENU.
With this setting, ,_ 0 0 I is used as QJ and' 0 0 _I as ( Esc I. The use of (0 • D)
depends on the detected mode of Symphony. See below.
~------------------------ NOTE -------------------------,
If you are using a LOG/TECH Serial Mouse, install the mouse on COM2 since
Symphony reserves COMI for communications. Specify this in Symphony's
INSTALL the first-time installation procedure of Symphony's INSTALL program.
How your mouse works with SYMPHONY
[_DO]
is
always
(0_0]
is
Menu if Sheet
or
ANCHOR if Point
or
(00_]
is
always
Mouse Help
6.9 Ventura Publisher
Step 1: Start the Software installation.
Step 2: If you have either a LOG/TECH Serial Mouse or a LOG/TECH Bus Mouse At
the mouse selection prompt, select Microsoft Bus Mouse or MOUSECOM.
This will orient Ventura Publisher to use the mouse driver resident in memory.
For the LOG/TECH Series 2 Mouse, select the IBM PS/2 Mouse.
Some versions of Ventura Publisher recommend installation of the LOG/TECH Serial
Mouse as a Mouse Systems Corporation PC Mouse. If you find this more convenient,
please refer to Section 2.3 for proper settings.
B -63
Chapter 6
6.10 Windows
If you have an older version of the LOG/TECH Serial Mouse Windows driver, upgrade
to the latest version:
Step 1: Back up the Windows Setup disk (disk No.1).
Step 2: Copy LMOUSE.DRV from the LOG/TECH Mouse diskette to the Windows
Setup diskette,
Step 3: Reinstall Windows.
(This process will not damage your existing
Windows data files and is faster than the first Windows installation.)
NOTE
----------------------~
When you select the above option, you are orienting Windows to use the
LOG/TECH enhanced mouse driver LMOUSE.DRV, no matter which type of
mouse you are using.
If you are installing Windows and the LOG/TECH Serial Mouse for the first time:
Step 1: Start the Windows Setup program.
Step 2: At the prompt,
Which pointing device do you have?
select LOGITECH Serial Mouse.
Step 3: Foiiow the rest ui the instructions on screen.
6.11 Microsoft Word
Word requires no special LOG/TECH Mouse installation procedure.
CLICK
automatically configures the mouse each time you start Word. Note that your mouse
then functions as a two-button mouse, with the (0 _ D) acting as a simultaneous click of
(_0_).
Make sure you use the LOG/TECH mouse driver and not the Microsoft Driver that is
sometimes copied to the CONFIG.SYS during Word installation.
B -64
APPENDICES
Mouse Status Messages
Appendix A
Mouse Status Messages
These status messages will help you to detennine various functional errors as you use
your mouse.
Cannot open file CLICK.SRC
NEWCLICK has searched for the revised CLlCK.SRC file in the current
directory and through all the directories in the PATH and cannot find it. (For
more information about PATH, refer to your DOS user's manual.) If you don't
have the file CLlCK.SRC in one of those directories, NEWCLICK won't find it
and will display the above message. See Chapter 4 and the instructions for
customizing CLICK.
Cannot open file .DEF
NEWMENU has searched for .DEF through all the directories in the PATH and
cannot find it. (For more infonnation about PATH, refer to your DOS user's
manual.) If you don't have the file .DEF in one of those directories,
NEWMENU won't find it and will display the above message. See Chapter 3.
Cannot write file .MNO
There is not enough space left on your disk or the disk is write-protected.
CLICK already active
You have tried to reload CLICK when it is already loaded and is not disabled.
CLICK is not loaded -
(just type CLICK to load it)
You have typed a command such as CLICK OFF when CLICK wasn't loaded.
CLICK requires Logimouse Driver 3.xx - you have something else loaded
The current MOUSE.COM or MOUSE.SYS is either out of date, or for a
different mouse. Check your directories or program disks for duplicate
MOUSE.COM or MOUSE.SYS files. Then reboot, and load the correct
mouse driver.
B - 67
Appendix A
CLICK: Unrecognized Parameter
You have typed CLICK with a parameter other than OFF, ON, VERBOSE,
QUIET, or PATH.
First statement must be BEGIN
Your .DEF file does not open with a BEGIN statement, which LOGIMENU
requires. Create a BEGIN statement for this file. Refer to Chapter 3.
Invalid number of
ar~wT&ents
A statement in your .DEF file has a predefined number of arguments. The
number of arguments you supply does not match this predefined number.
Correct your file. Refer to Chapter 3.
Invalid statement : Line XX
Check the displayed statement from your .DEF file. The statement somehow is
wrong. Refer to Chapter 3.
Invalid statement arguments
You have ~ade an argument that is not valid for a statement in your .DEF file.
Check the file to locate the error and then correct it. Refer to Chapter 3.
Label is already defined
You have duplicated a label in your .DEF file. Find the mistake and correct it.
Refer to Chapter 3.
Label ia not followed by a statement
You have left an empty label in your .DEF file. Create a siaiemeni for ihis label
in the file. Refer to Chapter 3.
Label not defined
You have omitted a definition from a label in your .DEF file. Find the mistake
and correct it. Refer to Chapter 3.
Label table overflow
NEWMENU cannot handle more than 320 labels in one menu file.
B -68
Mouse Status Messages
Line XX: Error: Too many applications to configure
CLICK cannot handle so many applications. Remove the lines that you do not
use from CLlCK.SRC. Then, at the DOS prompt, type NEWCLICK QJ.
Line XX: Warning: application name truncated to
You have entered an application name that is too long for the CLlCK.SRC file.
NEWCLICK has truncated (or shortened) this name to its first eight characters.
Line XX: Warning: invalid keyword:
You have entered an invalid mouse parameter in the CLlCK.SRC file. See
Chapter 4 and the table that lists all the acceptable mouse parameters.
Menu code too big
The size of an .MNU file cannot exceed 20K bytes. See Chapter 3 about how
to expand MENU's loaded size.
Mouse driver not found
You have called MENU when the mouse driver was not loaded. MENU cannot
to load the driver.
work without the mouse driver. Type MOUSE
0
MSDOS version 2 or above required
Check your software. MEN U works with only DOS versions 2.0 and above.
Option Ignored
You have tried to use "/It option after you activated the MENU driver. See
Section 3.1.
OPTION or MEND Expected
You have omitted or mislabeled an OPTION statement or MEND statement in
the menu subroutine of your .DEF file. Find the mistake and correct it. Refer
to Chapter 3.
B -69
Appendix A
PopUp Menu File not found
MEN U searches for a menu file in the current directory and all directories in
your PATH. (For more information about PATH, refer to your DOS manual.)
If you don't have the .MNU file in one of those directories, MENU won't find it
and will display the above message. You have probably not completed the
compilation of the menu. Refer to Chapter 3 for instructions about the
NEWMENU command.
Read Error on Popup Menu File
An error occurred when reading the. MNU file. Try the command again. Check
the file and your disk if the error message is repeated.
SELECT, TEXT or PEND Expected
You have omitted or mislabeled a SELECT statement, TEXT statement, or
PEND statement in the POPUP subroutine of your .DEF file. Find and correct
the mistake. See Chapter 3.
This statement requires a label
You need to have a label before a particular statement in your .DEF file. Create
a label for this statement in your file. Refer to Chapter 3.
Unable to create file .MNU
There is not enough space on the disk to compile the requested menu file, or else
the disk you are trying to use is write-protected.
Usage: NEWMENU file[.def]
[/lr.m]
You have entered the NEWMENU command without a .DEF file to be compiled.
Example: NEWMENU FW 0
produces FW.MNU for LOGlMENU to use.
Warning: Menu Driver has not been loaded (type MENU) !
CLICK is telling you that LOGlMENU is not loaded. Type MENU 0 .
Warning: Mouse Driver has not been loaded (type MOUSE)!
You have called CLICK when the mouse driver was not loaded. CLICK cannot
work without the mouse driver. To load the driver, type MOUSE0
B -70
Mouse Command Language
Appendix B
Mouse Command Language
The following commands and parameters are for the LOG/TECH Mouse system:
Mouse Driver Commands
(for Serial Mouse)
MOUSE [<#OF BUTTONS>K] (1)
Command and parameters for the mouse driver. Parameters
can be used singly or in combination.
MOUSE
Load and configure mouse for COM!.
MOUSE 2
Load and configure mouse for COM2.
MOUSE INIT
Reset mouse to initial parameters.
MOUSE PC
Emulate a Mouse Systems Corporation PC Mouse.
MOUSE 1
Display current mouse driver settings.
LOGIMENU Commands
MENU
Load the LOG/MENU Generator in preparation for
implementing various mouse application menus.
MENU IN
N equals one thousand bytes. Use to produce MNU files
larger than the 5,000 byte default up to a limit of 20,000 bytes.
See Section 3.2.
MENU
Load .MNU as application menu.
MENU OFF
Disable most recently loaded application menu.
NEWMENU
Compile a .DEF file into a .MNU
file, and load as a menu.
B -71
AppendixB
CLICK Commands
CLICK
Load most recently compiled version of CLlCK.SRC.
CLICK OFF
Turn off CLICK.
CLICK ON
Enable most recently compiled version of CLlCK.SRC.
CLICK PATH
Shows the PATH used by click to find the menu files.
This is the path that was in effect when CLICK was loaded.
CliCK QUiET
Tum off CLICK comments.
CLICK VERBOSE
Tum on CLICK comments.
NEWCLICK
Compile and load most recent version of CLlCK.SRC.
B -72
INDEX
LOGITECH Plus Index
A
E
ASCII Characters, 32-33
Error Messages, 67-70
AutoCAD,60
Extended ASCII Code, 32-33
AUTOEXEC.BAT,8
H
B
Horizontal sensitivity, 38-9
How to
Baud rate, 9, 46, 60
Add Applications to CLICK, 48
C
Build Your own Menus, 15
Build Free-Fonn Pop-Up Menu, 39
CADVANCE, 61
Build One-Column Menu, 38
CLICK Mouse Control, 7,27-36
Check for Onscreen Data, 40
Add a menu to CLICK.SRC, 35
Execute Multiple Statements, 37
Change CUCK.SRC, 43-49
Generate Input Characters, 37
CLICK Commands, 49
How it Works, 2, 43
I
Color Code in menu, 36-37
Compiling .MNU fJles, IS, 71
Install 1,5
Mouse Driver,S,
D
Application Software,
AutoCAD,60
.DEF Definition fJles, 14, 15
DOS and your Mouse
CADVANCE, 61
FrameWork,61
AUTOEXEC.BAT, 8,71
CONFIG.SYS, 7, 8, 71
GEM,61
Microsoft Word, 64
COMl, COM2, 9, 10,71
Driver
PC PaintBrush, 62
Symphony, 62
Current State, 7, 71
Ventura Publisher, 63
Parameter Settings, 9-11, 71
Microsoft Wm,dows, 64
B -75
LOGITECH Plus Index
L
N
LOGIMENU
What LOGIMENU does, 7,37
Additional Programs, 69
Creating menus, 39
NEWMENU Compiler, 37, 43
Pop up menus, 37
NEWCUCK,72
NEWMENU, 24, 71
P
Syntax, 31
LOGIMENU language 31
ASSIGN, 31, 37
BACKSP, 31,
BEGIN, 31, 45. 48-9,
CHORDS, 31,53,
Popular Applications. 54-55
POPUP program, 39
Protocol. 46, 71
R
Comment, 31.45
ENTER, 31,45,
ESC, 31,61,
Report rate, 46, 71
s
EXECUTE, 31,
Label, 31,
MATCH,61,
MEND,31,
MENU,38
OPTION,31,
Set Mouse Parameters, 71
Statements That Define Mouse Buttons and
Movements, 36
Software Compatibility
Mouse-based programs, 54
PEND. 31,
SELECT, 31,
TEXT,31
TAB,31
Non Mouse-based programs, 55
SYMPHONY,62
System Parameters
Baud Rates, 46-47, 71
TEXT,31,
Protocols, 46-47,71
Report Rates, 46-47, 71
TYPE.3i,
M
v
.MNU Menu files, 38
Microsoft Compatibility, 57, 72
Ventura Publisher, 63
Vertical sensitivity, 38-9
Microsoft Menu Compatibility. 14
Mouse
w
MOUSE Driver Command, 71
Mouse Status Messages, 67-70
Windows, Microsoft, 64
Word, Microsoft, 64
B -76
The Point & Click™ Shell
for Lotus 1-2-3
TM
Copyright © 1986, 1987, LOGITECH, Inc.
All Rights Reserved.
No part of this document may be copied or reproduced in any form or by any means
without the prior written consent of LOGITECH, Inc.
C-ii
Table of Contents
Introduction ....•.•........•..........................•..............................•.......•...........•............... 1
1 Install The Point &-Click Shell •.•................•...........•...........•.•..•......................... 2
2 Start the Point &-Click Shell...........•.•..............•...........•.•••..•.......•.•.•..................3
3 A Tutorial ••.•.........•.•.............•.....•...•.••......•.•..•........................................•............. 4
4 Mouse Buttons •.•.........•........•..•.........•.•....................................................•..•........5
5 Data Entry Accelerator •..............•......•.•..•...................................•.....................11
6 Your Own Point &-Click Menu ...........•.•......................................................... 12
7 Troubleshooting ................•.••......•..•.•.••......•.•...........•..........................•.............16
8 Index ......•..•..•........•...•..•.•......•.........••........•..•.•..........................•.........................17
C-iii
C - iv
The Point & Click Shell
Introduction
M123, the Point & Click Shell is the LOGlTECH Mouse interface for the Lotus 1-2-3
spreadsheet program. It makes Lotus 1-2-3 work like a mouse-based program. With
M 123, you can execute multiple keystroke functions with a single click of a mouse
button, as well as move your cursor quickly and easily from cell to cell.
Here are just a few of the advantages that the Point & Click Shell gives you:
Context Sensitive Pop-Up Menus
The Point & Click Shell "knows" which mode you're in and
gives you a pop-up menu that makes sense when you need it.
Programmable Pop-Up Menus
You can easily adapt the pop-up menus to simplify and speed
up repetitive tasks. (See Section 6)
Num Lock Accelerator
Speeds up data entry by turning the (±) and
numeric keypad into
and B.
rn
C -I
G
on the
M123
Section 1: Install The Point & Click Shell
The Point & Click Shell consists of two M123 files: M123.COM and M123.MEN.
To make the Point & Click Shell available whenever you use Lotus 1-2-3, add them to
your Lotus 1-2-3 System disk.
-----------------------I~N~OyTNE~)----------------------~
This section is not necessary or applicable if you have already installed the M; 23
files with the mouse INSTALL program.
If You Have a Dual Floppy Drives:
Step 1: Insert your Lotus 1-2-3 System disk in drive A.
Insert your LOGITECH Plus software diskette in drive B.
Step 2: At the DOS A) prompt, type:
COpy B:\M123.
* A: Cd]
This copies Point & Click files to your Lotus System disk.
If You Have a Hard Disk:
Step 1: Insert the LOGITECH Plus diskette in drive A.
Step 2: Switch to your Lotus 1-2-3 directory.
Step 2: At the DOS prompt, type:
COPY A:\M123.
*
GO
This copies Point & Click files to your Lotus 1-2-3 directory.
C-2
The Point & Click Shell
Section 2: Start The Point & Click Shell
To run the Point & Click Shell:
Step 1: Load your mouse driver.
If necessary. change to your mouse software directory and type:
MOUSE
QJ
Step 2: Call up the Lotus ACCESS menu.
Change to your Lotus 1-2-3 directory and type:
M123
QJ
This loads the Point & Click Shell which in turn loads Lotus 1-2-3.
Step 3: Select 1-2-3.
In the Lotus ACCESS menu. use [. 0 olto select 1-2-3.
(NOTEI
To load 1-2-3 without going through the Lotus ACCESS menu:
If you have Lotus 1-2-3 Version 1 A (123.EXE). type
M123/1
QJ
If you have Lotus 1-2-3 Version 2.0 (123.COM). type
M123/2
QJ
To pass a loading parameter (such as a different driver set) to Lotus 1-2-3. simply
add it to the command line. or to a batch file. For example. to call1-2-3 with a
driver set named MY_SET.SET. type.
M123/2
MY_SET
QJ
In the sections that follow, experiment. Move the mouse and click the buttons to
discover how the Point-and-Click Shell works.
C-3
M123
Section 3: A Point & Click Tutorial
Here is a Point & Click procedure that inserts some basic information into a typical
spreadsheet, and then shows you how to save your work.
Use (• • l¢nstead ofl. 0 .) hereafter, if you are using a two-button mouse.
Step 1: Load M123 and Lotus 1-2-3.
Follow the instructions outlined in Section 2.
Step 2: Load the days of the week into your spreadsheet.
Point the mouse cursor to cell A2 and click l • 0 0] •
Press and hold (0 • 0) to pop up the M123 menu.
Slide the cursor highlight to Days, and release (-0-.-0""""] .
The days of the week are now listed horizonta1~y in Row 2.
Step 3: Insert a new column.
While the cursor is still at position A2, press (0 • 0] again.
Scroll down the pop up menu to Insert Column and release l 0 • 0) .
You have now inserted a new column before column A.
Step 4: Load the months of the year into your spreadsheet.
Move the mouse cursor down to row 3 and click the l. 0 0] •
Press and hold l 0 • 0) to pop up the M123 menu.
Slide the cursor highlight to Months, and release [r::.o~.---=o~) .
The months of the year are now listed horizontally in Rgw 3.
Step 5: Copy the month names to a column.
Press l 0 • 0 J , slide the cursor highlight to Transpose HV, and release.
The months of the year are now also listed vertically in Column A.
Step 6: Erase the extra months.
Point the mouse cursor to cell B3 and click ( • 0 0] .
Press (0 • 0 I , slide the cursor to Erase Right, and release (0 • 0) .
The months of the year are erased, starting from tpe right of the cursor position.
Step 7: Save your worksheet.
Press [0 • 0) , move the mouse to Save in the right menu border, and release.
At save file name, name your worksheet (e.g., HOLIDAYS).
Press QJ to confirm.
C-4
The Point & Click Shell
Section 4 Mouse Buttons
4.1 Pointing and Editing
Go to cell
In READY, POINT, LABEL, and EDIT modes, point to a cell in the spreadsheet and click
[ . 0 0 to make the cell current (ending the EDIT or LABEL mode if necessary).
I
Edit cell
In READY mode, point to the current cell and click (. 0 D) for 1-2-3 to enter EDIT mode.
Click again to go back to READY mode.
End Point Mode
In POINT mode, point to the current cell and click (. 0 0 I for 1-2-3 to receive a
equivalent to a confirmation.
Copy cell: ~. 0 0
0 '
I
In READY mode, ~. 0 0 I copies current cell contents to the target cell. Warning:
this replaces the contents of the target cell.
Move cell: @!ill-[. 0 0
I
In READY mode, @!ill-[. 0 D) moves the current cell contents to the target cell.
Warning: this replaces target cell contents, and deletes current cell contents.
Edit mode, Label mode
While in EDIT or LABEL mode, you can move the mouse cursor over the editing line.
Clicking the I. 0 D) to establishes the cursor at the selected position. Warning: this
works only for editing the current ceil.
C-5
M123
4.2 Scroll bars
I NOTE]
The actions on this page work in any mode.
Horizontal scroll bar
For scrolling the spreadsheet left or right, the scroll bar is on the upper line with the
column letters. Put the mouse cursor on the upper line, and press ( 0 0 .) to scroll the
column under the mouse position to the left side. Press (. 0 D) to get the column on the
left back to the mouse position.
Vertical scroll bar
For scrolling the spreadsheet up or down, the scroll bar is on the left with row numbers.
Put the mouse cursor on a row number and press (0 0 .) to scroll the line at the mouse
position to the top. Press (. 0 D) to bring the row on top back to the mouse position.
Cursor bars
The bottom line and the right side of the screen are cursor bars. With the mouse cursor
in the area, (. 0 D) is equivalent to B
and I0 0 .) is equivalent to I~) CD .
OJ '
C-6
The Point & Click Shell
4.3 In and out of the Main Menu
Click to call
CZJ
(forward slash)
To call the 1-2-3 menu from READY mode, move the mouse cursor to the menu area at
the top of the screen and press (- 0 0 I. This is the same as pressing
CZJ .
Menu item & click
To select an item in the 1-2-3 menu (in MENU mode), move the mouse cursor over the
menu item, and press the ,_ 0 0 I. This is the same as entering the first letter of the
menu item.
File name & click
To select a file name in the 1-2-3 file menu (in FILE mode), move the mouse cursor over
the file name, and press (_ 0 0 I . This is the same as entering that file name.
Moving the current menu item
The bottom line of the screen is the cursor bar.
To move one cursor position to the left, press [ _ 0 0 Iwith the cursor on the bottom line.
To move one cursor position to the right, press (0 0 -I. The scroll bars operate in
MENU and FILE modes, as if they were affecting the spreadsheet.
Escape to Ready
(0 0 -I is equal to [ Esc) as the default setting in any mode. This cancels actions and
goes back to READY mode from the 1-2-3 menu. You can alter the M123.MEN file to
change how (0 0 -I behaves.
C-7
M123
4.4 Pop-up menus
Middle button technique
To reach the M 123 pop-up menu, press and hold' 0 _ D) (U se , __ ] for a two-button
mouse).
Move the mouse down, left, or right, towards the desired item.
Move the highlighting, stop on the desired item, and release the [0 _ 0 J. The action
called by the menu item is then taken.
Main menu
The main menu has options for quick action on the spreadsheet. Move the mouse to the
left to select Retrieve. Move it to the right for the Save menu. Other options are
convenient for quick operations, such as sum column, fast quit (do not forget to save!),
etc.
R
e
t
r
i
Home
End Home
Sum Column
Sum Line
A
Prin~
'Ra",g'':=I
v Worksheet Fmt
e Column Width
Insert Row
Insert Column
Days
Months
Transpose HV
Transpose VH
Erase Right
Erase Down
Center Label
Today
Fast Quit
C-8
S
a
v
e
The Point & Click Shell
Comments -- Main Menu
Save
Retrieve
Home
End Home
Sum_Column
Sum Line
Print_Range
Worksheet Fmt
Column Width
Insert Row
Insert_Column
Days
Months
Transpose_HV
Transpose_VB
Erase_Right
Erase Down
Center Label
Today
Save file menu
Retrieve file menu
Go to upper left comer
Go to lower right comer
@SUM formula for the above column
@SUM formula for the line to the left
Print Range menu
Worksheet Format menu
Change column width
Insert one new row
Insert one new column
Enter a row of 7 cells with the days of the week
Enter a row of 12 cells with the month names
Transpose the row to a column
Transpose the column to a row
Erase the cells to the right of this line
Erase the cells below in this column
Prompt for a range of labels to center
Enter today's date as per the system (make sure your cell
is more than 10 characters wide).
Quit 123 without confirmation (make sure you save before!)
C-9
M123
Secondary menu
The secondary menu is used for all modes but READY. In these modes, RETURN, ANCHOR,
HOME, and other options are used to terminate operations and travel through the
spreadsheet (like in POINT mode).
I:
R
e
Home
c End Left
h End Right
o End Up
r End Down
t
u
r
n
End Home
Comments -- Secondary Menu
Return
Anchor
Home
End Left
End_Right
End_Up
End Down
End Home
QJ
0
Go to upper-left comer
Go to leftmost cell
Go to rightmost cell
Go to top cell
Go to bottom cell
Go to bottom-right comer
C -10
The Point & Click Shell
Section 5 Point & Click Data Entry Accelerator
To speed up data entry, the Point & Click Shell has changed the function of C±J and G
on the numeric keypad.
(±) has the same effect as CD .
B
has the same effect as
B.
This means that if you need to enter numerous rows and columns of figures, then,
If you are entering a column of figures:
(1) Type the entry for a cell.
(2) Press (±).
(3) Type the next entry.
If you are entering a row of figures
(1) Type the entry for a cell.
(2) Press G.
(3) Type the next entry.
C-11
M123
Section 6 Your Own Point & Click Menu (For Advanced Users)
The listings on the Point & Click Shell menus may not be the ones you would choose.
You can modify the function of the Point & Click Shell menus, of the [ 0 0 . I mouse
button, or the G and [±) keys by using a text editor like the POINT Editor or the
nondocument mode of a word processing program like WordS tar. When modifying
M123 files, you must follow the format that is set in the M123.MEN file, below.
Each prograrli in M123.MEN consists of items in parentheses. Each item in a sequence
is separated by the I character. Spaces are not read by M123. For a space to appear in a
menu word, you must type an underline character instead of a space.
The program for each menu contains two sequences of items.
•
The first shows the words to be displayed in the menu:
(Quit_123 I Retrieve I Save)
•
The second shows the corresponding key codes to be executed:
(/q I Ifr I Ifs)
Some keys are special: 0, [etrll, ISpacebar), CD, OJ, CD, and the number keys.
To put them into a sequence, use the corresponding ASCII code (see Appendix B of the
POINT Editor User's Manual, or see the IBM PC BASIC Manual).
For key code meanings in the second sequence, check the Command Summary in
T nt,,~
J)nl"nrno"n
---r--- - nfthp
-- --- -_
. __ .1_"_1
. - - ."-J-_..._- .a,,,1&8"0'"''
................... .
rhgnt~1""
C-12
The Point & Click Shell
Menu for READY mode:
(Save I
Retrieve
Home I
End Home
Sum-Column
Sum-Line I
Print Range I
Worksheet Fmt
Column_Width I
Insert_Row I
Insert_Column
Days I
Months I
Transpose_HV I
Transpose VH I
Erase_Right I
Erase_Down I
Center_Label
Today I
Fast_Quit
)
(IFS I
/FR I
071 I
079 071
@SUM 40
@SUM 40
/ppr I
/wgf I
/wcs I
/wir 13
/wic 13
Mon 077
Jan 077
Nov 077
/rt 079
/rt 079
Ire 079
Ire 079
060 071
@NOW 13
/qy
I
072
075
079 072 41 13
079 075 41 13
Tue 077 Wed 077 Thu 077 Fri 077 Sat 077 Sun 13 079 0751
Feb 077 Mar 077 Apr 077 May 077 Jun 077 Jul 077 Aug 077 Sep 077 Oct 077
Dec 13 079 0751
077 13 13 I
080 13 13 I
077 13 I
080 13 I
A
083 13 I
/rfd 13 13
)
Menu for other modes:
(Return I Anchor
I Home
)
(13
071
079 075
I 079 077 I 079 072
079 080
Right Button is ESCAPE:
(27)
Plus & Minus Keys:
(080 I 077)
delete the above line if you want the regular plus and minus
(+1-)
Figure M-1 M123.MEN Source File
C -13
079 071 }
M123
You can modify an existing Point & Click Shell menu by inserting a new option in its
first sequence, and the corresponding key codes to be executed in the second sequence.
For Point & Click to find the second item, it must be in the same spot in the sequence.
To add the option "Split_Window" in the main menu:
Step 1: Open M123.MEN for editing.
Do this with the POINT Editor, or the non-document mode of a word
processing program like WordStar.)
Step 2: Insert the Menu Item Name.
In the first sequence of entries, on line 9, type:
Split_Window I
Note:
Include an _ (underline character) between Split and Window
in order to separate those words by a space in the menu on screen.
Step 3: In the second sequence of entries, on line 9, type:
/wwh
I
This is the Lotus 1-2-3 command for /Worksheet Window Horizontal.
Step 4: Save your revised M123.MEN file.
Your revised M123.MEN file should match Figure M-2.
For (0 0 • ), and for C±J and G , the ASCII code entries tell which keys are to be
executed. These can be modified by replacing the existing items with new ASCII code
eD.tric:;.
C-14
The Point & Click Shell
Menu for READY mode:
(Save 1
Retrieve
Home 1
End Home
Sum Column
Sum-Line 1
Print Range 1
Worksheet Fmt 1
Split_Window 1
Column Width 1
Insert-Row 1
Insert-Column
Days 1
Months 1
Transpose_HV 1
Transpose VH 1
Erase Right 1
Erase:=Down 1
Center Label
Today
Fast_Quit
T
)
(lFS
/FR
1
1
071 1
079 071
@SUM 40
@SUM 40
/ppr 1
/wgf 1
/wwh 1
/wcs 1
/wir 13
/wic 13
Mon 077
Jan 077
Nov 077
/rt 079
/rt 079
Ire 079
Ire 079
060 071
@NOW 13
/qy
1
072 • 079 072 41 13
075 • 079 075 41 13
Tue 077 Wed 077 Thu 077 Fri 077 Sat 077 Sun 13 079 0751
Feb 077 Mar 077 Apr 077 May 077 Jun 077 Jul 077 Aug 077 Sep 077 Oct 077
Dec 13 079 0751
077 13 13 1
080 13 13 1
077 13 1
080 13 1
083 13 1
/rfd 13 13
1\
)
Menu for other modes:
(Return 1 Anchor 1 Home
)
(13
1
071
079 075
1
079 077 1 079 072
079 080
Right Button is ESCAPE:
(27)
Plus & Minus Keys:
(080 1 077)
delete the above line if you want the regular plus and minus
(+ I-)
Figure M-2 Modified MI23.MEN File
C ·15
079 071 }
M123
Section 7 Troubleshooting
The interaction of the LOGITECH Mouse, the Point & Click Shell, and Lotus 1-2-3
should be trouble-free. Although they are unlikely, some possible problems and their
solutions are described below.
Mouse cursor is not visible
Move the mouse, The cursor should reappear as soon as the mouse moves,
Mouse cursor will not move
Check mouse connections'. If the mouse is properly connected, make sure that
the 1-2-3 or Printgraph printer settings are not on the same serial port as the
mouse. Correct and reload the mouse.
Mouse cursor leaves inappropriate character on screen after you move the mouse
This happens occasionally when a long operation has taken place and its
necessary for Lotus 1-2-3 to repaint the screen. Spreadsheet content is not
affected.
Point & Click Shell will not work with special screen sizes
The Point & Click Shell does not work with the following video modes:
Hercules 90 x 38
AT&T 80 x50
Hercules 80 x 25 or
AT&T 80 x 25
C -16
POINT™ EDITOR
Version 1.5
User's Manual
Copyright © 1985, 1986, 1987, LOGITECH, Inc.
All Rights Reserved.
No part of this document may be copied or reproduced in any form or by any means
without the prior written consent of LOGITECH, Inc.
LOGITECH, Inc. makes no warranties with respect to this documentation and disclaims
any implied warranties of merchantability and fitness for a particular purpose. The
information in this document is subject to change without notice. LOGITECH, Inc.
assumes no responsibility for any errors that may appear in this document.
From time to time changes may occur in the filenames and in the files actually included
on the distribution disks. LOGITECH, Inc. makes no warranties that such files or
facilities as mentioned in this documentation exist on the distribution disks or as part of
the materials distributed.
Third Edition, September 1987
This User's Manual applies to POINT Editor, Version 1.5.
Document#:
Initial issue:
Current revision:
Printed:
LU-UD-008-1A
February 1984
August 1987
September 1987
d-ii
Table of Contents
Table of Contents
D-l
Introduction
How the POINT User's Manual is Organized ......................................................D-1
How to Read this Manual .....................................................................................D-2
LOGIlECH Policies and Services ........................................................................ D-4
Other LOGIlECH Products ..................................................................................D-5
Installation
D-7
What You Need.....................................................................................................D-7
POINT Files on Disk ............................................................................................D-8
Installation Procedure ...........................................................................................D-9
Configure Your System ......................................................................................D-1 0
Set File Handles ............................................................................................D-10
Load Your Mouse Driver ..............................................................................D-10
POINT and Your Monitor .............................................................................D-10
1. Begin the Tutorial
D-ll
1.1 Load the POINT Editor ................................................................................ D-12
1.2 Look at the Parts of the Screen .................................................................... D-13
1.2.1 Cursor, Selection, and Insertion .......................................................... D-13
1.2.2 The Main Menu ...................................................................................D-14
1.2.3 The Work Area ....................................................................................D-14
1.2.4 Comment line ...................................................................................... D-14
1.3 The HELP System ........................................................................................D-15
1.3.1 YesjN"o Questions ................................................................................ D-15
1.4 Look at Menus ............................................................................................. D-16
1.4.1 Open a File .......................................................................................... D-16
1.4.2 Explore a Pull-down Menu .................................................................D-17
1.5 Create a New Window ................................................................................. D-18
1.5.1 Look at the Parts of the Windows .......................................................D-19
1.5.2 Close the Window ............................................................................... D-20
d - iii
Table of Contents
1.6 Open Multipl~ Windows ..............................................................................D-21
1.7 The TOPLIST Menu ....................................................................................D-22
1.7.1 The Active Window ............................................................................ D-22
1.7.2 Overlapped Windows .............•............................................................ D-22
1.8 Move a Window ...........................................................................................D-23
1.9 Reshape a Window ...................................................................................... D-24
1.9.1 Resize Window ....................................................................................D-24
1.9.2 Stretch a Window ................................................................................ D-24
1.9.3 Zoom a Window .................................................. "" ... " ... ",.,."""",,, .. ,D-24
1.10 View a File .................................................................................................D-25
1.10.1 Scroll With the Mouse .......................................................................D-25
1.10.2 Thumb with the mouse....................................................................... D-25
1.10.3 Scroll with keys .................................................................................D-26
1.11 Save Files ................................................................................................... D-27
1.11.1 The Save As ... Option ...................................................................... D-27
2. Edit With POINT
D-29
2.1 Insert New Text............................................................................................ D-29
2.2 Select Text. ...................................................................................................D-30
2.2.1 Select Characters .................................................................................D-30
2.1.2 ~elect Characters, Words, and Lines ...................................................D-31
2.2.3 Click Method for Selecting Text. ........................................................D-32
2.2.4 Hold Down Button Method for Selecting Text. ..................................D-32
2.3 Move and Copy Text. ...................................................................................D-33
2 . 3.1 Ma'.'e C! CCpj7 Text Using "the S~rup" ...............................................D-33
2.3.1.1 Multiple Copies from the Scrap .................................................D-33
2.3.2 Move or Copy Text Without the Scrap ............................................... D-34
2.3.2.1 Move Text, the Mouse Ctrl Method ............................................ D-34
2.3.2.2 Move Text, ~he Extract Method .................................................D-34
2.3.2.3 Copy Text, the Mouse Shift Method ........................................... D-35
2.3.2.4 Copy Text, the Duplicate method ...............................................D-35
2.4 The EDITING Menu ....................................................................................D-36
2.4.1 Redo Last Edit .....................................................................................D-36
2.4.2 Undo Last Edit .................................................................................... D-37
2.4.2.1 Undo (reversible) the last edit. ................................................... D-37
2.4.2.2 Undo Multip1e Edits ...................................................................D-37
2.4.3 Global Replace ....................................................................................D-38
2.4.4 Insert ASCII Character ........................................................................D-38
d - iv
Table of Contents
2.5 The MOVING Menu ....................................................................................D-39
2.5.1 Search for Text ....................................................................................D-39
2.5.2 Crossing Windows ..............................................................................D-39
2.5.3 Search Backwards ...............................................................................D-40
2.5.4 Search Options ....................................................................................D-40
2.6 The QUIT+ETC Menu .................................................................................D-41
2.6.1 Variations on the Quit Command .......................................................D-41
2.6.2 More Commands from QUIT+ETC ....................................................D-42
2.6.2.1 Escape to DOS Shell .................................................................. D-42
2.6.2.2 Execute Selected DOS Command ..............................................D-42
2.6.2.3 Get Help .....................................................................................D-42
2.6.2.4 Redraw the Screen ...................................................................... D-42
Chapter 3 POINT Concepts
D-43
3.1 What POINT Is ............................................................................................D-43
3.2 How POIN"T Works .....................................................................................D-44
3.2.1 How POINT uses a Mouse ..................................................................D-44
3.2.1.1 Mouse Cursor ............................................................................. D-44
3.2.1.2 Mouse Buttons ............................................................................D-44
3.2.2 How POINT Works without a Mouse ................................................. D-45
3.2.2.1 Mouse Movement Simulation ....................................................D-46
3.2.2.2 Mouse Button Simulation ........................................................... D-47
3.2.2.3 Using Mouse Keys with a Mouse ............................................... D-47
3.2.2.4 Mouse Simulation Command Table ...........................................D-48
3.2.2.5 Mouse Sensitive Points .............................................................. D-50
D-Sl
Chapter 4 Initialization Files
4.1 What They Do .............................................................................................. D-51
4.2 How They Work .......................................................................................... D-52
4.2.1 The PT.IN"I File ................................................................................... D-52
4.2.2 PTLOCAL.INI Files ............................................................................ D-52
4.2.3 Other INI files .....................................................................................D-52
4.3 Options .........................................................................................................D-53
4.3.1 Color Options ...................................................................................... D-59
4.4 Command Codes .......................................................................................... D-61
4.4.1 Code and Associated Functions ..........................................................D-61
4.4.2 Functions and Associated Code .......................................................... D-64
d-v
Table of Contents
4.5 Menu Commands ......................................................................................... D-67
4.5.1 Top Line Menus ..................................................................................D-68
4.5.2 Pop-up Menus ......................................................................................D-70
4.5.3 Bottom Line Menus ............................................................................. D-70
4.6 Mouse Motion Commands ...........................................................................D-71
4.6.1 First Mouse Motion Command ...........................................................D-71
4.6.2 First Mouse Motion Subcommands ....................................................D-72
4.6.3 Second Mouse Motion Command .......................................................D-73
4.6.4 Other Mouse Motion Parameters ........................................................ D-74
4.7 Mouse Sensitive Window Points .................................................................D-75
4.8 Mouse Button Commands ............................................................................D-76
4.9 Key Commands ...........................................................................................D-77
Chapter 5 How POINT is Displayed
D-81
5.1 The POINT Screen on your Monitor ...........................................................D-82
5.1.1 The Main Screen ................................................................................. D-82
5.1.1.1 The Top Line ..............................................................................D-82
5.1.1.2 The Working Area ...................................................................... D-82
5.1.1.3 The Bottom Line ........................................................................D-82
5.1.2 The Selection Screen ...........................................................................D-83
5.1.2.1 Top Line .....................................................................................D-83
5.1.2.2 Work Area ..................................................................................D-83
5.1.2.3 Bottom Line ................................................................................D-83
5.1.3 The Color Option Screen .................................................................... D-83
5.2 The Window on your POINT Screen ...........................................................D-84
5.2.1 The Banner Line ..................................................................................D-84
5.2.1.1 The SAVB Message ...................................................................D-84
5.2.1.2 The File Name ............................................................................ D-84
5.2.1.3 Line and Column Numbers ........................................................ D-85
5.2.1.4 The OverType Message .............................................................. D-85
5.2.1.5 The Banner Line Fill Character ..................................................D-85
5.2.1.6 Banner Line Mouse Commands ................................................. D-85
5.2.2 The Border .................................................................................. ~ ....... D-86
5.2.3 The Elevator ........................................................................................D-86
5.2.4 The Comers .........................................................................................D-86
5.3 The Text in your POINT Window ............................................................... D-87
5.3.1 Displayed Text ....................................................................................D-87
5.3.2 Displayed Characters .......................................................................... D-87
d - vi
Table of Contents
5.3.3 The End-of-line Character ..................................................................D-87
5.3.4 Selected Text ....................................................................................... D-88
5.3.4.1 Select Text .................................................................................. D-88
5.3.4.2 Select Words and Lines .............................................................. D-89
5.3.4.3 Extend the Selection ................................................................... D-89
5.3.4.4 Select the End-of-line ................................................................. D-89
5.3.4.5 Delete Text ................................................................................. D-90
5.3.4.6 Delete Text, Not to Scrap ........................................................... D-90
5.4 Input from your keyboard to POINT ...........................................................D-91
5.4.1 Insert Text Characters .........................................................................D-91
5.4.1.1 The Insertion Point .....................................................................D-91
5.4.1.2 Insert and Overtype Modes ........................................................ D-91
5.4.1.3 Backspace over Text ..................................................................D-92
5.4.1.4 Insert ASCII Characters .............................................................D-92
5.4.2 Enter a response ..................................................................................D-93
5.4.2.1 Respond to a Prompt .................................................................. D-93
5.4.2.2 Select a File Name ...................................................................... D-93
5.4.2.3 Options ....................................................................................... D-94
5.4.2.4 Set Screen Colors ........................................................................D-94
5.5 File Handling in POINT ...............................................................................D-95
5.5.1 Files in Windows .................................................................................D-95
5.5.2 Backup Files ........................................................................................D-95
5.5.3 File Handles .........................................................................................D-95
5.5.4 Feedback On Long Operations ............................................................ D-96
5.5.5 Read-Only Files ...................................................................................D-96
d • vii
Table of Contents
Chapter 6 POINT Commands
D-97
6.1 Invoking POINT ..........................................................................................D-97
6.2 Command Format ........................................................................................D-99
6.2.1 Esc and Ctrl-Break .............................................................................. D-99
6.3 Window Management Commands .............................................................D-I00
6.3.1 Create a New Window ......................................................................D-I00
6.3.2 New Window From Selection ........................................................... D-I00
6.3.3 Hide Window ...................................................................... ~ ............. D-I00
6.3.4 Close \x/i.TIdo\v .............................................. ,', .. "" ............................D-I0l
6.3.5 Close Window and Save File ............................................................ D-I0l
6.3.6 Split Window .................................................................................... D-I01
6.3.7 Change Color Combination in Window ............................................ D-10l
6.3.8 Window Positioning ..........................................................................D-102
6.3.8.1 Top Window .............................................................................D-102
6.3.8.2 Bottom Window ....................................................................... D-I02
6.3.8.3 Top/Bottom Window ................................................................D-102
6.3.8.4 Zoom Window ..........................................................................D-102
6.3.8.5 Change Window Size ...............................................................D-I02
6.3.8.6 Stretch Window ........................................................................D-I03
6.3.8.7 Move Window .......................................................................... D-I03
6.3.8.8 Exchanging The Top Two Windows ........................................ D-103
6.4 File Management Commands ....................................................................D-l 04
6.4.1 Load File ........................................................................................... D-104
6.4.2 Load File From Selection ..................................................................D-I04
6.4.3 Save File ............................................................................................D-I04
6.4.4 Save All Unsaved Files ..................................................................... D-I04
6.4.5 Write With New Name ...................................................................... D-I04
6.4.6 Toggle Read-Only Status of File ......................................................D-I05
6.4.7 Scroll Down .......................................................................................D-I05
6.4.8 Scroll Up ........................................................................................... D-l05
6.4.9 Scroll Left. .........................................................................................D-I05
6.4.10 Scroll Right .....................................................................................D-I06
6.4.11 Thumb Vertical ...............................................................................D,..106
6.4.12 Thumb Horizontal ...........................................................................D-106
6.4.13 Search For String .............................................................................D-I06
6.4.14 Search For Selection........................................................................D-107
6.4.15 Search Backwards ...........................................................................D-I07
6.4.16 Replace String ................................................................................. D-I07
6.4.17 Beginning ofFile ............................................................................. D-107
6.4.18 End of File .......................................................................................D-I07
d-viii
Table of Contents
6.4.19 Beginning of File and Move Selection ............................................ D-10S
6.4.20 Go To Line Number ........................................................................D-10S
6.4.21 Go To Selected Line Number.. ........................................................D-10S
6.4.22 Go To Last Place .............................................................................D-1 OS
6.4.23 Go To Selection ...............................................................................D-10S
6.4.24 Find Matching Bracket. ................................................................... D-10S
6.5 Menu Commands .......................................................................................D-109
6.5.1 Top line Commands ..........................................................................D-109
6.5.2 User Menus ....................................................................................... D-109
6.5.3 TOPLIST Menu .................................................................................D-110
6.5.4 OP1'IONS Menu ................................................................................ D-110
6.5.4.1 Interactive Color Settings .........................................................D-11 0
6.5.4.2 Redefine Keys, Buttons and Mouse Motion Commands ......... D-112
6.6 Mouse Motion Commands ......................................................................... D-114
6.6.1 Issuing a Mouse Motion Command .................................................. D-114
6.6.2 Canceling A Mouse Motion Command ............................................D-114
6.6.3 Default Mouse Motion Subcommands .............................................. D-115
6.6.4 Second Mouse Motion Command ..................................................... D-116
6.7 Editing Commands .................................................................................... D-117
6.7.1 Copy and Move ................................................................................. D-117
6.7.1.1 Copy..........................................................................................D-117
6.7.1.2 Copy To Scrap .......................................................................... D-11S
6.7.1.3 Copy from Scrap Buffer ........................................................... D-llS
6.7.1.7 Duplicate................................................................................... D-11S
6.7.2 Move ................................................................................................. D-119
6.7.2.1 Move Text ................................................................................ D-119
6.7.2.2 Extract .......................................................................................D-119
6.7.3 Redo and Undo ..................................................................................D-120
6.7.3.1 Redo ..........................................................................................D-120
6.7.3.2 Reversible Undo ....................................................................... D-121
6.7.3.3 Undo, Erase History ................................................................. D-121
6.7.4 Keyboard Macros .............................................................................. D-122
6.7.4.1 Begin/End Recording Macro Keystrokes .................................D-122
6.7.4.2 Play Back a Keyboard Macro ...................................................D-122
d - ix
Table of Contents
6.8 Quit Commands .........................................................................................D-124
6.8.1 Quit-Ask About Files ........................................................................ D-124
6.8.2 Quit-Save Files .................................................................................. D-124
6.8.3 Quit-Discard Edits .............................................................................D-124
6.9 Execute DOS Commands ..........................................................................D-12S
6.9.1 DOS Command Window ..................................................................D-12S
6.9.2 DOS Command Shell ........................................................................ D-12S
6.10 Miscellaneous Commands .......................................................................D-126
6.10.1 Invoke Help .....................................................................................D-126
6.10.2 Toggle 43-1ine Mode .......................................................................D-126
6.10.3 Fill Lines To RightMargin .............................................................. D-126
Appendices
Appendix A
Appendix B
Appendix C
Appendix D
Appendix E
Appendix F
POINT Features ...........................................................................D-129
Command Numbers ..................................................................... D-131
POIN"T Extensions ....................................................................... D-137
The M2ASSIST Environment .....................................................D-139
Non-Mouse Reference .................................................................D-14S
Quick Reference ...........................................................................D-149
Index
D-157
d·x
POINT EDITOR
Introduction
Introduction
This introduction gives you an overview of the POINT Editor, and tells you how to read
the manual, as well as providing some information about LOGITECH products and
product support.
How the POINT User's Manual is Organized
This manual assumes that you are familiar with the basics of DOS and with basic
programming concepts and terminology.
This manual includes:
•
•
•
•
Introductory information with system requirements and installation instructions.
A step-by-step tutorial through the POINT Editor in Chapters 1 and 2.
A complete reference for the POINT Editor in Chapters 3 through 6.
Supplements and Quick Reference Guides in the Appendices
•
An index.
If you are a beginner, work through the tutorial to get started using the POINT Editor.
Then consult the reference chapters for more detailed information.
D -1
Introduction
How to Read This Manual
The following conventions are used in this manual:
Keys to be pressed, look like this:
(Y)
[Esc)
e;[)
Control sequences or characters entered with a Control or Shift key, look like this:
Keys from the Numeric Keypad are shown like this:
CDCDBB
~~[±J
G
Keyboard input for the DOS Command line is in upper case and looks like this:
PTe;[)
Mouse buttons used are based on the LOGITECH standard, and use three buttons, e.g,
• 0 0
o D.
o• 0
means press the left mouse button,
means press the right mouse button, and
means press the middle mouse button.
( • • 1 refers to the middle button as implemented on a two button mouse.
File names look iike mis:
PT.INI
D·2
Introduction
DOS commands and statements look like this:
PATH,COPY
Product names look like this:
MS DOS, IBM PC
Screen output and some listings look like this:
Program Not Found
Program code looks like this:
IF condition THEN
statement6;
ELSIF condition THEN
statement 7;
ELSE
statementS;
END;
Sample Screens look like this:
open close HELP +next prev +WINDOW EDITING MOVING QUIT+ETC OPTIONS TOPLIST
POINT Editor Version n.n
copyright 1987 LOGITECH Inc. All Rights Reserved
D-3
Introduction
LOGITECH Policies and Services
LMIS
We know that effective communication with our customers is the key to quality service.
Therefore we have set up the LMIS (LOGITECH Mouse Information Service), an
electronic bulletin board where you can contact us at your convenience.
To reach the LMIS, dial:
(415) 795·0408
using a 300, 1200 or 2400 baud modem.
The menu of available options is self explanatory.
BIX
LOGITECH also sponsors an electronic conference on BIX, the BYTE INFORMATION
EXCHANGE system from Byte magazine. If you have access to BIX, join us in
conference LOGITECH,
and communicate with us there.
Getting Help through the Hotline
You should rely on your manual or your dealer to answer questions about using your
package. If you do encounter a technical problem with your package, our Technical
Support Specialists will be glad to help you.
We ask you to follow these steps before you call or write.
•
•
Read the section of the manual that describes the procedure you are trying to perform.
If the problem relates to your software, check to make sure that the software is
properly configured.
If, after following these steps, you are still not able to solve the problem, give us a call at
(415) 795-0427, or write to us. If you write, please include your daytime phone number
and the best time to reach you. Also, please add "Attn: Technical Support" somewhere
on the envelope.
We want to help you make the most effective use of your package.
D·4
Introduction
Other LOGITECH Products
At LOGITECH we pride ourselves on technical excellence and advanced engineering.
In addition to the POINT Editor, we offer these fine products which we believe to be the
most advanced in their product categories.
LOGITECH Modula-2 Development System
The LOG/TECH Modula-2 Development System gives you the most powerful
software development environment available for your PC:
•
•
•
•
The LOGITECH Modula-2 User's Manual with tutorials, a Compiler that
generates standard .OBJ files, a Symbolic Post-Mortem debugger, and a
complete listing of the LOGITECH Modula-2 libraries.
The LOGITECH Modula-2 Toolkit includes the enhanced LOGITECH
Linker, a Symbolic Run-Time Debugger, and the perfect combination of
utilities to optimize both your development environment and your Modula-2
code.
The LOGITECH Turbo-Pascal To Modula-2 Translator.
A VAXIVMS version of LOGITECH Modula-2.
Site licenses are available for all LOGITECH M odula-2 products.
The LOGITECH C7 Mouse
The LOGITECH C7 Mouse connects to a serial port in your computer.
It needs no pad and no external power supply.
The LOGITECH Bus Mouse
The LOGITECH Bus Mouse is equivalent to the LOGITECH C7 Mouse,
except that it is connected to a Bus Board which you insert in your computer.
It needs no pad and no external power supply.
For additional information, or to order these products, call the LOGITECH sales office
toll-free from anywhere in the continental U.S. at (800)231-7717, or
in California, call (800) 552-8885.
D-5
Introduction
Notes:
D·6
Installation
Installation
This chapter tells you how to install the POINT Editor on your system and create an
optimal environment for your editing tasks.
What You Need
To install the POINT Editor you need:
An IBM PC/XT, AT, PS/2 or compatible computer, with
• 256 K RAM memory (POINT Editor uses 140 K)
• Two (2) 360 K disk drives, or a hard disk and at least one (1) 360 K disk drive.
• PC DOS or MS DOS 2.0, or above.
•
•
A LOGITECH mouse is definitely recommended.
If you are not using a mouse, refer to Appendix E for instructions on keyboard
emulation of mouse actions.
~------------------I(IMPORTANT)------------------~
READ.ME on one of your LOGITECH disks has information about this version
of the POINT Editor that was not available when the manual was prepared.
D·7
Installation
POINT Files on Disk
The following POINT files are on your LOGITECH distribution diskette.
*
PT. EXE
*
PT.INI
*
PT.MSG
*
PT .HLP
*
The executable file for the editor.
The initialization file.
The message file, contains a one line description for each command.
The help file, gives an extensive summary and detailed descriptions
of commands and menus.
indicates files needed to run POINT.
Additional files issued with the POINT Editor are used as follows:
COLOR.INI
MONO.INI
The color initialization file.
COLOR.INI to PT.INI.
If you have a color monitor, copy
The monochrome initialization file, this file as well as the original
PT.INI is set up for monochrome monitors (also for black and white
monitors running with the color card).
If YOii havc Uccn usillg a l:ulur IIluniior and must now use a
monochrome monitor, copy this file back into PT.INI.
PTEXPERT.INI
The expert user initialization file. Copy this file into PT.INI when
you are more familiar with the POINT Editor.
Alternate .INI files can be copied to the name PT.INI for customizing
your POINT system. See Chapter 4.
READ.ME
This file contains information that was not available when POINT
documentation was prepared.
D -8
Installation
Installation Procedure
~------------------------NOTE------------------------~
Before you install your software to either floppy drive or hard disk system,
we strongly recommend that you take a minute to:
1)
Put Write-Protect tabs on all your LOG/TECH diskettes, and
2)
Use the DISKCOPY and DISKCOMP commands from your DOS files to
back up your diskettes. Then put your original diskettes in an archival area
and use the copies for all installation.
3)
Prepare formatted diskettes with readable labeling, before you copy the the
files in the Installation procedure which follows.
Hard Disk System
If you have a hard disk, run the INSTALL program from drive A. It will transfer the
appropriate files to the directory you specify, or to a default directory.
Floppy Disk System
For a floppy diskette system, format a target diskette with your DOS system for drive B.
Then put the copy of your LOGITECH diskette into drive A, and type,
A:INSTALLQ]
D -9
Installation
Configure Your System
Set File Handles
You can edit several files at once. POINT lets you include up to 20 file names on the
command line when you invoke PO INT. A file handle is needed to work with each file.
If you plan to edit several files at the same time, be sure you have enough file handles.
Put tbis line in your CONF!G.SYS file:
FILES=30
This gives you 30 file handles instead of the default of 8. The resident part of DOS is
only increased by 40 bytes for each file above 8. This is more than enough for most
purposes.
Load Your Mouse Driver
Before you run POINT, if you have a mouse, load your mouse driver.
MOUSE.COM or MOUSE.SYS. Refer to your mouse manual for instructions.
Use
If you don't have a mouse, refer to the non· mouse equivalent tables in Appendix E.
POINT and Your Monitor
If you have a monochrome or Hercules compatible display, leave PT.I N 1 as it is on the
diskette or in the current directory.
If you have a color display, copy the COLOR.lNI file to PT.INI on the diskette or in the
current directory.
If you have a color graphics adapter you may see display interference (snow) on the
screen. Press ~ and ~ to check for display interference on the screen. If you
see display interference, reset the videoMode option. To reset the videoMode you will
have to change one parameter in the PT.INI file. Refer to Section 4.3.
D ·10
Begin the Tutorial
Chapter 1
Begin the Tutorial
Welcome to the POINT tutorial.
When you finish this chapter you will know how to load the POINT program files, how
POINT screens and menus work, and how to manipulate windows and files with the
POINT Editor.
If you haven't done the setup procedures, go back now and configure your system so you
can understand what follows.
Remember to include the POINT sub-directory in your PATH statement and make sure
you are in the POINT sub-directory before you begin this tutorial.
D -11
Chapter 1
1.1 Load the POINT Editor
To load the POINT Editor, type:
PT
GiJ
You will see the initial POINT screen. The top line of the screen is the main menu, the
body of the screen is the work area (for loading and editing files), and the bottom line
(when you first call the POINT Editor) displays the version and copyright notice:
open close HELP +next prev +WINDOW EDITING MOVING QUIT+ETCOPTIONS TOPLIST
POINT Editor version n.n
Copyright 1986 LOGITECH Inc. All Rights Reserved
~-------------------------NOTE------------------------~
To quit the POINT Editor and return to DOS, press ~
Since this is a tutorial, don't exit just yet. If you have exited, please re-start the editor.
Refer to Section 6.8 for more information on quit commands.
D -12
Begin the Tutorial
1.2 The Parts of the Screen
When the POINT Editor starts, it creates a screen with:
•
•
•
The main menu at the top of the screen;
A blank work area where one or more windows can be opened and edited;
A comment line (with the copyright notice) at the bottom of the screen.
~-------------------------NOTE--------------------------~
The comment line alternates between simple help reminders and command
prompts. It changes when you move the cursor to the top line of the screen.
Occasionally it disappears entirely.
Move the blinking cursor along the main menu at the top of the screen. Observe
how the copyright notice disappears from the comment line and is replaced by
a short description of commands.
1.2.1 Cursor, Selection, and Insertion
There are three primary primary functions on your POINT screen:
Selection cursor
A blinking square that can be moved by the mouse - or, if
you have no mouse, by keypad cursor keys - to either select
a new insertion point, or so select a command outside the text
window. The new selection or command is then implemented
with (. 0 D) (and sometimes also with I0 0 .) ).
Selection
An area of text that is highlighted for purposes of
manipulation, or for indicating the insertion point.
Insertion point
The area at the beginning of the selection at which new
characters appear from your keyboard, or as the result of a
move or copy operation from another area of text (from the
same window, or even from a different file in another
window).
One last word here: the insertion point is set either to add
characters at the insertion point (OverType=O) or to replace
existing text with new text (OverType=l).
D -13
Chapter 1
1.2.2 The Main Menu
The main menu is on the top line of the screen. It contains pull-down menus and
commands. Menus, such as WINDOWS, are in upper case, and commands, such as open,
are in lower case.
Each pull-down menu contains a list of commands and/or menus.
Each command presents choices or prompts, or performs a function.
1.2.3 The Work Area
The work area (the large blank area) of the screen is where you load and edit files.
1.2.4 Comment line
The comment line (the bottom line) displays one line comments, explanations, or
command prompts for the pull-down menus and commands that you use.
D -14
Begin the Tutorial
1.3 The HELP System
The comment line offers a simple level of help. For additional help, move the mouse
cursor to the HELP menu on the top line and click (. 0 D). A help screen will appear
which gives details on the last command executed or highlighted.
You can return to your editing session from this help screen, or get additional help. To
exit the help system, either click (0 • D) or press the ( Spacebar) ,( Esc) , or QJ. To
access the main help menu, press ~ .
From the main help menu you can get additional help screens. Use the mouse cursor to
pinpoint the subject you need. Then click the (. 0 D) mouse button, or press QJ .
A help screen with additional information will appear.
Some help screens let you access additional help screens with specific information about
particular subjects. You can access these screen by pressing a letter or key from the
More info column which corresponds to the subject matter you choose.
~ or (0 0 .) gets the next help screen, and ~ or (. 0 D) gets the previous
help screen.
If there are no more related help screens, ~ takes you back to the main help menu.
From this menu you can access any of the help screens, or exit the help system.
1.3.1 Yes/No Questions
When answering yes or no questions, either Y (yes) or N (no) is shown as a default
answer. You can accept the default with the QJ key. Or, you can press (Y) or (ill as an
answer, without pressing QJ .
You can also use the mouse to answer Yes/No questions: simply move the mouse cursor
to the bottom of the screen. Then press (. 0 D) for Yes or [0 0 .) for No. The mouse
cursor must be on the bottom line to be able to answer yes or no.
D -15
Chapter 1
1.4 Look at Menus
The following exercises show screen layout and available commands.
1.4.1 Open a File
Let's explore menus and screen options by opening a window and loading a file.
Step 1: Put the cursor on open on the main menu. Now click ( _ 0 0 Itwice.
A screen appears, with:
•
•
•
•
Directory and file information on the top line
Additional commands on the second line
A list of the files in the current disk drive and directory
A prompt which lets you enter a file name from the keyboard.
CD=c:\tamp
Cancel load
drive
Pattern=*.*
HUmber
o~ ~i1e.=*
Next page
Previous page
C1ick on a command (above, CLICK on a
.. \
~i1e
New pattern
change
name (be1ow), or TYPB in the nama .
read.me
Step 2:
Place the mouse cursor on read. me. Click I_ 0 0
I.
The file you just selected now appears inside a window in the work area. Now
you can explore the rest of the the POINT system. For this tutorial we will use
this READ.ME file from the POINT sub-directory.
D ·16
Begin the Tutorial
1.4.2 Explore a Pull-down Menu
The following steps show you how to choose a command from a pull-down menu.
Step 1: Move the mouse cursor to the top line of the screen and put the it a menu.
WINDOWS, EDITING, MOVING, QUIT+ETC, OPTIONS, and TOPLIST are
menu names.
Step 2: Press and hold the (. 0 D) mouse button on the menu name you have selected.
This pulls down a menu under the selected menu name.
Step 3: While pressing (. 0 D) , "drag" the cursor into the pull-down menu and down
the screen.
Menu items are highlighted as you move the cursor inside the menu. Notice
how the comment line changes to reflect the highlighted command inside the
menu.
Step 4: Move the cursor outside the menu and release the button. This releases the
menu without executing a command.
~---------------------NOTE----------------------~
To choose and execute a menu command, release the button when the
desired command is highlighted.
D -17
Chapter 1
1.5 Create a New Window
In this exercise you will create a new window, and load a file into that window. This
procedure is similar to the open command, but is done from the WINDOWS menu.
Leave the READ.ME file on the screen.
Step 1: Select WINDOWS and then drag the mouse cursor down the screen to highlight
New Window. The following message appears on the comment line:
Press the left mouse button at one corner.
Step 2: Put the mouse cursor in the middle of the screen and hold down the (. 0 0] .
Move the cursor to the lower right screen corner. An elastic window border
follows the mouse cursor until you release the button. You have just defined the
position and size of the window on the screen.
~----------------------NOTE----------------------~
If you double click at the upper left window corner, the lower right
window corner goes automatically to the lower right corner of the screen.
The new window then covers the current window. Don't worry: the
READ.ME file is still there. Go on with the remaining steps. Later you
will see how to handle overlapping windows.
Once you choose the two corners, you are shown a screen with a
selection of file names from the current directory.
Step 3: Select a file to load into the window by clicking on it with (. 0 0 ) ,
or by typing the file name on the keyboard at the comment line prompt.
For this tutorial, type in BRAND.NEW from the keyboard. As you type in the
characters they appear at the end of the comment line. When the name is
complete, press QJ .
Step 4: You return to the editing screen and are asked to confirm the file creation with a
'y'.
When you type (y) , a window appears with the borders you defined in Step 2.
D -18
Begin the Tutorial
1.5.1 Look at the Parts of the Windows
Take a minute to look at the windows you now have on the screen.
~------------------------NOTE------------------------~
If and ONLY if your windows are overlapping, go to Section 1.9, Reshape a
Window.
Follow those procedures to resize the overlapping window.
Then return here and continue.
Each window has a banner line, an elevator, and a border.
Each banner line (at the top of the window) has:
•
•
The name of the file in the window.
The line and column ranges in that window.
Each window elevator (in the left border) shows:
• Where in the file you are currently looking.
• How much of the file is being displayed.
The window border shows which is the active window:
•
•
•
The current or active window has a double line border. (See Section 5.2.1)
The active window is affected by POINT commands.
An inactive window has a single line border.
Put the mouse cursor on the READ.M E window. Click (. 0 D) . The READ. ME
window is now active.
Toggle between the two windows on the screen by clicking on the banner line of each
window. As you do this, see how the borders change.
D -19
Chapter 1
1.5.2 Close the Window
When you finish editing a file, clear it from the working area.
Step 1: Make the READ.ME window active.
Step 2: Now, close the window in one of three ways:
•
Use [_ 0 0 Ito pull down the WINDOWS menu;
release it on Close Window.
•
Click I_ 0 0
•
PressOO@.
J
on close on the top line.
Each method closes the active window and clears it from the screen. The BRAND.NEW
window is left on the screen, and automatically becomes the active window.
If the window to be closed has been edited, a comment line prompt shows the drive, the
path name if any, and the file name, along with the option to save or discard edits.
The default is CYJ to save. For this tutorial press (}D .
D - 20
Begin the Tutorial
1.6 Open Multiple Windows
Multiple windows are useful when editing several files. Now you will open multiple
windows and see how they exist simultaneously on the screen.
Step 1: Select WINDOWS with the mouse cursor and choose New Window. A message
on the comment line asks you to:
Press the left mouse button at one corner
Step 2: Press and hold ( _ 0 D) near the upper left comer of the screen. An elastic
window border will follow the mouse cursor until you release the button at the
lower middle section of the screen. When the list of file names appears, type:
READ.ME
QJ
Step 3: Repeat Step 1 and Step 2; only this time define the window, starting from the
upper right hand comer.
You now have three windows on your screen: two loaded with the file
READ.ME and one with BRAND.NEW.
Step 4: If only two windows are visible on the screen, put the mouse cursor on
TOPLIST and hold down the (_ 0 0] mouse button, or press ,_ 0 _j or , __ ]
or (0 _ 0] to view the list of files loaded in windows.
D·21
Chapter 1
1.7 The TOPLIST Menu
1.7.1 The Active Window
When you have several windows on the screen, you need to find the active window, i.e.,
the window affected by menu and keystroke commands. Only one window can be active.
It has a double-line along the borders and in the banner. Non-active windows have single
li.lle borders and use blank fill characters in the banner.
To set the active window:
(. 0 0] anywhere along the banner of any window.
1.7.2 Overlapping Windows
POINT lets windows overlap and obscure other windows. Think of the windows as
sheets of paper on the screen. The top page can be seen completely and the lower pages
may be partly or wholly hidden by windows above them. You can choose windows by
clicking (. 0 0 ) on any window corner.
This moves a window to the top of. the stack, but does not change its position on the
screen. If the window is already the top window, this sends it to the bottom of the stack.
OO@also sends the active window to the bottom of the TOPLIST stack.
TOPLIST makes it easy to switch between windows. TOPLIST also makes it easy to
K" =
"Command Name", or whatever title you choose is what you want to see in the menu on
the screen. It can have spaces within the quotation marks, but not around the "=" or
within . It can use any of the 256 characters in the IBM PC extended
character set.
is the POINT command number as listed above.
A menu can contain up to 24 items (that's all that will fit on the screen). The "Command
Name" can be as long or short as you want although there is a limit of 1400 characters for
all names in all menus.
D-67
Chapter 4
The first menu item is treated differently from the rest. The "command name" of the first
item is taken to be the title of the menu. If you don't want a title, you can use an empty
string ( " n). Top line menus do not use titles, so their title should be empty.
Remember, though - the first item is the title item, even for top line menus.
The command number of the title item is the command for the menu. This is the
command that will be executed if you do not select any menu item. Normally this is
called the null command. Use a command number of -1 or 0 for the null command.
See the .INI files on your POINT diskette for examples of menu specifications.
~-------------------------------------------------NOTE--------------------------------------------------~
Do not include angle brackets < or > or spaces in the string, or around
the = sign. Strings like the above must be separated from other strings of the
same type by one or more blanks, tabs, or new lines.
4.5.1 Top Line Menus
To specify a top line menu (as defined above), include a line in PT.INI with this format:
tXY=
where nn is (as before) a POINT command number.
To specify a menu, use one of the menu command numbers: 50, 51, 52, 60, 65, or 67.
You can use either an upper case "T" or a lower case "t".
"x" tells whether you want to alter the state of the CD-l 0 0 0] that calls this menu.
"x" is a digit from 0 - 7 which is a shift key code. The codes are:
X Code
Shift state specified
o
3
( 1tShift] , (Ctrl), and
[1tShift) down
[Ctrl] down
( 1tShift HCtrl] down
4
00 down
5
6
7
[ 1tShift HAlt) down
@!ill-(ID down
(1tShift H Ctrl HAlt] down
1
2
00 keys are all up
D - 68
Initialization Files
"y" is the state of the mouse button keys you require to be down to invoke this menu.
"y" is also a digit from 0 - 7.
YCode
Button state specified
(_0 oj
(00_]
(_0_]
[0_0]
1
2
3
4
5
6
7
( __ 0]
(0 __ ]
( ___ ]
The menu is invoked if the o=J-lo 0 0] matches the "XY" you specify. To have
several different combinations, include several tXY= lines in PT.INI
with the same , one for each combination.
You can specify several different menus as top line menus. The one with the lowest
hexadecimal "XY" number is the default menu, and is displayed first.
If you move the mouse cursor to the top line and press a button, the appropriate menu for
that o=J-l 0 0 D) will appear. No action takes place until you release the button. You
can change buttons while on the top line to look at the menus available. If you move the
mouse cursor from the top line before releasing the buttons, the default command of the
menu will be executed. It is safest to make this a "do nothing" command. If you have
only one top line menu, the menus and commands on it will be executed when you press
the correct mouse button on the top line.
For example, the following line in PT.I N 1uses menu 1 as the top line menu. (Command
number 50 is menu 1).
t01=SO
If you specify a non-menu command number as a top line menu number, then that
command will be executed when POINT detects the specified o=J-lo 0 0] at the top
line of the screen. Thus, you can program certain commands to be invoked at the click of
a mouse button on the top line. For example, to invoke New Window whenever you click
(0 0 _] on the top line, specify:
t02=7
D - 69
Chapter 4
4.5.2 Pop-up Menus
You can also tell a menu to pop up whenever you press certain CD-l D D D)
combinations, either inside or outside a window. Specify a pop-up menu as follows:
bXY=commandNumber
where "XY" and "commandNumber" are as described in top line menus above. Top line
menus are called when the correct CD-l D D D) combination is seen while the mouse
cursor is on the top line of the screen. These pop-up menus are invoked when the correct
CD-l DO D) combination is seen and the mouse cursor is inside any window or
outside all windows.
For example, look at the following lines in PT.INI:
bOl=50 menu 1 (command #50) to pop up when you press (. D D j
b02=51 menu 2 to pop up when you press [D D
.j, and
b03=52 menu 3 to pop up when you press (D • D J ,
(or (• • ) on a 2-button mouse).
4.5.3 Bottom Line Menus
You can also place your "top line" on the bottom of the screen, if you wish. Specify
bottom line menus in exactly the same way as top line menus only use "1" or "L" instead
of lit" or "T" as follows:
lXY=
Everything else is the same as top line menus.
You cannot mix top line and bottom line menus. The menu that POINT sees first
prevails. You will get error messages on menus that are not of the same type (either top
or bottom), and they will be changed to the first type encountered.
D·70
Initialization Files
4.6 Mouse Motion Commands
4.6.1 First Mouse Motion Command
The command number for mouse motion is 45.
[0 • 0) does this with the following line in PT.INI:
b04=45
If you use a two button mouse, attach mouse motion to [0 • ) with the line:
b02=45
If you attach the mouse motion command to [0 0 .) , change the NO MOTION
subcommand to extend so as not to lose the ability to extend the selection with the
mouse. Then [0 0 .) will act almost as it did before except you will be able to issue
mouse commands with it also. What you will lose is the ability to drag the selection
when extending it (that is, pressing (0 0 • ) and moving it to adjust the selection). It is
not usual to do this anyway so the actual loss of function is small and the gain of having
eight other mouse motion commands immediately available with (0 0 .) is great.
D -71
Chapter 4
4.6.2 First Mouse Motion Subcommands
Subcommands can be changed in PT. IN I with lines of the form:
mN=commandNumber
where N is in a range from 0 to 8 as in the chart below:
N[l)
NW[8)
\
I
I
NE[2)
/
\
I /
W[7) <---- [0) ----> E[3)
/
I \
/
I
\
SW[6)
I
SE[4)
S[5)
To change the no motion action to extend use:
mO=39 -
39 is the extend selection command
Here are some other change ideas:
m3=29 m7=57 -
Right motion bottoms the window
Left motion copies the selection to the scrap
D-72
Initialization Files
4.6.3 Second Mouse Motion Command
[Command #46]
Default subcommands of the second mouse motion command are:
move to
last place
I
close
window
deleteno scrap
I
\
I
I
\
I
I
copy to <--- extend ---> exchange
scrap
I
I \
with scrap
I
I
I
I
\
I
I
bottom
window
\
cancel
TOPLIST
The command numbers are:
extend
move to last place
delete/no scrap
exchange with scrap
cancel
TOPLIST
bottom
copy to scrap
close window
#39
#56
#61
#62
#22
#53
#29
#57
# 17
The second mouse motion commands can be changed in PT.INI with lines of the form:
nN=commandNumber
where N is 0, 1,2,3,4,5,6, 7, or 8 as in the chart above.
D-73
Chapter 4
4.6.4 Other Mouse Motion Parameters
You can also adjust POINT parameters to decide mouse motion direction.
Parameter 1 chooses between north and northeast. Parameter 3 chooses between
northeast and east. We will talk about parameter 2 later. These parameters are the ratio
of the number of rows you moved north and the number of columns you moved east
multiplied by 100 so that they are integers. The default values are 175 and 25.
Set these values in PT.INI. The default values are:
ql=175
q3=25
Experiment with these values if the defaults do not seem natural to you. These same
parameters are used for the four other quadrants of the plane.
If you specify the diagonal commands to be ·1 or 31 (no action), POINT uses the nearest
vertical or horizontal command. This can be used to reduce the possible motions to just
four: north, east, west, south and no motion. Parameter 2 is used in this case to decode
between north and east. The default value is 45 which is about a 45 degree angle. (That
they are both 45 is a coincidence.)
D·74
Initialization Files
4.7 Mouse Sensitive Window Points
You can decide (via lines in PT.INI) what command is executed when certain mouse
buttons are clicked on parts of a window. Those you can change are listed below with
the string used to set them in PT.INI enclosed in [square brackets].
[wtlm]
[will]
[wtrm]
[wtrl]
[wblm]
[wbll]
[wbrm]
[wbrl]
[wrbl]
[wrbr]
[0 _ O)or(_ 0 _)
(_DO)
[0 _ O)or(- 0 _)
[_DO)
(0 _ o)or(_ 0 _)
[_DO)
[0 _ O)or(- 0 _)
[_DO)
(_DO)
[00_)
top left corner
top left corner
top right corner
top right corner
bottom left corner
bottom left corner
bottom right corner
bottom right corner
right border
right border
Set these commands with lines in PT.lNI of the form:
wtlm=88
wtrm=88
wblm=88
wbrm=88
wtll=28
wtrl=28
wbll=28
wbrl=28
wrbl=27
wrbr=66
(exchange the top two windows)
(top!bottom the window)
(search for selection)
(search backwards for the selection)
These lines also indicate default commands: [0 _ D) on any corner swaps the two top
windows, [. 0 0 ) on the right border searches up for the selection and (0 0 .) on the
right border searches down for the selection.
•
You may want to let (0 _ D) on the top left corner be the Beginning of File and Move
Selection command (see Section 3.2).
D·75
Chapter 4
4.8 Mouse Button Commands
The method described in the previous section can be used to assign any command (not
just a menu) to a
0 0 D) combination. This is most often used to assign the
select, extend, copy, and move functions to mouse buttons inside windows.
o=H
For example, the lines below assign select to (. 0 D) , extend to [0 0 .) , copy to
~. 0 OJ, and move to@!ill-l. 0 D).
bOl=26
(.00)
b02=39
[DO.)
bll=69
~.ool
b21=70
@!ill-I. 0
0
I
select
extend
copy selection to here
move selection to here
The .1 N1 files on your disk contain examples of defined menus and functions assigned to
top line menus and pop-up menus. They also suggest ways to effectively use these menu
definition facilities. Start by using these .I N1 files, and modify them as you gain
experience.
•
D -76
Initialization Files
4.9 Key Commands
You can assign POINT commands to any key. However, the standard DOS keyboard
handler does not let you reset certain key combinations (e.g., @!ill-(}] and @@-CD ).
In addition, certain keys are intercepted by DOS before the POINT Editor sees them.
Define keys with a line in PT.INI of the form:
kN=
Either "k" or "K" tells POINT that a key is about to be defined, N specifies the key being
defined, and is a POINT command number as defined above. To
define an ASCII code, let N be the ASCII character, specified as a decimal number.
Use any ASCII chart (as in Appendix G of the IBM PC BASIC Manual) to find the
character codes. We include one here also.
To define one of the other keys on the PC keyboard (such as ~ , ( Dell, I~l , etc.)
start N with the zero (0) digit and then the extended code number of that key. We also
list them here for your convenience. The initial "0" required in N is included so that the
POINT Editor will know this is an extended key code and not an ASCII character.
A table of extended code numbers is in Appendix G of the IBM PC BASIC Manual.
Let's look at some sample lines that might appear in PT.INI. These lines redefine three
keys.
kOS9=7
calls New Window
k14=7
calls New Window
k082=S9
toggles between overtype and insert modes
The following tables shows command functions that can be attached to keys as defined in
the PT.INI file.
The format for this definition is
k=
where
k or K indicates that a key is about to be defined,
is one of the key codes defined in Section B.t, and
is a number defined in Section B.2.
D-77
Chapter 4
ASCII
Code
ASCII
Code
Character
32
33
(Spacebar)
1
2
34
3
4
5
6
6
7
8
35
#
36
37
$
%
&
Character
o
!
38
39
40
(
)
41
42
43
44
9
10
11
12
13
46
*
+
45
14
47
15
16
48
49
1
17
2
18
19
50
51
52
:lU
53
21
22
23
54
/
o
3
4
5
6
7
8
9
55
56
24
57
25
58
59
26
27
60
<
=
61
28
29
62
30
31
Ctrl
63
>
?
64
@
-
D·78
Initialization Files
ASCII
Code
Character
ASCII
Code
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
A
B
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
C
D
E
F
G
H
I
J
K
L
M
N
0
P
Q
R
S
T
U
V
W
X
y
Z
[
\
]
A
-,
Character
a
b
c
d
e
f
g
h
i
j
k
1
m
n
0
P
q
r
s
t
u
v
w
x
y
z
{
I
}
,...
@!E!}( ~
D -79
Back]
Chapter 4
Extended Code
Characters
003
NUL
015
[ 1lShift H -.1 )
016-025
030-038
044-050
059-068
00 plus @) (}Y) ([) (ID IT) 00 (Q] CD @) (f)
00 plus 0 []J [Q) (£) @) ffi) QJ fK) [)
00 plus ~ 00 @J ~ lID (ill (0
(IT) through ( F1 0 I(unshifted)
071
(Hqme]
072
CD
073
075
077
079
~
E)
B
[End]
080
CD
081
082
[In,s]
083
~
[Del]
HF1)
084 - 093
[ 1lShift
094 - 0103
@Iill®
@-(IT)
0104 - 0113
0114
[Ctrl
[Ctrl H~I
U116
ICtrIH~J
0117
[CtrIHEnd)
0118
0119
~
0132
[ 1lShift HF1 0 ]
@!ill-(TIQJ
~
HPrtSc)
0115
0120 - 0131
through
through
through
[Ctrl HHome)
00 plus OJ rn @] 0
~
D - 80
@J @)
lIJ
rn rn @) [) ~
How POINT is Displayed
Chapter 5
How POINT is Displayed
This chapter describes how text appears, screen layout, how windows appear, how text is
handled in the windows, how files are managed, and a general overview of POINT
commands.
Remember: there are three primary functions on your POINT screen:
Selection cursor
A blinking square that can be moved by the mouse - or, if
you have no mouse, by keypad cursor keys - to either select
a new insertion point, or so select a command outside the text
window. The new selection or command is then implemented
with (_ 0 0) (and sometimes also with (0 0 _) ).
Selection
An area of text that is highlighted for purposes of
manipulation, or for indicating the insertion point.
Insertion point
The area at the beginning of the selection at which new
characters appear from your keyboard, or as the result of a
move or copy operation from another area of text (from the
same window, or even from a different file in another
window).
One last word here: the insertion point is set either to add
characters at the insertion point (OverType=O) or to replace
existing text with new text (OverType=l).
D - 81
Chapter 5
5.1 The POINT Screen on your Monitor
5.1.1 The Main Screen
5.1.1.1 The Top Line
The top line of the screen contains command names and selected menus.
To select a top line command, click the (. 0 D) on the command name.
To select a menu option, move the mouse cursor to the menu line and press and hold the
[. 0 D) on a menu name. This pulls down the menu. Then drag the highlighted cursor
into the menu and release the button on the desired option.
5.1.1.2 The Working Area
The main body of the screen is the work area, where files are loaded and edited.
5.1.1.3 The Bottom Line
The bottom line of the screen initially displays the version and copyright notice. When
editing begins and a menu command in invoked the bottom line becomes a comment line.
The comment line, which alternates between simple help reminders and command
prompts, is activated when the cursor is moved to the menu line. Move the blinking
cursor to the menu line. Notice how the copyright notice temporarily becomes a
commem.
D - 82
HoW POINT is Displayed
5.1.2 The Selection Screen
When you select open or New Window from the top line of the main screen, a
selection screen displays the file names in the current working directory.
5.1.2.1 Top Area
There are three lines at the top area of the selection screen. Line one displays the
directory Patterns the files are sorted by and the Number of files in the current
directory. Line two displays command options you may invoke with the cursor.
Line three displays user information.
5.1.2.2 Work Area
The work area displays a list of file names in the current directory.
5.1.2.3 Bottom Line
The bottom line prompts for a file name to load the new window.
5.1.3 The Color Option Screen
The color option screen is invoked from the Options menu by selecting one of three
color options. The color option screen is a simple way to modify the color scheme of the
active window. If you choose colora from the OPTIONS menu, you are shown a screen
consisting of three major parts.
The Top Area is a menu line with 10 commands. Nine of these are used to select the part
of the display that you want to change the color of. The part that will be changed is
selected by clicking on its name on this menu line. The tenth command exits interactive
color setting.
The Work Area is a line with four commands and a menu of the 128 possible
combinations of foreground and background colors. Select a color combination by
clicking on it. These commands let you look at another 128 color combinations (the
alternate colors) which will either be blinking or have high-intensity background colors.
Two commands switch you between plain and alternate color sets. The other two
commands alternate the color set from regular to blinking to intense.
The Bottom Area is a sample window that shows you the effect of the changes you have
just made on the color options screen.
D - 83
Chapter 5
5.2 The Window on your POINT Screen
5.2.1 The Banner Line
The banner line at the top of each window displays:
•
•
SAVE when editing space is low.
Name of the file loaded in the window.
if the file has been changed.
Line numbers shown in the window.
Column numbers shown in the window.
OverType when POINT Editor is in overtype mode.
Unused space filled with blanks or double bars.
•*
•
•
•
•
5.2.1.1 The SAVE Message
The POINT Editor uses an "edit space" to keep track of changes: the space available here
for editing depends not on file size, but rather on the number of changes you make in the
files.
When editing space is low, SAVE appears in front of the file name in each window.
When this happens, save one or more edited files to reclaim the editing space.
5.2.1.2 The File Name
The file name displayed is exactly as you typed it (including capitalization) and may
include a PATH name. If the file in the window has been changed, a
(asterisk)
appears after the file name.
*
5.2.1.3 Line and Column Numbers
Line numbers and column numbers are given as a range. Column numbers can be useful
when scrolling horizontally.
D - 84
How POINT is Displayed
5.2.1.4 The OverType Message
OverType
shows in the banner line if keystrokes replace existing text.
5.2.1.5 The Banner Line Fill Character
The unused part of the banner line is blank, unless it is the active window. In the active
window the double line goes through the unused part of the banner line.
5.2.1.6 Banner Line Mouse Commands
If you press 10 0 -Ion the window banner line, a shadow border follows the mouse
cursor and lets you move the window anywhere on the screen. The window gets smaller
if you run into the edge of the screen, but grows back again as you move away from the
edge.
I_ 0
0) on a banner makes its window active.
(0 _ 01 on a banner splits the window.
10 0 -) on a banner can drag the window to a new area on the screen.
D - 85
Chapter 5
5.2.2 The Border
The active window has a double line border.
All other windows have a single line border.
(0 • 0
I on the right window border splits the window.
(. 0 0
I
(0. 0 I or (0 0 .) on the bottom window border scrolls thumbs
horizontally.
.--=-0-0. . . .1 r 0 • 01 or
'-r
roo .1 on the left window border scrolls or thumbs vertically.
5.2.3 The Elevator
The left border of the window has an "elevator" that indicates both the position of the
window in the file and the amount of the file shown in the window. The left border
between the two corners represents the whole document.
The top and bottom of the elevator represent the top and bottom of your file. The further
text is into the file, the further down the left border the elevator starts. The more of the
elevator is in the left border, the more of the file is visible in the window (hence the
shorter the file). As you scroll through the file, the highlighted portion of the left border
moves up or down the left border.
5.2.4 The Corners
Each window corner has two commands that are invoked with either I. 0 0 Ior 10 0 .)
on that corner.
I. 0
0) on a corner tops the window, unless it is already the top window, in which case
it bottoms the window.
(0 0 . ) on a corner lets you stretch that corner by dragging it. An elastic shadow border
follows the mouse cursor and the window assumes the size of the shadow border when
you release the (0 0 .1 .
The corners are functionally separate from the banner line or any of the border lines.
D - 86
How POINT is Displayed
5.3 The Text in your POINT Window
5.3.1 Displayed Text
Text in the window is a representation of the contents of the file in your window and is
displayed as it would be on a printer. In most text files, lines end with a CR-LF
(Carriage-Return, Line-Feed) sequence (ASCn 13 and 10). This sequence serves to
position text that follows the CR-LF at column 1 on the next line in the window.
5.3.2 Displayed Characters
Characters are displayed using the graphics symbols defined by the IBM PC for the 256
possible character values, with these exceptions:
• 8J moves to the next tab stop and is not displayed as a tab character.
•
•
Line-feed (ASCn 10) shows as a blank, and positions following text onto the
beginning of the next line.
Carriage Return (ASCn 13) immediately followed by a Line Feed is ignored.
A Carriage Return not followed by a Line Feed is displayed normally.
5.3.3 The End-of-line Character
At the end of each line, POINT displays a vertical rectangular blank that represents the
Carriage-Return/Line-Feed sequence. This blank is only visible if you include it in a
selection. Line-Feed (ASCn 10) alone will ba accepted as an end-of-line character, but
when you press Q] , a Carriage Return/Line Feed is inserted there in the file, and is
called the "end-of-line character."
D - 87
Chapter 5
5.3.4 Selected Text
There is always a current selection (unless no windows are open). The selection is a
sequence of one or more characters in one of the displayed files. It's not necessary for
the selection to be visible in a window (it might be in a window partly covered by
another window).
Selection specifies the text that you want to manipulate. After selecting, you generally
issue a command that affects the selection.
Selection has no effect except to change the appearance of the display until you issue a
command that affects the selection. So, making a selection does not imply any
commitment to do anything. And, if you select the wrong item, simply make another
selection before issuing a command.
The OPT:J;ONS menu has a textColors option which sets various color or video
attributes of both the text in a window and of selected text. A contrasting color can help
keep track of selected text for foolproof manipulation.
5.3.4.1 Select Text
To make characters in the document the current selection, do this:
Press [. 0 0) to start the selection. Hold [. 0 0) down and move the mouse to select
additional text. You can move either forward or backward from where you first pressed
the[. 0 o}.
The selection starts in character mode. If you release the (. 0 0) and press it again
inside the selection, you select word mode and the selection is extended one woni ai. a
time. A third press selects line mode, and the selection is extended one line at a time. A
fourth click returns to character mode. Selection mode affects how copy and move act.
[ #26, ( (. 0 0
I , inside window)
]
D - 88
How POINT is Displayed
5.3.4.2 Select Words and Lines
Click (_ 0 0) once for character mode. If you move the mouse while (_ 0 0) is still
pressed, the cursor extends the selection character by character.
If the mouse cursor is on a currently selected character and you press (_ 0 0) twice, you
select the entire word. In this case the cursor extends the selection word by word.
A third click inside the selection changes the selection to line mode, and the cursor
extends the selection line by line.
A fourth click cycles back to character mode.
5.3.4.3 Extend the Selection
(0 0 . ) extends or contracts the selection. To start, click (_ 0 0) to select.
Then,
move the mouse cursor to where you want the highlighted selection to end. Press
[0 0 _) and the selection will extend to that point. If you hold down (0 0 _) , the
highlighted selection will follow the mouse cursor just as it does when you select with
[_DO).
i).
You can move either forward or backward from the place you first press, (0 0
To
extend a selection beyond the immediate text in the window, start with _ 0 0 ,move
the window as needed, and extend the selection with [ 0 0 _) .
Characters are added to (or removed from) the current selection. Press (0 0 _) to start
the extension. Hold the button down and move the mouse to select more or less text.
[#39, mouse ([00 _j ,inside window)]
5.3.4.4 Select the End-or-line
The end-oj-line character is at the end of each line in the window. It appears as a blank
on the screen, but can be distinguished from actual spaces in the text since it is always
the last character on a selected line. Actually, Carriage-Return/New-Line (the
combination) marks the end of ~ line in DOS formatted text. You can't select either
Carriage-Return or New-Line separately if they are together.
A New-Line alone is an end-of-line character. In this case you can effectively select the
New-Line alone. Carriage-Returns alone do display and can be selected.
Deleting the end-oj-line character joins t~at line with the next line.
D - 89
Chapter 5
5.3.4.5 Delete Text
Selected text is deleted from the screen and saved in the scrap buffer for later insertion.
The selection mode of the text in the scrap buffer is recorded.
[#4,[Oel] ,(ED]
5.3.4.6 Delete Text, Not to Scrap
Selected text is deleted. The scrap buffer is not changed.
[#61]
D·90
How POINT is Displayed
5.4 Input from your Keyboard to POINT
5.4.1 Insert Text Characters
5.4.1.1 The Insertion Point
The insertion point is just before the first character of the selection. All characters typed
on the keyboard are inserted here. First, select an insertion point in the text with the
mouse cursor. Then click the (. 0 0 1. In this case, you are not selecting text to alter or
manipulate; but rather a point at which you will enter new text.
Most of the 128 ASCII characters are inserted by typing a corresponding key.
Control characters are not inserted, but reserved by the operating system or interpreted
specially by the editor. These include:
@!ill-(!) (nul)
@!ill-@] (like ~)
@!ill-(ffi or (f- Back)
@!ill-{M) or GD (carriage return)
@!ill{!] or (Esc ) (escape)
@!ill-(EJ, @!ill-@] (suspend)
IfGD is pressed and auto Indent is set to 1, the next line is indented to the same level
as the previous line. In fact, it will be indented with the same sequence of spaces and
tabs that began the previous line.
If overType is set to 1, the next keystroke replaces the character after the insertion point.
5.4.1.2 Insert and Overtype Modes
You are initially in insert mode: any printable character you type appears at the insertion
point.
Switch to overtype (or overwrite, replace, or typeover) mode, from the OPTIONS menu
or by pressing @(Q). Now each new character types over existing text and replaces
the next highlighted character.
The banner line shows OverType to indicate that you are in overtype mode.
D·91
Chapter 5
5.4.1.3 Backspace over Text
[ ~ Back) erases the character previous to the selection.
@!ill-[ ~ Back) erases the previous word.
A word to @!ill-[ ~ Back Iis either:
•
•
A sequence of letters (upper and lower case) and numbers
A sequence of special characters (non-alphanumeric)
The white space (spaces, tabs, and the end-of-line character) after the word is also
deleted.
@!ill-[ ~ Back) begun
in the middle of a word deletes only the characters before the
selection.
5.4.1.4 Insert ASCII Characters
You can insert any extended ASCII character (the 256 characters defined for the IBM
PC) into the text. Specify the character with its numerical ASCII value in either decimal,
hexadecimal, or octal.
If the leading two characters of the value you give are OX the rest of the number is
interpreted as hexadecimal.
If the first character is 0 (and the second is not X), then the number is interpreted as
octal.
If neither is the case, the number is interpreted as decimal.
[ #23, CID-0, EDITING menu]
D-92
How POINT is Displayed
5.4.2 Enter a response
5.4.2.1 Respond to a Prompt
Sometimes a prompt appears on the bottom line of the display. Type text normally for a
response. (~ Back 1erases the last typed character, and @!!!}( ~ Back) erases everything
on the line. You can't select a response when the prompt is displayed, but [0 0 .) can
copy what is already selected into the response area.
Conclude the response to a prompt with [;[) or [. 0 0) .
( Esc 1can be used to cancel an action that has requested input.
Sometimes a default response appears. To accept this response, press [;[) or (. 0 0 1.
[ ~ Back 1erases the last character of the default response and lets you edit the default
response. Any other key erases the default response and starts a new response with the
key you pressed.
Some responses only need a yes or no answer and terminate after you type either (]J or
For YeslNo questions, (. 001 is Y and any other mouse button is N only if the
mouse cursor is on the bottom line of the screen. Yes/No questions also have default
responses (usually V).
(]D.
5.4.2.2 Select a File Name
When you load a new file into a window or create a new window, you are shown a list of
file names. Select a name by clicking on it with the mouse.
The top line shows information about the files displayed:
•
•
•
•
The current directory.
How file names are sorted.
Name pattern for displayed file names.
Number of files in the directory.
If there's not enough room to show all the file names, you see the message
SOME FILE NAMES MISSING and only some of the file names from the file pattern.
The second line of the display shows five commands that affect file name display.
Cancel load cancels the load or window create.
If the list of files doesn't fit on one screen, review other file names by using Next page
and Previous page.
D - 93
Chapter 5
Click on New pattern to specify a pattern used to display the list of files.
To specify more than one pattern in the list, separate each pattern with a vertical bar
character ( I). A file pattern can include a drive letter and a PATH name. The file name
by itself, or as the last component of the path specification, can include DOS wild card
characters (* and ?).
Here are some examples of file patterns:
*.*
all files in the current directory
all files ~vVith the extension. DOC
\BIN\*.BAT
*.DOC I *.TXT
all files with .DOC or .TXT extensions
\BIN\A*.BAT
.BAT files in \BIN beginning with A
I \TEST\*. BAT
. BAT files in \BIN and \TEST
From this screen you can:
•
•
•
Click on the file name you want to load,
Type in a file name directly, or
Click on a command name to change the display.
5.4.2.3 Options
OPTIONS lets you change many options interactively. If you select an option (except for
a True/False option), you are asked for a new value. True/False options are toggled
from true to false, or false to true.
5.4.2.4 Set Screen Colors
If you choose any of the oolor options, you are shown a screen that lets you temporarily
change the color scheme for the active window. The choices you make are immediately
reflected in the sample screen in the box at the bottom of the screen. For permanent
changes you must change the color statements in PT.INI.
D·94
How POINT is Displayed
5.5 File Handling in POINT
5.5.1 Files in Windows
All windows show a file name on the banner. When the window is loaded, it displays the
contents of the file. As the file is edited, the window shows the most current version, but
the original file on disk is unchanged until you save the edited file.
All new text in the window is kept temporarily in a work file called PTTEMP.XXX.
This file is in the working drive and directory, but it can be reset with the workDri ve
option in PT. 1NI.
You can put the work file on a RAM disk, but it won't speed things up much unless you
are editing a very large file or many different files. The reason is that POINT tries to
keep all the active parts of the work file in its internal buffers anyway. With large files or
with many files, it will not be able to do this.
W
by itself, when prompted for a
window with the name UnNamed. x.
New Window
file name, creates an empty scratch
5.5.2 Backup Files
When you save a file, the previous version is saved in a .BAK file which contains the
version you first loaded, not the version before the last save. That is, even if you save the
file two or more times during an editing session, when you quit POINT the .BAK file
will contain the version of the file before you began your session.
The makeBaks option determines whether .BAK files are generated at all.
5.5.3 File Handles
POINT has a number of files open at the same time; therefore it needs sufficient DOS
file handles to be able to have many files in many windows. You can tell DOS how
many file handles to allocate in the CONFIG.SYS file. We recommend that you specify
at least 20 and preferable 30 file handles in CONFIG.SYS.
D -95
Chapter 5
5.5.4 Feedback On Long Operations
Replace and Write operations now provide feedback about their progress as they
execute. The idea is that any operation that might take more than a few seconds will
provide feedback on its progress.
Replace tells you what percent of the operation has been completed so far. This is true
of the replace with verify and the global replace. The percent feedback tells you how
much of the file has been searched so far, not what percent of the replaces have been
done, (It cannot know how many actual replaces are needed until the replace is
completed.)
Any file that writing command provides continuous feedback about what percentage of
the operation has been completed. This applies to write, to same, and to all file writing
resulting from quit commands.
5.5.5 Read-Only Files
There is now a facility for read-only files. One purpose of this is to correctly handle files
that have read only permission in DOS. Another purpose is to allow you to edit files
without the possibility of accidentally changing them. A file in a window can be made
read-only in three ways.
•
•
•
Load a file marked by DOS as read-only into a window.
Load a file into a window when the global "readOnly" option flag (a new option) is
true.
Use a new command that toggles the readOnly state of a file in a window.
Toq9,'le Read Only [command #86] changes the readOnly status of the file in the
active window. It does not let you change the readOnly status of a file marked read-
only by DOS.
You can edit a read-only file on screen only. The changed version cannot be saved.
Trying to save a readOnly file will result in an error message. Trying to quit with a
readOnly file that has been edited will generate an error message and give you a chance
to cancel the quit (by pressing the (Esc] key) or to proceed with the quit without saving
the changes (by pressing any other key).
You can write a readOnly file to another filename.
D - 96
POINT Commands
Chapter 6
POINT Commands
6.1 Invoking POINT
Here is the fonnat for invoking the POINT Editor from the DOS command line:
PT [/0] [/H] [IV] [FILE1 [FILE2 ...] ]
I slash or - hyphen precedes option letters.
-H, -0, and -V, or I H, 10, and I V designate options.
10
Overlaid is the initial windows default, with each window full
screen and overlaid.
IH
Horizontal split loads initial windows full-width, with the first
screen full, the second a few lines down, etc.
IV
Vertical split is similar, except that initial windows are all full
screen height and spaced vertically and evenly across the
screen.
IL
POINT looks for a file in the current directory named
PT.LAS, from which it can reconstruct the last editing
session. (Of course, you will not be able to undo edits from
the previous session.)
D·97
Chapter 6
[FILE1 [FILE2 ...]]
POINT creates a window for each file name on the command
line. If the file name you specify contains wildcard characters
(* or ? ) it will expand to contain all matching file names, as
specified in the DOS manual. A maximum of 20 files is
allowed.
Several additional options relate to invoking POINT.
initialWindows
buffers
videoMode
workDrive
sets arrangement of the initial windows
sets buffer space and memory to be used.
sets how the screen will be updated.
tells where the work file will be placed.
useful here for large files.
D·98
A RAM disk is
POINT Commands
6.2 Command Format
The commands in this chapter are grouped by function type.
At the end of each command description [square brackets] contain the ways to invoke the
function. The following parameters are used within the brackets.
In
A number (e.g., #7) gives the number which identifies the
command to the top line, to a keystroke, to a mouse button, or
to a menu.
([00
rn
oj ,position)
or
@!ill-GJ
[0 0 0 ) , followed by where the function is called,
is in parenthesis.
( (. 0 0 J , any corner), for example, means:
press [. 0 0) on any corner of a window.
Keys and key combinations that invoke commands.
Top line commands (e.g., find) show the command name
from the top line.
Menu commands (e.g.,
the top line.
WINDOWS)
show the menu name from
Top line command and menu names are those used in the distributed files PT. IN I and
COLOR.INI. PTEXPERT.INI uses a different top line.
6.2.1 Esc and Ctrl-Break
( Esc J is a general escape. Most commands can be aborted with no action or change by
hitting ( Esc) when keyboard or mouse input is requested. (Esc) only stops actions that
use keyboard input (e.g., writing a file, searching for a text string).
[ Ctrl
HBreak) stops the current editor action.
D - 99
Chapter 6
6.3 Window Management Commands
6.3.1 Create a New Window
To create a new window, click (. 0 0) on New Window from the WINDOWS menu. You
are asked to specify any two opposite comers. Press (and hold) ( • 0 0) at one comer.
The first comer can be any of the four comers of the new window position. An elastic
window border will follow the mouse cursor. Release the button at the opposite comer.
If you double-click at the first comer without moving the mouse, the opposite comer will
be taken to be the lower right comer of the screen.
Next, POINT asks for a file to be loaded into the window. Select the file from a menu of
file names or type in the file name. (Esc) aborts the action, and no window is created.
creates a window for a file named UNNAMED.X, where X is an alphabetical
character [A .. ZJ.
[#7,oo-®J
o
6.3.2 New Window From Selection
This is exactly like the New Window command (above), except that the file to load into
the new window is taken from the text you have selected.
[#82, 00{ill)
,( Ctrl HF1 0) ]
6.3.3 Hide Window
The window is no longer displayed but is still open. The window is then "hidden" and
only shows up on a second list at the end of the TOPLIST menu. Selecting a hidden
window from TOPLIST unhides it and makes it the top/active window. It will be the
same size and in the same position as when it was last visible.
[#38, (][}-(K) J
D ·100
POINT Commands
6.3.4 Close Window
The window is removed from the screen. If this is the last window that shows the file,
you are asked whether to save the edited version of the file or to discard the edits and
leave the original file unchanged. The file is closed and the window is deleted.
[#17,oo-@J]
6.3.5 Close Window and Save File
The window is removed from the display. If the file has been changed it is saved
automatically (no verify is requested). The file is closed and the window is deleted.
[#72]
6.3.6 Split Window
A window can be split (vertically or horizontally) into two independently scrolled
windows on the same file. The original window is unchanged and the split window is on
top of it. The split window starts where the split was made and goes to the right or lower
border of the original window. The tiledSplit option causes the original window and
the new window to each take up part the space occupied by the original window.
[ ([0 .0) , top or right border) ]
6.3.7 Change Color Combination in Window
This command changes the text and border colors of the active window to the next color
combination on the list in the textCol.ors and borderColors option. After the last
one is used, the command cycles back to the first one. The default color combinations is
included in this cycle.
[#87]
D -101
Chapter 6
6.3.8 Window Positioning
6.3.8.1 Top Window
The window is made the top window shown on the display.
[#12]
6.3.8.2 Bottom Window
The window is made the bottom window.
[#29,00{[) ]
6.3.8.3 Top/Bottom Window
The window is made the top window unless it is already the top window, in which case it
is made the bottom window.
[#28, ( (. 0 D) , any corner) ]
6.3.8.4 Zoom Window
The window is expanded to cover the entire screen, or if it is already zoomed, it is
returned to its original position.
[#11,~, WINDOWS menu]
6.3.8.5 Change Window Size
Respecify the size and position of the window. Press (and hold) the (. 0 D) at any
comer. From there, an elastic window border (where the mouse cursor is the opposite
comer) will follow the cursor. Release the button when the window is the desired size.
If you double-click at the first comer, the opposite comer is taken to be the lower right
comer of the display.
[#13, WINDOWS menu]
D ·102
POINT Commands
6.3.8.6 Stretch Window
Change the window size on the display. The comer you first pressed the I_ 0 0) mouse
on is moved to the mouse position where you release the button. An elastic
window border will follow the mouse as it is moved. The size can be increased or
decreased. The position of the opposite comer of the window is not changed.
button
[ ( 10 0 _) , any corner)]
6.3.8.7 Move Window
The window is moved on the display. With the mouse cursor on the banner line, press
and hold the 10 0 _). A shadow border follows the mouse. Release the button when
the window is at the desired position. The size of the window is not changed unless you
release the button while the shadow border is smaller due to being moved against the side
of the display.
[ ( [0 0 _) ,banner line) ]
6.3.8.8 Exchanging The Top Two Windows
This command exchanges the places of the top two windows. This is useful when you
are changing between two windows frequently but you also have other windows open
also.
[ #88]
D -103
Chapter 6
6.4 File Management Commands
6.4.1 Load File
Loads a file into a window. A menu of file names is displayed. Use [. 0 D) to select a
file name, or type in the name. [ Esc 1 cancels the load. QJ by itself creates a
New Window with a file named Unnamed.x. If the file you ask for does not exist, you are
asked whether or not to create it. If you answer
the file load is canceled. If
autoCreate is 1, then the file is created automatically without verification. If the file
currently in the window was changed and is not displayed in any other window, you are
asked if you want to save the edited file.
[#33,oo-cg, WINDOWS menu]
em '
6.4.2 Load File From Selection
This is like the load command, except that the file name is taken from the selection.
[#73, (lIShift HF1 0]]
6.4.3 Save File
Writes the edited version of the file, and releases the editing space. This action cannot be
undone, but a .BAK file is generated with the old version of the file. If makeBaks is set
to 0, no .BAK file will be created. You cannot undo changes if you have saved the file
since the changes were made.
[#54, OO® ' WINDOWS menu]
6.4.4 Save All Unsaved Files
All files that have been edited but not saved are saved as described in the save file
command (above).
[ #46]
6.4.5 Write With New Name
Writes edited version of a file to a new file. You are prompted for a new file name. This
action cannot be undone.
[#18,00®, QUIT&ETC menu]
D -104
POINT Commands
6.4.6 Toggle Read-Only Status of File
This command changes the read-only status of the file in the active window, that is, it
changes it from read-only to read-write or from read-write to read-only. It does not let
you change a file to read-write if the DOS file permissions are read-only.
[ #86]
6.4.7 Scroll Down
Moves window toward the end of file. If the window contains N lines, it scrolls N-2 lines
. If you do this with the mouse, the amount scrolled depends on how where the mouse
cursor is on the left window border. More precisely, the text line next to the mouse
cursor becomes the top line of the window. If the mouse cursor is on line 1 in the
window, the window scrolls one line. The rightBack option reverses the scroll
direction of the mouse button.
[ #15, ~ , ( I_ 0 01 , left border) ]
6.4.8 Scroll Up
Moves window toward the top of the file. The window is scrolled N -2 lines if the
window contains N lines. If you invoke this with the mouse, the amount scrolled
depends on how far down the left window border the mouse cursor is when you invoke
the command. The window scrolls up so that the top line moves down to the mouse
cursor. The rightBack option reverses the scrolling direction of the mouse button. If
the rightBack option is 2 or 3, the text line next to the mouse cursor becomes the
bottom line of the display.
[#14,~, (100 -1, left border) ]
6.4.9 Scroll Left
Move the window to the left.
[ ( ,- 0 0 1 , bottom border) ]
6.4.10 Scroll Right
Move the window to the right.
[ ( [0 0 -1 , bottom border) ]
D-I0S
Chapter 6
6.4.11 Thumb Vertical
Move window to a specific area in the document. Imagine the document laid out along
the left border. The mouse cursor indicates where in the document you want to go. The
window will be positioned so that the top of the elevator (the left border highlight) starts
where the mouse cursor is when you thumb. Comers are not part of the left border and
cannot be used for thumbing.
[( (0 • 0] ,left border)]
6.4.12 Thumb Horizontai
Move window left or right depending on where on the bottom border you click.
[( (0 • 0], bottom border)]
6.4.13 Search For String
A prompt is displayed for the search string. If the selection is in the window, a search is
made from the point of selection to the end of the file. If the selection is in another
window, the entire file is searched. The search ignores case unless ignoreCase is set to
o. The default search string is the last string searched for. This string is automatically
inserted as a response. Pressing QJ accepts this as the search string. If you press
(~ Back] first, it erases the last character of the default string and lets you continue
editing with more backspaces or new characters. Pressing any other key first erases the
default string and starts a new string.
A find is displayed in character mode. If the string is already in the window, the window
is not changed. If the string found is not in the window, the window is changed to show
the string found on the third line of the display. The window is topped when the string is
found only if the topOnFind option is set to 1. The searchMode option determines
whether the search proceeds forwards, backwards, or circularly.
In a search string the following escape sequences are valid:
" \n "represents the end-of-line character (ASCII 13 followed by ASCII 10)
" \N "represents the line feed character (ASCII 10)
" \r "represents the carriage return character (ASCII 13)
" \ \ "represents a single backslash character ( \ )
[ #19, I1lShift HF6] ,MOVING menu, find on the top line]
D -106
POINT Commands
6.4.14 Search For Selection
This is the same as search for string, except the current selection is used as the search
string. The selected search string can include one or more end-of-line characters. You
can select a string in one window and search for it in another window.
[ #27, ( FS] , MOVING menu, next on top line]
6.4.15 Search Backwards
This is like search for selection, except the search goes in the opposite direction. Unless
searchMode is set to 1, this is from the selection to the beginning of the file.
[ #66, OO@ , [ Ctrl HFS ) , MOVING menu, prev command on top line]
6.4.16 Replace String
Replaces occurrences of a string with a different string. The string to search for is
requested first. Then, the string to replace it with is requested. Both search and replace
strings can contain the escape sequences \n, \N, \r, or \ \ as described in the
search command (above). Next, you are asked whether the replace operation should take
place only within the current selection or from the current selection to the end of the file
(a "global replace"). Finally, you are asked to indicate whether you want to verify each
replacement or replace them all without verification. If you choose to verify each
change, (y) makes the replacement, (ffi does not replace, but goes on to the next
occurrence of the string, and [ Esc) terminates the replace operation.
[ #20, (][J-(ffi , EDITING menu]
6.4.17 Beginning of File
Positions the window at the beginning of the file.
[#8,~]
6.4.18 End of File
Positions the window at the end of the file, with the end-of-file marker on the bottom line
of the window.
[#9,~]
D -107
Chapter 6
6.4.19 Beginning of File and Move Selection
This command works like the Beginning of File command but it also moves the selection
to the first character of the file. It is can be used before a search or replace that you want
to start at the beginning of the file.
[#78 ]
6.4.20 Go To Line Number
You are prompted for a line number. The window is repositioned so that the requested
line number is the top line in the window.
[ #16, CID-@J , MOVING menu]
6.4.21 Go To Selected Line Number
The selection is taken as a line number. Nondigits at the beginning of the selection are
ignored. The window is repositioned so that that line number is the top line in the
window.
[#84,@@ ,[CtrIHF9]]
6.4.22 Go To Last Place
The window is repositioned to the last place you came from with a nonrelative motion
(that is, not a scroll). This is the last place you jumped from with one of these
commands: go to line number, go·back to last place, search, beginning of file, or end of
file. A separate "last place" is remembered for each window.
[ #56, ( F3J , MOVING menu]
6.4.23 Go To Selection
The window containing the selection is made the top window and repositioned so that the
selection is near the top of the window.
[ #58, ( nShift HF3J , MOVING menu]
6.4.24 Find Matching Bracket
The bracketing character that matches the first selected character is searched for. The
allowed bracketing characters are (, ), [, ], {, and}. The file is searched in the correct
direction and the matching bracket is found, taking nesting into account.
[ #83, (nShift HFa ]]
D -108
POINT Commands
6.5 Menu Commands
To use pull-down menus. move the mouse cursor to the top line. Then press and hold
[. 0 0 Ion the (upper case) menu name. When the menu appears, select a menu option
with the mouse cursor. In the menu, the command is the color of the selected text.
If you release the [. 0 0 I on a command string, that command is carried out. If you
release the mouse button outside the menu, no command is executed.
[ Esc I exits from a menu without selecting anything.
same way as a mouse button click.
QJ executes a command in the
6.5.1 Top line Commands
Commonly used commands are listed on the top line. Click (. 0 01 on one of these to
be execute the command. It is possible to put any command on the top line (and give it
any name) by modifying PT.INI.
PT.INI also lets you have:
•
•
Several top lines, each accessed by a different button
A bottom line of menus and commands instead of a top line
•
Pop-up mouse menus.
6.5.2 User Menus
These commands display the eight user-defined menus and allow you to select a
command from them. They can be displayed as top line menus, bottom line menus, dropdown menus (from the top line), or as pop-up menus.
[#50 (1), #51 (2), #52 (3), #60 (4), #65 (5), #67 (6), #79 (7), #80 (8)]
6.5.3 TOPLIST Menu
A menu is displayed that lists the file names of the files in all open windows. The file
names are shown from the top window to the bottom window. If there are hidden
windows, they are listed after the list of visible windows (a double line divides the two
lists). Selecting file name from the TOPLIST menu will top that window. Selecting the
file name of a hidden window unhides and tops the window.
[#53,00-0]
D ·109
Chapter 6
6.5.4 OPTIONS Menu
A menu of POINT options is displayed. The option to be changed has to be selected
Options are changed in two ways. T~e/false options toggle from true to false to true
when selected. Numeric or string options display a prompt for a new value. The default
input is always the current value of the option. ( Esc) exits option setting with no
changes.
[#63 ]
6.5.4.1 Interactive Color Settings
textColors, borderColors, and msgColors option show the color settings. Each
setting is two hexadecimal digits.
textColor
Shows the color setting for the text and the selection.
borderColor
Shows the color setting for the banner line, the border and the elevator.
msgColor
Shows the color setting for the Info Message, User Input,
Error Message, and Topline.
Selecting textColors, borderColor or msgColor puts you in color setting mode
where you can set the colors of the active window or any of the other POINT color
settings. (Esc) exits color setting mode with no changes.
The color setting mode will display a screen with three major parts.
The top is a menu line with 10 commands. Nine of these are used to change the color of
the display. The part that will be changed is selected by clicking on its name on this
menu line. The tenth command exits interactive color setting.
D -110
POINT Commands
The second part of the screen is a line of four commands and a menu of the 128 possible
combinations of foreground and background colors you can select from. Select a color
combination by clicking on it. The commands allow you to look at another 128 color
combinations (the alternate colors) which will either be blinking or have bright
background colors. Two of the commands switch you back and forth between the plain
and alternate color sets. The other two commands change the alternate color set from
blinking to intense and back again.
~-------------------------NOTE------------------------~
Commands to switch between blinking and intense colors reprogram the
hardware: their effect will persist until you tum off your machine.
The third part of the screen is a sample window showing how the selected color
combination will look, and samples of the four other display parts.
Pressing ( Esc) while in color setting mode returns you to editing without making any
color changes.
Click on the Exit menu item on the top part to exit the color selection mode.
D -111
Chapter 6
6.5.4.2 Redefme Keys, Buttons and Mouse Motions
This lets you interactively change the definition of a key, mouse button or mouse motion
subcommand. It is useful when you need an easy-to-issue command. For example, you
might want to cha~ge (~) to issue the change case command so that you can quickly
change the case of a sequence of words.
The feature is accessed through the OPTIONS menu item Redefine. .. When you
select Redefine... you are asked what type of action you want to redefine.
Redefinition options are:
k
a key
POINT asks you to press the key you wish to redefine. Then it asks you for the
new command to assign to that key. This process is described below.
b
mouse button
POINT asks you to press the mouse button you wish to redefine. Then is asks
you for the command to assign to that button. You can also redefine a
combination mouse button 1tShift ,00, or (Ctrl). (Do this in PT.INI also.)
Just press ( 1tShift) ,00 ,or Ctrl and then the click the mouse button.
1
subcommand of the first mouse motion command
2
subcommand of the second mouse motion command
1 or 2 prompts you for the subcommand direction. The options are a compass
point (n, ne, e, se, s, sw, w, or nw) followed by the QJ key, or the QJ key
alone to redefine the no motion command.
D -112
POINT Commands
After you select the action to be redefined, POINT displays directions on line 24 of the
screen, and a command number and command description on line 25. These are the same
one-line descriptions you see if you have the helpMocie set to 1 or 2. The first command
you see is the command currently assigned to the action you specified.
You can scroll up and down through all the possible commands (presently there are about
ninety (90) POINT commands) with the CD and CD cursor keys. You can jump
directly to a command by typing its number. A one digit command number must be
preceded by a 0, or followed by the QJ key.
When the command you want is showing, press QJ to complete the redefinition.
D -113
Chapter 6
6.6 Mouse Motion Commands
Mouse motion commands make it possible for you to execute a specified command by
simply moving the mouse in one of eight directions on your desk/screen.
6.6.1 Issuing a Mouse Motion Command
The mouse motion command is assigned to a mouse button. The mouse motion
command has nine associated subcommands. You issue a subcommand by pressing the
mouse button, moving the mouse at least one character in one of the eight compass
directions, or not move at all and then releasing the mouse button. The directions are:
N
NE
E
SE
S
sw
w
NW
north or up
north-east or up and right
east or right
south-east or down and right
south or down
south-west or down and left
west or left
north-west or up and left
no movement
POINT only looks at where you press the mouse button and where you release it to
determine which direction you went.
While the mouse button is depressed, POINT gives you feedback as to which command
it will execute if you were to release the button at that point. The feedback is an arrow
pointing the direction you have moved (or a single dot for the no motion command). If
you have helpMode set to 1 or 2 then a one line description of the command is given on
the bottom line of the display. It is recommended that you set helpMode=l or
helpMode=2 while you are learning to use the mouse motion commands.
A ninth subcommand is the no motion command. It is issued if you release the mouse
button at the same point as you pressed the button. This command is easily issued as a
fast click of the mouse button. Therefore this should be the most commonly used
command of the nine mouse motion subcommands.
6.6.2 Canceling A Mouse Motion Command
Pressing a second button cancels the mouse motion command.
D -114
POINT Commands
6.6.3 Default Mouse Motion Subcommands
You can specify the nine subcommands of the mouse motion command (see section 3.3.5
for information on how to do this). The default commands are:
previous
I
delete
\
I
/
\
I /
duplicate -----> move
/
I \
/
I
\
redo
I
insert
next
undo
copy
<-----
The command numbers are:
duplicate
previous
delete
move
insert
next
redo
copy
undo
#2
#66
#4
#70
#55
#19
#24
#69
#25
These rules will help you remember these commands:
•
•
•
•
•
•
downward strokes are positive (redo, next, insert)
upward strokes are negative (undo, prev, delete)
they are paired, down and up (redo/undo, next/prev, insert/delete)
diagonal strokes make editing changes
horizontal strokes do copy and move
vertical strokes do searching
D-115
Chapter 6
6.6.4 Second Mouse Motion Command
The second mouse motion command is for people with a three button mouse who want to
assign two mouse buttons to mouse motion commands.
[ #46]
The default subcommands of the second mouse motion command are:
move to
last place
I
deleteI
no scrap
close
window
\
I
/
\
I
/
copy to <--- extend ---> exchange
scrap
/
/
I
I
/
bottom
window
I \
with scrap
\
I
\
cancel
I
TOPLIST
The command numbers are:
extend
move to last place
delete/no scrap
exchange with scrap
cancel
TOPLIST
bottom
copy to scrap
close window
#39
#56
#61
#62
#22
#53
#29
#57
#17
The second mouse motion commands can be changed in PT. IN I with lines of the form:
nN=commandNumber
where N is 0, 1,2,3,4,5,6, 7, or 8 as in the chart above.
D -116
POINT Commands
6.7 Editing Commands
6.7.1 Copy
There are several ways to copy text: the copy command, the duplicate command,
and via the scrap buffer.
6.7.1.1 Copy
Select the text to be copied. Move the mouse cursor to the point where you want to copy
the selection. Now, press ~~Shift J jnd click (. 00 J. The text will be copied to the
place where you release the • 0 0 . If the selection is in word or line mode, it will be
copied in front of the word or line where you release the mouse button.
[#69,~. 0 Olor~O 0 .)]
Step 1: Select the text you want to copy.
Step 2: Move the mouse cursor where you want to copy the selected text.
Step 3: Press ( ll'Shift) and click the (. 0 0) mouse button.
If you select the insertion point in character mode, then the text is copied in
front of the character you are pointing at.
If you select the insertion point in word mode then the text is copied in front of
the word you are pointing at.
If you select the insertion point in line mode then the text is copied in front of
the line you are pointing at.
D -117
Chapter 6
6.7.1.2 Copy To Scrap
This copies selected text into the scrap buffer. The mode (character, word, or line) of the
selection is remembered and used when the text is inserted.
[ #57, (1l'Shift HF4) , EDITING menu]
6.7.1.3 Copy with Scrap Buffer
This method uses the scrap buffer for insertion of text. Move the cursor to where you
want t.l}e text copied, select that point wiL.'1 the [. 0 0) , and press [ ins) .
If the text in the scrap buffer was selected in word mode or line mode, then it will be
inserted in front of the character, word, or line that contains the insertion point. You can
insert the same text from the scrap as many times as you want.
[#55,~,(F2)]
6.7.1.4 Duplicate
Press (. 0 D) where you want to copy the duplicated text and press
Then select the text to be duplicated and press ( F4 ) again.
[ #2, ( F4 ) and (. 0 D) ]
IF4) .
Step 1: Select the insertion point for the text you want to copy (this is the reverse order
from the copy instruction).
Step 2: Press I F4) to go into duplicate mode.
Step 3: Now, select the text to be copied.
Step 4: Press ( F4) again. The selected text will be copied to the insertion point.
This ends duplicate mode. The new insertion point is the fIrst character after the
copied text.
While in duplicate mode you can execute commands, such as scrolling windows,
topping windows, searching for text, creating new windows, etc.
Use duplicate to copy several things to one place.
Use copy if you already know where you want to insert the text.
An easy way to duplicate is to select a section of text and then press (F4) twice.
This is especially useful for duplicating one or more lines of text.
D ·118
POINT Commands
6.7.2 Move
You can move text with the Move
Text
or with the Extract command
6.7.2.1 Move Text
Select the text to be moved. Then move the mouse cursor where you want to move the
text. Then while holding down ( Ctrl] key, click (. 0 0]. Text is moved to the place
where you release the (. 0 0) button. If selection is in word or line mode, the text is put
in front of the word or line where you release the button.
[ #70, @!ill-(. 0 0)]
6.7.2.2 Extract
Press (. 0 0) where you want to place the extracted text, and press
Then select the text to be extracted and press ( F5] again.
[ #3, ( F5] , and mouse button]
D -119
@
Chapter 6
6.7.3 Redo and Undo
The last 50 editing actions in your current ses~ion are recorded in a change history,
which is used by the Undo and Redo commands. undoSize determines how many
changes are remembered in the change history (50 is the default; 100 is the maximum).
Some actions carinot be undone or redone, such as the following:
load file, write file, close window, search, redraw, change selection,
change window size, scroll a window, move a window ~ top a window,
bottom a window, or exit the editor.
( Dell by itself cannot be redone.
Thus, deletes are ignored when looking for the last adion to redo.
[#24, (FS]]
6.7.3.1 Redo
Most editing actions can be redone. A redone action is recorded in the change history
and can be undone.
The sequence "select text, delete, and type new text at the same point" is recorded as one
action in the change history.
redo repeats the last action in the present environment.
redo copy copies the last text that was copied into the present insertion point.
redo move acts exactly like redo copy, since the moved text is already gone from its
original spot, and presumably you do not want to move it again from where you just
moved it.
D ·120
POINT Commands
6.7.3.2 Reversible Undo
Undo Last Edit reverses the last editing action. A delete is restored. A
copy is deleted.
A move is deleted and reinserted where it was originally.
If the last action was to select text, delete it, and then type new text all at the same point,
then this action is undone as a unit, that is, new text is deleted and old text is restored.
The undoing change is recorded in the change history so a second Undo Last Edit
undoes the first Undo. If the undoBack is set to 1, then Undo Last Edit acts like
Undo, Erase History. You cannot undo changes if you have saved the file since the
changes were made.
[ #25, OO{QJ ,( F9 ) , EDITING menu]
6.7.3.3 Undo, Erase History
This acts like Undo except that it doesn't record the change in the change history, and in
fact removes the change being undone from the change history. Thus, a second
Undo, Erase History undoes the change before that.
Undo, Erase History undoes up to 50 previous edits.
The undoSize option
determines how many previous edits are saved. The window will be moved to where the
undo will take place before the change is made. You cannot undo changes if you have
saved the file since the changes were made.
[ #40, ( llShift HF9 ) ,EDITI~G menu]
~--------------------------NOTE------------------------~
If you use undo and then decide to undo more than one step you have to use
Undo, Erase History two extra times: one to undo the undo, and a second to
undo the first undo!
If you prefer Undo, Erase History as the default, set undoBack to 1.
D -121
Chapter 6
6.7.4 Keyboard Macros
6.7.4.1 Begin/End Recording Macro Keystrokes
This begins recording keystrokes in the keyboard macro buffer. Keystrokes are recorded
until this command is executed again. There is only one keyboard macro buffer.
[#76,00{0]
6.7.4.2 Piay Back a Keyboard Macro
Keystrokes in the keyboard macro buffer can be played back at any time as if they were
typed on the keyboard.
To define and use a macro, do the following:
Step 1: Execute Begin/End Recording Keystrokes. This records each keystroke
that follows in the keyboard macro buffer. The keystroke commands are
executed as you type them, so you are defining the macro by example.
Step 2: Execute Begin/End Recording Keystrokes again, to stop recording
keystrokes and define the macro.
Step 3: Run the macro with Play Back Macro. This plays back keystrokes in the
keyboard macro buffer just as you recorded them.
[#77,00{f)]
~-------------------------NOTE------------------------~
There is only one keyboard macro buffer, so if you record another macro, the
previous one is lost.
D -122
POINT Commands
Here is a keyboard macros to indent a section of code:
Step 1: Position the cursor on the first line to be indented,
Step 2: Press oo-@ .
Step 3: Press ~ .
Step 4: Press
IB (cursor key).
Step 5: Press
(cursor key).
rn
Step 6: Press oo-@ .
OO®
Step 7: Press
once for each line to be indented. The macro inserts the ~ ,
moves to the beginning of the line, and down one line.
D -123
Chapter 6
6.8 Quit Commands
The following actions exit POINT in a various ways, according to what is done with the
files which have been modified during the editing session.
6.8.1 Quit-Ask About Files
Exits the editor. If any files have been changed but not saved, you are asked about each
one. Press LY.J to save the new version of the file, or ill) to leave the original version
unchanged. It will not accept any other keyboard input. You can also move the mouse
cursor to the bottom of the screen and respond [. 0 0) for Yes and [0 0 .) for No. The
editor is exited.
6.8.2 Quit-Save Files
All files that have been changed but not saved are automatically saved. Exits the editor.
[ #48, [ F2 ], QUIT&ETC menu]
6.8.3 Quit-Discard Edits
If files have been edited a single verify is requested. Exits the editor without saving files.
[#49, QUIT&ETC menu]
D -124
POINT Commands
6.9 Execute DOS Commands
6.9.1 DOS Command Window
Selected text is taken as a DOS command and passed to the DOS command processor for
execution. The standard output of the command is saved in a temporary file. When the
command completes, a new window is created and the standard output of the command is
displayed there. You can redirect either the standard input or the standard output of the
DOS command on the command line (the selection). If you redirect the standard output
the window created by the POINT Editor will be empty when the command completes.
[ #30, QUIT&ETC menu]
6.9.2 DOS Command Shell
The screen is cleared, and a copy of the DOS command processor is executed. You can
execute any DOS command using it. When you exit with the "exit" command, you are
returned to the editor and the screen is redrawn. The output of the commands executed is
not saved. The directory that was current when you invoked the POINT Editor is
restored after you exit from the DOS command interpreter, but the current directory you
were last in is restored if you invoke the DOS command interpreter again.
[ #32, @-(Q), QUIT&ETC menu]
D -125
Chapter 6
6.10 Miscellaneous Commands
6.10.1 Help
IfhelpMode is 1 or 2, the help screen is shown for the last command you selected from
the top line or from a menu (even if you did not actually execute the command).
Otherwise you are shown the main help menu.
[#64,[ Alt ]{Rl]
6.10.2 Toggle 43·line Mode
Switches between 25-line mode and 43-line mode. The 43-line mode is only available
with the Enhanced Graphics Adapter.
[#68,OO1I)]
6.10.3 Fill Lines To RightMargin
This fills lines so that each contains as many words as possible between column 1 of the
text and the right margin defined by "rightMargin". "Word" means a string of characters
separated by space characters. Space characters are spaces, tabs and end-of-lines.
When this command is invoked it performs this fill operation on all the lines that have
any selected characters (it is not necessary to select the whole first and last lines, just one
or more characters in each).
This command always uses column 1 as the left margin. If you want the block of text to
be indented you can do this is three steps:
Step 1: Reduce rightMargin by the indent desired.
Step 2: Justify the lines.
Step 3: Indent the lines.
Indent lines with the replace command by replacing \n with cdab>\n (where is the
tab character). This indents by one tab. Other indents are possible with similar replaces.
Alternatively, you can use the keyboard macro facility to indent the lines one at a time.
[#85 ]
D ·126
APPENDICES
Notes:
POINT Features
Appendix A
POINT Features
Specifications
Maximum number of windows
Maximum number of open files
Maximum number of buffers
Minimum window size
Maximum line size
Maximum input string
Maximum search string
Maximum replace string
Maximum number of menu characters
Maximum number of undos
Maximum disk buffers
User defineable menus
20
20
140
3 rows by 10 columns
any length
100 characters
50 characters
50 characters
2500 characters
100
300K
8
D -129
Appendix A
Notes:
D -130
Command Functions
AppendixB
Command Numbers
The following table shows command functions that can be attached to keys as defined in
the PT.INI file.
The format for this definition is
k=
where
k or K indicates that a key is about to be defined,
is one of the key codes defined in Section B.1, and
is a number defined in Section B.2.
D ·131
AppendixB
B.I Key Codes
Extended Code
Characters
003
015
016-025
030-038
044-050
059-068
071
072
073
075
077
079
080
081
082
083
084 - 093
094 - 0103
0104 - 0113
0114
through ( lIShift HF1 0 )
through @!ill-(£I2J
through (][}(ITQJ
0115
0116
0117
0118
0119
0120 - 0131
0132
D -132
Command Functions
B.2 Function Codes
Number
Window
Management
7
82
38
17
72
10
87
Position Window
12
29
28
11
13
88
Position File
in Window
15
14
19
27
66
20
8
9
16
84
56
58
83
78
Command
New Window
New Window From Selection
Hide Window
Close Window
Close Window And Save File
Split Window
Redraw Screen
Change Color Combination in Window
Top Window
Bottom Window
Top!Bottom Window
Zoom Window
Change Window Size
Stretch Window From A Corner
Move Window
Exchange the two Top Windows
Scroll Down
Scroll Up
Scroll Left
Scroll Right
Thumb Vertical
Thumb Horizontal
Search For String
Search For Selected String
Search Backwards For Selected String
Replace String
Go To Beginning Of File
Go To End Of File
Go To Line Number
Go To Selected Line Number
Go Back To Last Place
Go To And Show Selection
Finding Matching Bracket
Beginning of File and Move Selection
D ·133
AppendixB
Number
Command
File Commands
33
73
54
46
18
86
Load A New File Into Active Window
Load Selected File Name Into Active Window
Save File In Window
Save All Unsaved Files
Save File In Window Using Another Name
Toggle Read-Only Status of File.
CO",I",,,, ... 'T'''' .......
,.,~
39
Select Text
Extend Selection
23
Insert Character
Insert ASCII Character
Copy And
Move Text
69
2
70
3
4
61
57
55
62
22
59
Copy Text
Duplicate Text
Move Text
Extract Text
Delete Selection to the Scrap Buffer
Delete Selection but Preserve the Scrap Buffer
Copy Text To Scrap Buffer
Insert Text From Scrap Buffer
Exchange Selection with Scrap Buffer
Cancel
Toggle Insert/Overtype Mode
Redo And
Undo Edits
24
25
40
Redo Last Edit
Undo Last Edit (Reversible)
Undo Edit (Multiple Step Undo)
Quit Commands
5
48
49
Quit And Ask About Unsaved Files
Quit And Save All Unsaved Files
Quit And Discard All Edits
tJtt;.ltt;,,1.
.I. tt;AI.
~v
Insert Characters
D ·134
Command Functions
Number
Command
Execute
DOS Commands
30
32
Execute Selection And Put Output In A Window
Escape To A DOS Command Interpreter
Macro Commands
76
77
Begin/End Recording Keystrokes
Play Back Recorded Keystrokes
Miscellaneous
Commands
6
21
64
68
85
81
Set Value of the "debug" Variable
Display POINT Information
Invoke Help System
Toggle 43-line mode (EGA)
Fi11lines to Right Margin
Change case of a letter
Invoke
Menu Commands
50
51
52
60
65
67
79
80
53
63
Invoke User Menu 1
Invoke User Menu 2
Invoke User Menu 3
Invoke User Menu 4
Invoke User Menu 5
Invoke User Menu 6
Invoke User Menu 7
Invoke User Menu 8
Invoke TOPLIST Menu
Invoke OPTIONS Menu
Keyboard
Cursor Movement
Commands
34
35
36
37
42
43
44
41
74
75
Move Cursor Up
Move Cursor Down
Move Cursor Left
Move Cursor Right
Fast Cursor Movement
Move Cursor to the Edges of the Window
Move Cursor to the Edges of the Screen
Simulate Mouse Buttons
Move Cursor One Word (Blank Delimited) Left
Move Cursor One Word (Blank Delimited) Right
D ·135
AppendixB
Notes:
D -136
POINT Extensions
Appendix C
POINT Extensions
A POINT extension is a file which you can load and execute to extend the functionality
of eh POINT Editor. POINT loads the extension on demand, and unloads it when it
terminates.
An extension can be designed to remain resident in memory until space is needed to load
another extension, or until you issue a command to free the memory. In this way oftenused extensions do not need to be loaded again and again.
A primary extension may work together with another, secondary, extension. The
secondary extension may be terminated independently of the primary extension. All
extensions secondary to a primary extension will be terminated when the primary
extension is terminated.
D-137
Appendix C
Calling POINT Extensions
Fifty-six (56) commands (#200 through #255) are available for calling POINT
extensions. You can set them up in the PT. 1N1file as follows.
Assign a character string to any of these 56 commands. The character string begins with
the name of the extension followed, where needed, by an argument. These arguments are
passed to the command when it is executed. If the string ends with a space, the user is
prompted for additional arguments to t;e command.
An extension is treated as primary if its name is immediately followed by an
An example of an extension is M2ASSIST, as described in Appendix D.
D ·138
* (asterisk).
The M2ASSIST Environment
Appendix D
The M2ASSIST Environment
What M2ASSIST Does
M2ASSIST integrates the POINT
Editor with the LOGITECH Modula-2 system. It lets
you check the Modula-2 syntax of your program, compile it, look at compilation errors,
link, and run, without exiting POINT.
These and other M2ASSIST functions are described on the following pages.
D ·139
AppendixD
Check Syntax
Check Syntax checks the M odula-2 syntax of text in the active window.
It highlights the line of text where the first error has occurred, and uses the bottom line of
the screen to display the error message associated with the error in that line.
Compile
Compile lets you compile the file in the active window.
Compile begins by asking for compiler options.
You are prompted the last-used option. (Esc) lets you abort the request.
It saves the file in the active window and clears the screen.
It then runs the overlay version of the LOGlTECH Modula-2 Compiler.
If it detects an error in the file, the compiler creates a .LST listing file. The source file is
tagged with error messages from the listing file for examination with the Next Error
function.
Current error messages are discarded if the window is closed, or if the file is saved or
recompiled.
When compilation is done, any key or mouse button returns you to the editing session.
D ·140
The M2ASSIST Environment
Find Next Error
Find Next Error highlights the next statement in the active window tagged with a
compilation error message after invoking Compile or Load Listing.
You can insert/delete lines of text in the file and then go to the next tagged error.
Corresponding error messages from the . LST file show in a temporary error window at
the bottom of the screen.
The error window closes at the first user action.
Link
Link links the .OBJ file associated with the active window.
Link begins by asking for linker options.
You are prompted for the last-used option. (Esc) lets you abort the request.
Link clears the screen and calls the LOGITECH M odula-2 Linker.
When linkage terminates pressing any key or mouse button returns you to the POINT
editing session.
t
Run
Run executes the .EXE file associated with the active window.
When execution terminates press any key or mouse button to return to the POINT
editing session.
t
Load Listing
Load Listing reads the .LST file associated with the active window.
Error messages are tagged in the source file and can be looked at sequentially with
Find Next Error as explained above.
t
D -141
AppendixD
Load Templates
Load Templates loads the file
Modula-2 constructs.
M2ASSIST.INI,
which contains templates for
A template is a sequence of characters which can be inserted in the active window at the
current cursor position.
The _ (underscore character) in the template tells the cursor where to appear after the
template is inserted.
A template is identified by @ ,followed by a letter in the set [a.. zJ.
Here is a template from the current release of M2ASSIST.INI.
@h
<*
Title:
LastEdit:
Author:
System:
LOGITECH MODOLA-2 Version 3.0
<*
Text following the @h is inserted at the cursor position in the active window.
The cursor is then repositioned just before .
Quit M2ASSIST
Quit M2ASSIST releases the memory used by M2ASSIST.
Help
Help contains general information related to M2ASSIST functions.
Press any key or mouse button to return to the editing session.
D -142
The M2ASSIST Environment
How M2ASSIST Runs - About POINT Extensions
M2ASSIST
is an extension of POINT (See Appendix C).
The current release of M2ASSIST actually consists of two extension modules:
M2ASSIST.PTO and CHECKER.PTO.
M2ASSIST.PTO is a primary extension and CHECKER.PTO is a secondary extension.
The functions ofM2ASSIST.PTO are:
Argument
0
1
2
3
4
5
6
7
@x
Function
Quit
Compile
Goto Error
Link
Read Listing
Run
Read M2ASSIST
Help
Template
CHECKER.PTO has no arguments.
D -143
AppendixD
To run M2ASSIST, you must bind a key to a specific M2ASSIST function in the PT.INI
file.
Consider the following lines in PT. 1NI:
c201="m2assist.pto 1"
k063=201
These lines bind function key (FS) (k063) to command 201, which specifies the
Compile function from M2ASSIST.PTO. Note that M2ASSISTis defined as primary.
Analogously, to bind CHECKER.PTO to (F2J ,place the following lines in PT.lNI:
c202="checker.pto"
k060=202
To bind a key to a template in M2ASSIST.INI, give the template name as an argument to
M2ASSIST.PTO.
For instance, these lines
c210="m2assist .pto @x"
k064=210
insert template @x at the cursor position when you press I F6).
The distributed file PTM2.INI is an example of an initialization file set up to recall the
function.
M2ASSIST
D -144
Non-Mouse Reference
AppendixE
Non-Mouse Reference
If you work on more than one system, you will occasionally work on one without a
mouse. For this reason, a non-mouse interface is included here. Although non-mouse
use is only occasional, we have made it as close as possible to the mouse interface.
Cursor keys move the mouse cursor, and other keys simulate mouse buttons.
Mouse button keys simulate a completed click rather than a press or a release by itself:
you can't hold down a simulated mouse button.
Some mouse commands are simulated by two keystrokes on the numeric keypad on the
right side of the keyboard.
D -145
AppendixE
Mouse Simulation Command Table
Key
Moves Mouse Cursor ..•
(~)
1 space left
1 space right
1 word left
1 'Nord right
1 row up
1 row down
B
(CtrIH~)
r~trlV ~ 1
~~
CD
OJ
First Key
Next Key
Cursor Moves .••
Gray(±)
B
B
CD
OJ
~
~
[Home]
~
10 columns left
10 columns right
6 rows up
6 rows down
6 rows up and 10 columns right
6 rows down and 10 columns right
6 rows up and 10 columns left
6 rows down and 10 columns left
First Key
Next Key
Next key moves within window to...
GrayE)
B
B
CD
OJ
~
~
[Home]
~
Left edge of window
Right edge
Top edge
Bottom edge
Top border
Bottom border
Left border
Right border
D ·146
Non-Mouse Reference
First Key
Next Key
Next key moves within screen to...
[Home]
EJ
EJ
CD
CD
Left edge of screen
Right edge
Top edge
Bottom edge
Next key moves within window to ..•
~
~
Middle of window
Middle of window
Next key moves on the line to •..
[Home]
[End]
Beginning of line
End of line
First Key
Next Key
Next key simulates mouse click...
[End]
~
~
CD
(_DO]
[0_0]
[00_]
EJ
~_OO]
Gray(±]
~o_o)
GJ
~OO_]
[Home]
CD
@@-[_ 0 0]
@@-[O_OJ
@@-[O 0 _)
8
@1_00]
~
Gray
D -147
AppendixE
Using Mouse Keys with a Mouse
Mouse simulation keys work differently if you use a mouse.
Cursor movement keys move the mouse cursor and the selection. This is normally what
you want when you have a mouse since it saves additional keystrokes to move the
selection after the mouse cursor is moved. Since the selection moves, the screen must be
redrawn after each cursor movement command. This makes these commands somewhat
slower.
If cursorMouse is set to 1, mouse cursor simulation will only move the mouse cursor
even if a mouse is present.
D ·148
Quick Reference
AppendixF
Quick Reference
The following pages contain reference tables of keyboard and mouse button actions.
D -149
AppendixF
Function Keys
[ftShift !
@or[Ctrl!
Delete
To Scrap
Delete,
Not to Scrap
NO ACTION
Insert from
Scrap
NO ACTION
NO ACTiON
[F3]
Quit & Save
All Files
Quit & Discard
All Edits
Quit & Ask
About Files
[F4]
Duplicate
text
Copy to
Scrap
NO ACTION
[FS]
Extract text
NO ACTION
NO ACTION
[FS]
Search for
Selection
Search for
String
Search
Backwards
[F7]
Go Back To
Last Place
Go To
Selection
Go To Line
Number
[Fa]
Redo Last
Edit
Find Matching
Bracket
NO ACTION
[F9]
Undo Last
Exit
Undo, Erase
History
Go to Selected
Line Number
[F10]
Redraw the
Screen
Load Selected
FileName
New Window
Selected File Name
KEY
(ill
[F2!
D -ISO
Quick Reference
Alt-Letter Keys
Enter ASCII character.
Bottom the active window.
Close the active window.
Execute the DOS command interpreter.
Exchange the selection with the scrap.
Goto line number.
Enter the help system.
Display debugging information.
Load new file into the active window.
Record keystrokes in the macro buffer.
Create new window.
Toggle overtype mode and insert mode.
Play back keystrokes from the macro buffer.
Quit and ask about unsaved files.
Global replace.
Save file in the active window.
Toggle 43 line mode. IBM EGA only.
Undo.
Write file in the active window.
Hide the window.
Zoom or unzoom the active window.
D -151
AppendixF
Keypad Cursor Keys
Key
Command
Scroll up
Scroll down
Go to End of file
Go to Beginning of file
Move cursor to edge of screen
Simulate mouse buttons
Move mouse cursor one space in any direction
Move mouse cursor one word (blank-delimited) left
Move mouse cursor one word (blank-delimited) right
Grey(±]
GreyG
[Del)
~
(~ Back]
@!ill-( ~
Back)
Fast cursor motion
Move cursor to window edges and comers
Delete selection to scrap
Insert from scrap
Delete previous character
Delete previous word
Cancel command
Stop current editor action
D -152
Quick Reference
Mouse Command Chart
Cursor
Position
(_DO]
[0_0]
[00_)
Outside
Window
NO ACTION
menu
NO ACTION
Inside
Window
Select
text
TOPLIST
menu
Extend
selection
Any
Corner
Toggle window
top!bottom
NO ACTION
Stretch
window
Top
Border
Activate
window
Split window
(vertical)
Move
Window
Right
Border
NO ACTION
Split window
(horizontal)
NO ACTION
Left
Border
Scroll Up
Thumb
(by line)
Scroll Down
Bottom
Border
Scroll Left
Thumb
(by column)
Scroll Right
TOPLIST
D -153
AppendixF
Notes:
D -154
INDEX
POINT Index
D
A
Define key specifications, 112, 112
Delete
text, 90
Display, monitor, 10
color, 58
enhanced graphics adapter, 58, 126
monochrome, 10,58
video attributes, 58
DOS
command interpreter, 125
Active window, 19,22,27
[Alt] keys (default), 151
ASCII code, 38
AutoIndent, 53
B
.BAK files, 95
Banner line, 19, 84, 85
Beginning
offlle, 107
of line, 45
of selection, 34
Borders, 86
command shell, 42,125
fIle handles, 10
Double click, 19
Double line border, 86
Duplicate text, 35, 118
Bottom,
window, 110
line, 82,83
Buffer, 53
E
Edges and borders, 86
EDITING menu, 36
globalreplace, 38
insert ASCII characters, 38
redo last edit, 36
undo last edit, 37
Elevator, 86
End-of-fIle, 107
c
Color,
codes, 59
interactive settings, 110
options, 83,94
Column numbers, 61, 131
Command line options, 97
Comment Line, 14
COMSPEC, 54
End-of-line character, 87
Enhanced Graphics Adapter (EGA),
Erase history, 121
Escape, 99
CONFIG.SYS, 10
Configuration, 10
Copy, 33,117
duplicate, 35,118
from scrap, 33,118
Extend selection, 89
Extensions, 137
with mouse, 34
Cursor, 13,
D ·157
POINT Index
F
I
Files. 84. 95. 104
DOS file manipulation.
IgnoreCase. 54
Initialization file. 51-77
Command Codes, 61
handles. 10. 95
names. 84
patterns. 54. 94
Load file from selection. 104
PT.INI. 52
.INI files. 52
Menu commands. 67 -70
Mouse Motion, 71-74
POINT files. 8
INI files. 8
PT.EXE.8
PT.HLP.8
Mouse sensitive window points. 75
Insert ASCII character. 38, 92
Insert character, 29.91
PTTEMP.XXX. 95
Insertion point. 13,91
Internal buffers. 53
UNNAMED.X. 95. 100
Read-only files. 96. 105
Save file, 104
K
View a file. 25
Flicker, 58
Keyboard.
commands. 151
macro buffer. 123
Keystroke commands. 151,152
G
Go back to last place. 108
Go To
L
beginning of file. 107. 108
end of file. 107
line number. 108
selected line number. 108
Line and column numbers. 85
Load
file, 104
selection. 108
filePattem. 94
H
M
HELP, 15.42, 126
Hexadecimal digits, see color settings
M2ASSIST, 139
Macro, 121
keyboard macro buffer, 121
play back macro. 122
Hidden window. 100
BeginlEnd, 53. 122
MakeBaks, 55
Match bracket character. 108
D ·158
POINT Index
p
Menus, 16
main, 14
pull-down menus, 17
Menu commands, 109
Mouse
banner line command, 85
cursor, 44
driver, 10
motion, 71-4,114-116
sensitive window points, 50, 75
simulation, 45,47-8
three button, 44
two button, 44
Move, 119
using the scrap, 33
without the scrap, 34, 119
MOVING menu
Search Backwards, 40, 56
Search for Selection, 40, 56
Search for String, 39, 56
Play back keyboard macro, 122
Prompt, 93
Pull-down menus, 17
Q
Quit (command), 124
QUIT+ETC (Quit Options), 41,124
Escape to DOS Shell, 42, 124,125
Quit and ask, 41
Quit and discard, 41,124
Quit and save, 41,124
R
Redefine keys, buttons & mouse motion
commands, 112
Redo, 120
undo, 121
Redraw screen, 42
RightMargin, 126
N
New
window, 100
pattern, 94
s
SAVE
file, 27
message, 84
save as ... , 27
Screen, 13
bottom line, 82-3
selection, 83
top line, 82, 83
Scroll, 25-26, 105-6
o
Options, 94
Command Line, 97
.INI options, 53,59
OPTIONS menu, 110
borderColors, 60
msgColors, 60
textColors, 60
OverType, 85,91
D -159
POINT Index
v
Search, 56
backwards, 56,107
for selection, 56, 107
for string, 106
global, 56
options, 56
replace, 107
SearchMode, 56
Select
active window, 19
end-of-line, 89
text, 13, 30, 88
words and lines, 31-3,89
Simulate a mouse, 145
VideoMode, 58
Video attributes, 58
w
Windows, 18,19
active, 22,
close window, 20,101
colors, 101
corners, 86
exchange, 103
hide, 100
load file, 104
move, 23, 103
multiple, 21
new window, 18,100
overlapped, 22
reshape, 24
resize, 24,102
split window, 101
stretch, 24, 103
top, 102
zoom, 24,102
WorkDrive, 58
Write
file, 104
with new name, 104
T
Text insertion, 29
Thumb,25
horizontal, 106
vertical, 106
Top, 102
bottom window, 102
Top line commands, 109
Top window, 102
TOPUSTmenu, 22,110
TopOnFind, 57
u
Undo commands, 57,120
erase history, 57,121
reversible, 57, 121
UndoBack, 57
UndoSize, 57
User-defined menus, 109
y
Yes/No questions, 15
z
Zoom window, 102
D-160
Reader's Critique
The LOGITECH Publications Department wants you to have manuals that meet your
needs. Once you use this manual, please take a few moments to answer the a few
questions. This will help us to provide manuals that you and others can really use.
Nfumual: __________________________________________________
Mouse Type: Serial (C7)_ _ Bus_ _ Series/2_ _ Other._ _ _ _ _ __
Mouse Software, Version Number:
Make and model of computer:
DOS Version:
How are we in the following areas?
(1
=Highest 5 =Lowest)
Installation
Reference
Clarity of instructions
Logical organization
Completeness of information
Usefulness of boldface, italics
Usefulness of artwork
Usefulness of screens
Usefulness of examples
Ease of finding information
How much computer experience do you have? _ _ _ _ _ _ _ _ _ _ _ _ __
How would you improve this manual?
We appreciate any other comments or suggestions you have regarding this manual.
Please mail your completed card to:
LOGITECH, Inc.
Publications Department
6505 Kaiser Drive
Fremont, CA 94555
USA
LOGITECH, Inc.
Publications Department
6505 Kaiser Drive
Fremont, CA 94555
USA
LOGITECHTMMOUSE
"The Logitech Bus Mouse and Serial Mouse ... have an
exceptionally good 'Jeel;' moving smoothly across a
desktop with just enoughjriction to allow for precise
cursor control:'
PC Magazine Editor's Choice
August 1987
"To sum up my feelings about this mouse and menu
generating system: this is the one I want:'
PC Magazine Editor's Choice
January 27, 1987
"The Logitech Mouse represents a melding of the best
features of .. its major competitors."
Jeff Duntemann
PC Tech Journal
~LOGITECH
Logitech U.S.A.
Corporate Headquarters
6505 Kaiser Drive
Fremont, CA 94555
Tel: 415-795-8500
Logitech Switzerland
European Headquarters
CH-llli RomanellMorges
Switzerland
Tel: 41-21-869-96-56
Logitech Taiwan
Far East Headquarters
15 R&D Road 2
Science Based Industrial Park
Hsinchu, Taiwan, ROC
Tel: 886-3-577-8241
AJgol-Logitech Italy
Via Durazzo 2
20134 Milano Ml
Italy
Tel: 39-2-215-5622
Source Exif Data:
File Type : PDF
File Type Extension : pdf
MIME Type : application/pdf
PDF Version : 1.3
Linearized : No
XMP Toolkit : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-21:37:19
Create Date : 2015:09:05 11:38:36-08:00
Modify Date : 2015:09:05 11:48:35-07:00
Metadata Date : 2015:09:05 11:48:35-07:00
Producer : Adobe Acrobat 9.0 Paper Capture Plug-in
Format : application/pdf
Document ID : uuid:56307512-82a1-a844-89a3-da4c5b2c0748
Instance ID : uuid:d1f1fb9e-e662-b342-8bd8-7de0d0b3894c
Page Layout : SinglePage
Page Mode : UseNone
Page Count : 324
EXIF Metadata provided by EXIF.tools