Category : C Source Code
Archive   : TCMOUS.ZIP
Filename : TCMOUS.DOC

TURBO C MOUSE 1.00 DOCUMENTATION
--------------------------------

Copyright (C) 1991 by Craig Thurber. All Rights Reserved
9255 South 1520 East, Sandy, Utah 84093
CIS 72711,735, GEnie C.Thurber, Voice: (801) 571-8119, Modem: (801) 572-1704


Table of Contents
-----------------
1. Description.............................. 1
2. Quick Start.............................. 1
3. Installation............................. 2
4. Operation................................ 2
5. Registration............................. 2
6. Utilities Menu........................... 3
7. Right Button Menus....................... 4
A. Block............................... 4
B. Find/Replace........................ 4
C. Insert/Delete....................... 5
D. Files............................... 5
E. Cursor.............................. 5
F. Utilities........................... 5
G. Quit................................ 6
8. Left Button Menus........................ 6
A. File................................ 6
B. Edit................................ 7
C. Run................................. 7
D. Compile............................. 7
E. Project............................. 7
F. Options............................. 8
G. Debug............................... 12
H. Break/watch......................... 12
9. Copyright, License and Warranty.......... 12


1. Description
-----------
This is a Microsoft mouse menu program for use with Borland's Turbo C
integrated environment. It has a utility menu, which can be customized
by the author (see below), and is operative both within the Turbo C
environment and within most other DOS environments. This utility menu
contains a "point and shoot" ASCII character menu which will type
highlighted ASCII characters upon pressing a mouse button. The utility
menu contains 10 customizable entries, which can be used for simulating
any keystrokes that can be typed by the Microsoft mouse. The author
will write the code for this customization upon registration and payment
of a fee for the programming service.

2. Quick Start
-----------
Place the files TCMOUS.MNU and MENU.COM in the same directory. Change to
this directory. Type MENU TCMOUS. The message "Menu installed" will
appear if the operation is successful. Within the Turbo C environment,
the left mouse button generally activates the Turbo C menus and acts as
an key. The right mouse button activates the WordStar, Utilities
and other command menus. Pressing both buttons at the same time is the
same as hitting the key.






TURBO C MOUSE 1.00 DOCUMENTATION Page 2


When the mouse menu is loaded into memory, and you are not working in
the Turbo C environment, the right mouse button activates a utilities
menu. See below for a description of this menu.

To remove the mouse menu from memory, change to the directory that
contains the file MENU.COM and enter the command MENU OFF.

3. Installation
------------
Copy the files TCMOUS.MNU and MENU.COM to the same directory.

4. Operation
---------
TCMOUS.MNU was written for the Microsoft mouse and a color monitor.
Performance of the program with other equipment is unknown at this time.
The mouse driver must be installed before TCMOUS.MNU will operate. This
is generally accomplished by adding a statement to your AUTOEXEC.BAT
file. It is recommended that this statement be MOUSE /S50. The switch
/S50 provides a sensitivity that is tolerable.

The mouse menu program should be loaded before Turbo C. The command to
load the mouse is MENU TCMOUS. If the mouse is successfully loaded,
the message "Menu installed" will appear. The mouse is initially
activated by pressing the left mouse button. If you have the evaluation
copy of the program, you will be presented with a series of intolerable
advertising screens that require you to press the left mouse button
until the word AGREED appears on the screen. The program is fully
active and complete after this is done. The evaluation copy of the
program is not a "shaved down" version.

If you have registered your copy of the program, press the left button to
activate the mouse. A screen will appear which tells you that the mouse
program is active. It also lists the registered owner and registration
number. Please cite this data in all correspondence about the program.

5. Registration
------------
The registration form can be printed from the file REGIS.FRM. Please
use the form for registration. The form is in ASCII format, and may be
imported into a word processor, completed, and then sent to the author.
This procedure is recommended, especially if you are designating custom
menu entries. It will help me avoid entering the wrong code.

The registration fee is $15 plus $2.50 shipping and handling. It should
be sent to the author at the above address. Registered users will
receive the latest version of the program, as well as the next program
update, when it becomes available. The registered version uses 7Kb
less memory than the distribution version, and does not require toler-
ation of the irritating advertising that I wrote to encourage registr-
ation.

