CydandClaude Fable 5
db7745fcd0
Un-ignored: the dev drive is the ground truth the restoration and emulator work constantly reference (DPL3/LIBDPL + VRENDER i860 renderer source, BT/RP live+dev game trees, VGL_LABS pod boot, scene/audio content). Kept in-repo for the pod-owner community. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
426 lines
18 KiB
Plaintext
426 lines
18 KiB
Plaintext
|
|
|
|
Welcome to BRIEF Version 3.1
|
|
----------------------------
|
|
|
|
Thank you for choosing BRIEF! This file contains: 1) a summary of
|
|
new and changed features since BRIEF Version 3.0, 2) documentation
|
|
changes made after the new manuals went to press, and 3) a summary of
|
|
mouse button assignments for macros that use the mouse. For users
|
|
upgrading from BRIEF Version 2, a summary of new and changed features
|
|
since BRIEF Version 2.11 is included at the end of this file.
|
|
|
|
For owners of CHARGE - The Software Performance Analyst. An updated
|
|
version of profile.cb is available from the Solution Systems bulletin
|
|
board. The phone number is 1-617-237-8530.
|
|
|
|
For owners updating from a previous version of BRIEF to BRIEF 3.1.
|
|
The addition of mouse support requires changes to the _init macro
|
|
in your initials macro. These changes are done automatically by
|
|
SETUP; but you must allow SETUP to update your initials macro. At
|
|
the end of SETUP, when prompted to to update your intials macro; either
|
|
allow the update, or write the changes to another file and replace
|
|
the _init macro in your old initials macro with the _init from the
|
|
new initials macro.
|
|
|
|
|
|
|
|
Summary of New and Changed Features from BRIEF 3.0 to BRIEF 3.1
|
|
-----------------------------------------------------------------------
|
|
|
|
Mouse Support
|
|
|
|
BRIEF supports 2- or 3-button Microsoft-compatible mice.
|
|
Mouse button assignments are similar to Windows 3.0 button
|
|
assignments; a complete list is available in Chapter 3,
|
|
"Command Overview," in the BRIEF DOS-OS/2 User's Guide. The
|
|
mouse is also accessible from the macro language by using
|
|
new macro language functions. Chapter 8, "Programming the
|
|
Mouse," in the BRIEF DOS-OS/2 Macro Language Guide describes
|
|
how to program the mouse. Mouse button assignments for the
|
|
various macro packages also are included in this document.
|
|
|
|
A sample mouse event handler is available in mouse.cb. Examples
|
|
of using the mouse inside macros can be found in:
|
|
|
|
buffers.cb dialog.cb dlg_list.cb
|
|
dlg_menu.cb dlg_mous.cb errorfix.cb
|
|
help.cb keys.cb prompt.cb
|
|
pvcs.cb search.cb tlib.cb
|
|
|
|
Mouse support necessitated the addition of close and zoom buttons
|
|
and scroll bars. If these controls are enabled and your macros
|
|
create windows, the controls will appear on the windows. The
|
|
controls maybe hidden using set_ctrl_state. To use the controls
|
|
with the mouse your macro will require a mouse event handler.
|
|
The above list of macros contain mouse event handlers. Also
|
|
mouse.cb is a sample event handler. Please see Chapter 8,
|
|
"Programming the Mouse," in the BRIEF DOS-OS/2 Macro
|
|
Language Guide for complete details. Pushing and popping
|
|
keyboards also affect the current mouse event handler.
|
|
|
|
|
|
Redo Command
|
|
|
|
A redo command is now available. Redo allows you to redo
|
|
previously undone commands until you edit the buffer. Redo
|
|
is assigned to <Ctrl-u>, which was previously assigned to
|
|
Scroll Buffer Up. Scroll Buffer Up is now assigned to
|
|
<Ctrl-e>.
|
|
|
|
EMS Support
|
|
|
|
If EMS memory is available, by default, BRIEF buffers files
|
|
and macros there. EMS memory can be turned off by setting
|
|
the environment variable BEMS=0.
|
|
|
|
Popup Menu Added
|
|
|
|
BRIEF supports a popup menu that is actuated using mouse
|
|
button 2. When actuated, the popup menu appears with its
|
|
top left corner at the current mouse position. During
|
|
SETUP, you can choose how you want to use mouse button 2 to
|
|
display the popup menu, as well as to perform other edits
|
|
such as cut, copy, and paste. When SETUP displays the
|
|
"Default button 2 action" prompt, select from one of the
|
|
two options shown below.
|
|
|
|
"Popup menu" -- If you select this option, mouse button 2
|
|
is given the following assignments:
|
|
|
|
Button 2 click Display popup menu
|
|
Button 2 double click Display popup menu
|
|
<Ctrl> Button 2 click Execute last menu choice
|
|
<Alt> Button 2 click Display last menu
|
|
<Shift> Button 2 click Copy to scrap
|
|
|
|
"Quick edit" -- If you select this option, mouse button 2
|
|
is given the following assignments:
|
|
|
|
Button 2 click Copy to scrap
|
|
Button 2 double click Paste
|
|
<Ctrl> Button 2 click Cut
|
|
<Shift> Button 2 click Display popup menu
|
|
<Shift+Ctrl> Button 2 click Execute last menu choice
|
|
<Shift+Alt> Button 2 click Display last menu
|
|
|
|
Besides using SETUP, you can also change the mouse button 2
|
|
assignment by setting a parameter for set_btn2_action. This
|
|
parameter, which can be either QUICK_MENU or QUICK_EDIT, is
|
|
defined in win_ctrl.h. If set_btn2_action is not called,
|
|
the default assignment for mouse button 2 is QUICK_EDIT.
|
|
|
|
The default popup menu that is displayed can be found in
|
|
\brief\help\popup.mnu. You can customize this menu to suit
|
|
your preferences. Processing for the popup menu can be
|
|
found in \brief\help\popup.cb; it provides a multi-level
|
|
menu structure similar to that of the help menu.
|
|
|
|
Macro package support can be added to the menu by creating
|
|
a sub-menu that can be called from the popup menu. To do
|
|
this, add a line that contains the following:
|
|
|
|
popup menu choice for sub-menu followed by a semi-colon
|
|
"process_popup_menu"
|
|
sub-menu name (in quotes)
|
|
filename of the sub-menu (in quotes)
|
|
height, width, line and column values (optional)
|
|
|
|
For example, the line below adds a new popup menu choice,
|
|
Display My Menu, that displays the sub-menu in my.mnu
|
|
whenever it is selected. New Menu, the name of the
|
|
sub-menu, appears at the top when the sub-menu is
|
|
displayed.
|
|
|
|
Display My Menu ;process_popup_menu "New Menu" "my.mnu"
|
|
|
|
Check Boxes, Radio Buttons, and Push Buttons Added
|
|
|
|
The Dialog Manager now supports check boxes, radio buttons,
|
|
and push buttons. For a complete discussion of these
|
|
features, including the documentation formerly provided in
|
|
dialog.doc, see Chapter 4, "Using Special Features," in the
|
|
BRIEF DOS-OS/2 User's Guide.
|
|
|
|
PWB Macro Included
|
|
|
|
As an alternative to restore.cb, BRIEF now provides a macro
|
|
called pwb.cb that supports the Microsoft Programmer's
|
|
Workbench. Restore.cb lets BRIEF save its state information
|
|
in the PWB state file called current.sts. To use the PWB
|
|
macro:
|
|
|
|
1. Set BFILE= to the drive and directory where current.sts
|
|
resides. PWB keeps current.sts either in the current
|
|
directory (if no INIT environment variable exists) or in
|
|
the first drive and directory specified in the INIT
|
|
variable. For example, if INIT=c:\c600\init;d:\init, then
|
|
set BFILE=c:\c600\init\current.sts.
|
|
|
|
2. Replace -mrestore in the BFLAGS variable with -mpwb.
|
|
BRIEF creates private sections in the state file, and
|
|
updates the [shared-] and [edit-] sections.
|
|
|
|
Longer Status Line Messages
|
|
|
|
Status line messages now can be 80 characters long. Long
|
|
messages overwrite the Line:/Col: display and stay on the
|
|
screen for at least three seconds, until the Line:/Col:
|
|
display needs to be updated, or the time changes. File
|
|
names and prompts displayed in the message area can also
|
|
overwrite the Line:/Col: display.
|
|
|
|
|
|
Compiler Support
|
|
|
|
Support for Borland C++ Version 2.0 has been added.
|
|
|
|
Support for the following compilers has been upgraded to
|
|
the latest versions:
|
|
|
|
Lahey Fortran, F77L, Version 4.10, F77L-EM/32, Version 4.00
|
|
|
|
Alsys ADA, Version 4.4.2
|
|
|
|
These upgrades required a change in the error handling macros.
|
|
|
|
Solution Systems Bulletin Board
|
|
|
|
Many user-written BRIEF macros are available on the Solution
|
|
Systems bulletin board. The phone number is 1-617-237-8530.
|
|
|
|
|
|
Documentation Changes
|
|
-----------------------------------------------------------------------
|
|
|
|
BRIEF DOS-OS/2 Macro Language Guide
|
|
|
|
Descriptions of two new mouse functions, set_mouse_action and
|
|
inq_mouse_action, were omitted from Chapter 9, "Macro Reference."
|
|
Each is described below.
|
|
|
|
set_mouse_action: Declares a new mouse handler.
|
|
|
|
Syntax: set_mouse_action (name)
|
|
|
|
Parameters: name A string containing the name of the mouse handler
|
|
to associate with the current keyboard.
|
|
|
|
Return value: Nothing.
|
|
|
|
Description: This function associates your handler with a new
|
|
keyboard; when the keyboard is pushed, it becomes the
|
|
current mouse event handler. Declare your special
|
|
mouse event handler by putting set_mouse_action after
|
|
the keyboard_push and assign_to_key calls in your
|
|
macro. (If your macro uses the dialog manager,
|
|
declare your handler while processing DIALOG_INIT.)
|
|
When the new keyboard is popped, your handler is also
|
|
popped off the stack, and the mouse event handler
|
|
associated with the original keyboard becomes the
|
|
current handler.
|
|
|
|
|
|
inq_mouse_action: Obtains the name of the current mouse handler.
|
|
|
|
Syntax: inq_mouse_action ()
|
|
|
|
Parameters: None.
|
|
|
|
Return value: The string name of the current mouse handler.
|
|
|
|
Description: By calling this function before doing a keyboard_push,
|
|
you can obtain the name of the handler that was
|
|
current before your macro executed keyboard_push.
|
|
The string name of the handler can be stored in a
|
|
global variable, and then referenced in your mouse
|
|
event handler using execute_macro.
|
|
|
|
|
|
On page 112 in Chapter 8, "Programming the Mouse," replace the
|
|
program statements for the SB_THUMBTRACK case with these new
|
|
statements:
|
|
|
|
case SB_THUMBTRACK:{ // scroll while tracking the thumb
|
|
int new_line;
|
|
save_position();
|
|
|
|
/* Move the thumb to the desired position. We do this
|
|
** to find out what the target line is.
|
|
*/
|
|
set_ctrl_state(VERT_THUMB, parm3);
|
|
|
|
/* Get the target line
|
|
*/
|
|
inq_position(new_line);
|
|
|
|
restore_position();
|
|
|
|
/* Now let _buf_position really move to the new
|
|
** selection. This is done so that the buffer containing
|
|
** buffer info is updated correctly.
|
|
*/
|
|
_buf_position( new_line ); // goto the entry
|
|
}
|
|
|
|
On page 124 in Chapter 9, "Macro Reference," add this paragraph to the
|
|
description of assign_to_key:
|
|
|
|
Different key ids that make assignments to the same key are treated
|
|
differently. For example: <Ctrl-H> and <^H> both appear to specify
|
|
the <Control> key plus the <H> key. But <Ctrl-H> maps to the
|
|
<Control> key plus the <H> key and <^H> maps to the <Backspace> key
|
|
because both have the same ASCII equivalent.
|
|
|
|
|
|
BRIEF DOS-OS/2 User's Guide
|
|
|
|
On page 28 in Chapter 2, "Tutorial," add the following:
|
|
|
|
If you enabled copying of macro source during Setup, the macro source
|
|
for copyrite.cb is copied into \brief\macros. If you did not copy
|
|
the macro source, you can 1) use Setup to install the macro source,
|
|
2) copy the macro statements from this manual, or 3) use an uncompress
|
|
utility to extract the compressed macro source from misc\source.arc
|
|
on the Brief installation disk.
|
|
|
|
Mouse Button Assignments for Various Macros
|
|
-----------------------------------------------------------------------
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Macro <Key Assignment> ³<Modifier> Button
|
|
Command ³ Region
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Buffers <Alt-b> ³
|
|
Delete the file ³ <Ctrl> Click 2
|
|
Edit the file ³ Dbl Click 1
|
|
Exit ³ Click 1
|
|
³ Outside list
|
|
³ Click 1
|
|
³ On close button
|
|
³
|
|
Select an entry ³ 1 Down, Up, Drag, Click
|
|
Write the file ³ Click 2
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Errorfix <Ctrl-p> ³
|
|
Close the error file window ³ Click 2
|
|
³ Click 1
|
|
³ Outside error file
|
|
³ window
|
|
Pick an error entry ³ Click 1
|
|
Select an entry ³ 1 Down, Up, Drag
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Help <Alt-h> ³
|
|
Display key assignment ³ Click 1
|
|
³ In help text window
|
|
Pick a topic ³ Click 1
|
|
³ In help menu
|
|
Previous screen or menu ³ Click 2
|
|
³ Click 1
|
|
³ Outside window or menu
|
|
³ Click 1
|
|
³ On close button
|
|
Exit help ³ <Ctrl> Click 2
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Keys <F10>keys ³
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
|
|
³In left window, default³ ³
|
|
³menu handling plus: ³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
|
|
Exit ³ Click 1
|
|
³ Outside both windows
|
|
Insert a new entry ³ Click 2
|
|
³ Click 1
|
|
³ In right window
|
|
Select an entry ³ Click 1
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
|
|
³In right window, default³ ³
|
|
³menu handling plus: ³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
|
|
Delete an entry ³ <Ctrl> Click 2
|
|
Exit ³ Click 1
|
|
³ Outside both windows
|
|
³ Click 1
|
|
³ On left close button
|
|
Insert a new entry ³ Click 2
|
|
³
|
|
To change to either window ³ Click
|
|
³ In window
|
|
³
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Menus ³
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
|
|
³Default menu handling plus:³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
|
|
Exit the menu ³ Click 1
|
|
³ On close button
|
|
³ Click 1
|
|
³ Outside menu
|
|
Pick an entry ³ Click 1
|
|
³ In client area
|
|
Select an entry ³ 1 Down, Up, Drag
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Prompt <Alt-e> ³
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
|
|
³When a list of files is ³ ³
|
|
³displayed, default menu ³ ³
|
|
³handling plus: ³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
|
|
Close the file list ³ Click 2
|
|
Select and edit the file(s) ³ Dbl Click 1
|
|
Select a file for editing ³ Click 1
|
|
Toggle all selections ³ <Shift> Click 1
|
|
³
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
Routines <Ctrl-g> ³
|
|
Default menu handling ³
|
|
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
|
|
|
|
|
|
|
|
|
|
Summary of New and Changed Features from BRIEF 2.11 to BRIEF 3.0
|
|
-----------------------------------------------------------------------
|
|
|
|
Keystroke macros now can be saved (<Alt-F8>) and restored (<Alt-F7>).
|
|
|
|
Windows now can be zoomed to full screen (and back to original size)
|
|
by pressing either <Alt-F2> or <Ctrl-z>.
|
|
|
|
A macro language with C-like syntax has been added. To translate
|
|
macros from the original syntax, BRIEF contains the utility bc.exe.
|
|
Using the -i option lets you translate macros back to the original
|
|
syntax from the BRIEF macro language syntax.
|
|
|
|
A macro language debugger has been added. It is a full screen source
|
|
level debugger that can debug programs written in either of the BRIEF
|
|
macro languages.
|
|
|
|
Smart indenting and template editing now is provided for Ada, FORTRAN,
|
|
BASIC, Pascal, COBOL, and Modula-2. C support still exists.
|
|
|
|
The maximum number of lines allowed in a file now exceeds two billion.
|
|
To support longer line numbers, integers in the macro language now are
|
|
32 bits.
|
|
|
|
Several new macro language functions have been added:
|
|
inq_window_info, create_tiled_window, display_windows, &=, |=,
|
|
inq_top_left, copy_keyboard, for, do, inq_keystroke_macro, and
|
|
save_keystroke_macro.
|
|
|
|
Parameters to other functions have been changed. Control strings now
|
|
can have up to 10 parameters, and each parameter can be a string or
|
|
an integer.
|
|
|
|
The restore macro now saves and restores tiled windows, as well as
|
|
the other information it has always saved.
|
|
|
|
Multiple files can be selected in file completion menus.
|
|
|
|
File completion menus now are sorted into directories and files, and
|
|
are listed alphabetically within the types. BRIEF may not fully sort
|
|
the file list for a very large directory (due to time constraints).
|
|
|
|
The Next Error command now correctly locates errors in include files.
|
|
|
|
|