For an additional fee of $10, at the time of registration, up to ten
custom menu entries can be specified. These will be written into your
copy of the program. Some examples are shown in the section on Custom
Menus in this document, and represent the extent of coding the author
expects to perform for this fee. If the coding you request signifi-
cantly exceeds the amount shown as examples in this document, the
charge for coding time will be $50 per hour. You may either make a





TURBO C MOUSE 1.00 DOCUMENTATION Page 3


reasonable estimate of the time required, and enclose payment with
your registration, or you may request an estimate for the service from
the author.

If you have registered a copy of the program, and later decide to have custom
menu entries written or changed, the fee for this service will be $15 plus
$2.50 shipping and handling. The terms and conditions of such services are
as mentioned above. Please use the registration form when requesting such
services, and enter your registration number on the form.

6. Utilities Menu
--------------
An utilities menu is activated by the right mouse button, and should
work in most environments. Exceptions will occur when the program
finds a match with one of the Turbo C checks that it makes, and you
will be presented instead with the Turbo C menu. This is not a dead
end. Simply select Utilities from this menu and you will have access
to the menu selections.

The utilities menu includes a "point and shoot" ASCII chart. All of
the ASCII characters are displayed on the screen. Highlight the ASCII
character that you wish to type and press a mouse key. If your current
environment accepts ASCII key entries, the character you have chosen
will be displayed on the screen.

The utilities menu also contains a "Custom Keys" selection. These 10
options do nothing in the distribution copy of the program. They can
be named and coded to your specifications at the time of registration.
For example, in my own copy of the program the Custom Key selection
presents the menu shown below, with the selections typing the code
listed below each menu item. The code 013 indicates that the
key is pressed.

Custom Keys
-----------
Name
Craig Thurber
Address
9255 South 1520 East,013,Sandy, Utah 84093
Backup A:
b:\,013,cd\,013,xcopy a:\ /s/m,013,a:\,013
C:\MENU
c:\,013,cd\menu,013,menu,013
Turbo_C
e:\,013,cd\turbo_c,013,tc,013
Turbo_C++
e:\,013,cd\tc\bin,013,tc,013
Turbo Pascal
d:\,013,cd\tp,013,tp,013
Lotus 1-2-3
c:\,013,cd\123,013,Lotus,013
WordPerfect
c:\,013,cd\wp50,013,wp,013
Procomm
d:\,013,cd\procomm,013,pcplus,013
Help
Cancel

The utility menu also contains an entry to type EXIT , which is a
common command to return from a DOS shell to a running program.



TURBO C MOUSE 1.00 DOCUMENTATION Page 4


7. Right Button Menus
------------------
The right mouse button generally activates the WordStar, Turbo_C hot
keys, the Alt-key menu and other features. These are described below
for the cases in which they either differ from the commands described
in the Turbo C User's Guide, or are unique to this mouse program.

A. Block
Begin Block
End Block
Mark Word
Print Block
Copy Block
Delete Block
Hide/Display
Move Block
Read From Disk
Write to Disk
Indent Block
Outdent Block
Cancel

B. Find/Replace
Find
Go
Forward Search
Backward Search
Search Block Only
Nth Occurrence - user must type value of N
Case Insensitive
Whole Words Only
Clear Options
Cancel
Find and Replace
Go
Forward Search
Backward Search
Search Block Only
Nth Occurrence - user must type value of N
Case Insensitive
Whole Words Only
Clear Options
Cancel
Abort Search
Repeat Last Find
Set Place Marker
Mark 0
Mark 1
Mark 2
Mark 3
Cancel
Find Place Marker
Mark 0
Mark 1
Mark 2
Mark 3
Cancel






TURBO C MOUSE 1.00 DOCUMENTATION Page 5


Match Delimiter
Find Closing
Find Opening
Cancel
Cancel

C. Insert/Delete
Insert Mode On/Off
Insert Line
Delete Line
Restore Line
Delete to End of Line
Delete Char to Left
Delete Char at Cursor
Delete Next Word
Cancel

D. Files
Load New File
New File Name - use left mouse button for .
Save and Edit
Print File
Cancel

E. Cursor
Quick Cursor
Beginning of Line
End of Line
Top of Window
Bottom of Window
Beginning of File
End of File
Beginning of Block
End of Block
Last Cursor Position
Cancel
Move Cursor
Tab
Character Left
Character Right
Word Left
Word Right
Line Up
Line Down
Scroll Up
Scroll Down
Page Up
Page Down
Cancel
Cancel

F. Utilities
Language Help
Alt Key Menu
Help - help for editor commands.
Zoom
Switch - editor <--> messages.






TURBO C MOUSE 1.00 DOCUMENTATION Page 6



Trace - This selection changes the assignments of the
mouse keys. The left mouse button is equivalent
to pressing the F7 key, and will continue tracing
through the program one line at a time. The
right mouse button will run the program to the
current cursor location. Pressing both mouse
buttons resets the mouse, and resets the program
trace (equivalent to pressing Ctrl-F2).
Step
Make
Menu - main Turbo C environment menu.
Alt-Menu
Last Help
Pick
Swap
PrevError
Next Error
Compile
Quit
Quit
ASCII Chart - An ASCII chart is displayed. Highlight a character
and press either mouse button to type the highlighted
character.
Custom Keys - inactive until programmed at additional cost.
Custom-1
Custom-2
Custom-3
Custom-4
Custom-5
Custom-6
Custom-7
Custom-8
Custom-9
Custom-0
Help
Cancel
Autoindent On/Off
Control Char Prefix
Toggle Menus/Window
Optimal Fill Mode
Tab Mode
Unindent
Cancel

Quit
Abort Operation
Save and Quit
Quit no Save
Verify Save? (Y/N) - if file has been changed since last saved.
Cancel


8. Left Button Menus
-----------------

A. File
Load F3
Load File Name




TURBO C MOUSE 1.00 DOCUMENTATION Page 7



Pick Alt-F3
Recent Files
New
Rename F:\NONAME.C
New Name
Verify
Save F2
Write to
New File Name
Directory
Enter File Name
Change dir
New Directory
OS shell
Quit Alt-X
Save?

B. Edit

C. Run
Run Ctrl-F9
Program reset Ctrl-F2
Go to cursor F4
Trace into F7
Step over F8
User screen Alt-F5

D. Compile
Compile to OBJ F:NONAME.OBJ
Make EXE file F:NONAME.EXE
Link EXE file
Build All
Primary C file:
Primary File *.C
Get info
Information
Current directory : F:\
Current file : F:\NONAME.C
File size : 0 (Max: 64603)

EMS usage : OK
Lines compiled: 0 No program loaded.
Total warnings: 0 Program exit code
Total errors : 0 Available memory: 216K

E. Project
Project name
Project Name *.PRJ
Break make on
Warnings
Errors
Fatal errors
Link
Auto dependencies
On
Off - default
Clear project
Remove messages




TURBO C MOUSE 1.00 DOCUMENTATION Page 8



F. Options
Compiler
Model
Tiny
Small
Medium
Compact
Large
Huge
Defines
Define Symbols
Code generation
Calling convention
C
Pascal
Instruction set
8088/8086
80186/80286
Floating Point
Emulation
8087/80287
None
Default char type
Signed - default
Unsigned
Alignment
Byte
Word
Generate underbars
On - default
Off
Merge duplicate strings
On
Off - default
Standard stack frame
On - default
Off
Test stack overflow
On
Off - default
Line numbers
On
Off - default
OBJ debug information
On - default
Off
Optimization
Optimize for
Size - default
Speed
Use register variables
On - default
Off
Register Optimization
On
Off - default
Jump optimization
On
Off - default



TURBO C MOUSE 1.00 DOCUMENTATION Page 9



Source
Identifier length
Maximum Length - (range 1 - 32)
Nested Comments
On
Off - default
ANSI keywords only
On
Off - default
Errors
Errors : stop after 25
Maximum Errors - (range 0 - 255)
Warnings: stop after 100
Maximum Warnings - (range 0 - 255)
Display Warnings
On - default
Off
Portability Warnings
A: Non-portable pointer conversion
On - default
Off
B: Non-portable pointer assignment
On - default
Off
C: Non-portable pointer comparison
On - default
Off
D: Constant out of range in comparison
On - default
Off
E: Constant is long
On
Off - default
F: Conversion may lose significant digits
On
Off - default
G: Mixing pointers to signed and unsigned char
On
Off - default
ANSI Violations
A: 'ident' not part of structure
On - default
Off
B: Zero length structure
On - default
Off
C: Void functions may not return a value
On - default
Off
D: Both return and return of a value used
On - default
Off
E: Suspicious pointer conversion
On - default
Off
F: Undefined structure 'ident'
On - default
Off




TURBO C MOUSE 1.00 DOCUMENTATION Page 10



G: Redefinition of 'ident' is not identical
On - default
Off
H: Hexadecimal or octal constant too large
On - default
Off
Common Errors
A: Function should return a value
On
Off - default
B: Unreachable code
On - default
Off
C: Code has no effect
On -default
Off
D: Possible use of 'ident before definition
On -default
Off
E: 'ident' is assigned a value which is never used
On - default
Off
F: Parameter 'ident' is never used
On - default
Off
G: Possibly incorrect assignment
On - default
Off
Less Common Errors
A: Superfluous & with function or array
On
Off - default
B: 'ident' declared but never used
On
Off - default
C: Ambiguous operators need parentheses
On
Off - default
D: Structure passed by value
On
Off - default
E: No declaration for function 'ident'
On
Off - default
F: Call to function with no prototype
On
Off - default
Names
Code names
Segment name
Group name
Class name
Data names
Segment name
Group name
Class name
BSS names
Segment name
Group name
Class name


TURBO C MOUSE 1.00 DOCUMENTATION Page 11



Linker
Map file
On
Off - default
Initialize segments
On
Off - default
Default libraries
On
Off - default
Graphics library
On - default
Off
Warn duplicate symbols
On
Off - default
Stack warning
On - default
Off
Case-sensitive link
On - default
Off
Environment
Message Tracking
Current File
Off
All Files
Keep messages
Yes
No - default
Config auto save
On
Off - default
Edit auto save
On
Off - default
Backup files
On - default
Off
Tab size 8
Editor Tab Size - (range 2 - 16)
Zoomed windows
On
Off - default
Screen size
25 line display
43/50 line display
Directories
Include directories: E:\TURBO_C\INCLUDE
Include Directories
Library directories: E:\TURBO_C\LIB
Library Directories
Output directory:
Output Directory
Turbo C directory: E:\TURBO_C
Turbo C Directory
Pick file name:
Pick File Name
Current pick file:
Current Pick File



TURBO C MOUSE 1.00 DOCUMENTATION Page 12


Arguments
Command Line Parameters
Save options
Config File
Retrieve options
Config File

Debug
Evaluate Ctrl-F4
Evaluate
Result
New value
Call stack Ctrl-F3
Find function
Refresh display
Display swapping
None
Smart - default
Always
Source Debugging
On - default
Standalone
None

Break/watch
Add watch Ctrl-F7
Add watch
Delete watch
Edit watch
Edit watch
Remove All watches
Toggle breakpoint Ctrl-F8
Clear all breakpoints
View next breakpoint

9. Copyright, License and Warranty
-------------------------------
This document and the program TCMOUS.MNU are copyrighted by the author.
Only the limited, unregistered form of this software may be distributed.
You may make as many copies of the limited version and documentation
as you wish. These copies may be distributed to anyone by any means,
including electronic means.

However, you are specifically prohibited from charging, or requesting
donations, for any such copies, and from distributing the software
and/or documentation with commercial products without prior permission
from the copyright owner. An exception is granted to not-for-profit
organizations, which are authorized to charge not more than $7 for
distribution of the limited version of this software. No for-profit
organization is authorized to charge any amount for distribution of
copies of the software or to include copies of the software or
documentation with sales of their own products.

This includes a specific prohibition against for-profit organizations
distributing the software, either alone or with other software, and
charging a "handling" or "materials" fee or any other such fee for
the distribution. No for-profit organization is authorized to include
the software on any media for which money is charged. Exceptions are
only granted by specific license from the copyright owner.



TURBO C MOUSE 1.00 DOCUMENTATION Page 13


No copy of the software may be distributed or given away without this
document.

There is no warranty of any kind. The copyright owner is not liable for
damages of any kind. By using this software you agree to this.

The software and documentation are:

Copyright (C) 1991 by Craig Thurber. All Rights Reserved
9255 South 1520 East, Sandy, Utah 84093

CIS 72711,735
GEnie C.Thurber
Voice: (801) 571-8119
Modem: (801) 572-1704 (by appointment only)