[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Bugs and a small man page update.
My Machine: Redhat 5.1, Glibc 2.0.7, gcc-2.7.2.3 (standard gcc c++ NOT
egcs), Kernel 2.1.111, and binutils 2.9.1.0.4. Using Xkb in X.
First the Man page update. There are some preliminary spelling fixes,
minor format changes, and a new section with the major keyboard
bindings. Anyone think we need to put in every menu? If anyone would
like to see something in particular let me know. Be patient I'm just
learning the format of man pages...
Bugs!!: The F2 and F3 keys are still inoperative in any version
(we,xwpe..etc), except for F2 (file save) in the Old-Style key
configuration under Xwpe. Even then the mouse focus must be on the debug
window and it fails to save the file. Using the graphical buttons at the
bottom of Xwpe works fine. All Fkeys seem to be dead in Wpe while
ESC+<Menu letter><Item letter> seem to work just fine.
In Wpe pushing ESC three times will "stick" the key and allow you to
access a menu without pressing both ESC and the Menu letter.
Invoking wpe without a file as an argument results in severe corruption
of the screen and messing of the keyboard. I must log in to another
terminal and do "kbd_mode -a" to recover.
File scrolling(Xwpe): Using the slider blocks refreshing of the text
in the editing window until I release it.
"Cancel" does not appear to have a key letter assigned to it.
That's all for now, the man page is attached, now to go figure out how
to make a proper diff, and make a tar.gz file...they never seem to come
out quite right. Hmmmmmm...
--
James M.
aka "Dart"
A thought for linux users:
"How about that? Together, we're a genius."
-Charlie-
.\" t
.\" @(#)xwpe.1 5/17/97
.de EX \"Begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
..
.de EE
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
..
.ta .3i .6i .9i 1.2i 1.5i 1.8i
.TH xwpe alpha "May 17, 1997"
.UC
.SH NAME
xwpe, xwe, wpe, we \- X-Window Programming Environment
.SH SYNOPSIS
.EX
\fBxwpe\fP [ \fIoptions\fP ] file ...
\fBxwe\fP [ \fIoptions\fP ] file ...
\fBwpe\fP [ \fIoptions\fP ] file ...
\fBwe\fP [ \fIoptions\fP ] file ...
.EE
.SH DESCRIPTION
Xwpe can be used with or without the programming interface.
It has its own X interface but can be used also on a
character terminal.
\fBxwpe\fP fires up the X interface together with the programming
interface. \fBxwe\fP is the X version but without the special
features of the programming interface. In connection with a
simple character terminal you can use \fBwpe\fP to program and
\fBwe\fP as an editor.
Xwpe is a X-window programming environment designed for use
on UNIX-systems. It is similar to the 'Borland C++ or Turbo
Pascal' environments. The differences between the programming
environments from Borland and Xwpe are that many compilers, linkers,
and debuggers can be used in Xwpe. Menus and commands are
acessible via both the keyboard and mouse.
Errors that occur while compiling and linking a program
can be examined in the sources. The cursor will jump to the
corresponding line in the source-file. Programs using
more than one source-file can be managed with the so called
"project-option" (see also \fIproject-file\fP).
The program can be started from within the
\fIProgramming-Environment\fP and errors may be found using a
debugger. The \fIdebugging-environment\fP allows the user to set
and unset breakpoints directly in the source code. The
contents of variables may be displayed in a special window,
the \fIWatch-Window\fP. This window is updated while reaching a
breakpoint. The \fIStack-Window\fP displays the program stack.
Help is available for Xwpe and the man-pages installed on
the system may be displayed. All this can be reached via the
\fIhelp-functions\fP.
The \fIeditor\fP may be used to edit up to 35 files at the same time.
They are all displayed in a window of their own. A \fImouse\fP is
used to select special editor functions from the top menu.
These functions can also be selected by hitting a \fIspecial key\fP
or combinations of keys. Some of these features are a
complete search and replace function (yes, it can search for
regular expressions) and a \fIfile-manager\fP. The file-manager
is used to open, copy, rename and move or delete files.
The X-window programming environment can be used without the
special programming features. If it is invoked as `\fBxwe\fP'
(`\fBwe\fP' if used with a character terminal) it can be used as a
editor e.g. for shell-programming.
.SH OPTIONS
.IP "\fB-mb\fP"
The next file has to be treated as a binary file.
.IP "\fB-mn\fP"
The next file is an ASCII-file (default).
.IP "\fB-nc \fInumber\fP"
An integer specifying the maximum number of columns that
will be used.
.IP "\fB-nm \fInumber\fP"
The number of steps before an auto-save will be done.
.IP "\fB-nu \fInumber\fP"
This option specifies the maximum number of steps to save for
undo.
.IP "\fB-pm\fP"
The next file is a message-file.
.IP "\fB-r\fP"
Start \fBxwpe\fP in the \fIrecover mode\fP. The internal buffers
are saved in files with the postfix `.ESV' in the name
if a signal is caught by \fBxwpe\fP (except for SIGKILL).
If the editor is invoked with the `-r' option is
specified in the command line, the old session will be
recovered.
.IP "\fB-sf \fIfile\fP"
\fIfile\fP will be used instead of the personal option file,
\fI$HOME/.xwpe/xwperc\fP.
.IP "\fB-so\fP"
The default options are used. The option file will not be read.
.PP
The following standard X command line options are available
for the X-Window versions.
.IP "\fB-display \fIdisplay\fP"
This option specifies the X server to contact; see \fIX(1)\fP.
.IP "\fB-font \fIfont, \fB-fn \fIfont\fP"
The font to used for the text can be specified with this option.
The default is \fI8x13\fP.
.IP "\fB-geometry \fIgeometry, \fB-g \fIgeometry\fP"
This option specifies the peferred size and and position of the
editor; see \fIX(1)\fP.
.IP "\fB-iconic\fP"
This indicates that \fBxwpe\fP should ask the window manager to
start as icon rather than a normal window.
.PP
The purpose of the following options are unknown at the present
time, any explanation would be appreciated (see MAINTAINER for contact
information).
.IP "\fB-pe\fP"
.IP "\fB-pt\fP"
.IP "\fB-um\fP"
.IP "\fB-vttoat\fP"
.SH KEYBOARD BINDINGS
\fBOld-Style: (Default) See Menu "Options--> Editor"\fP
.IP \fIEsc+<Menu-Letter><Item-Letter>\fP
Brings down the selected Menu and executes the
selected menu Item.
.IP \fIF1\fP
Starts the "Help" window.
.IP \fIF2\fP
Saves the current file.
.IP \fIF3\fP
Executes the "FileManager" popup Menu.
.IP \fIAlt-F3\fP
Closes current window.
.IP \fIF4\fP
Executes the "Search" popup Menu.
.IP \fI^-L\fP
Search again. "^" is usually the CTRL key.
.IP \fIALT-X\fP
Quit Xwpe.
.PP
\fBCua-Style: See Menu "Options--> Editor"\fP
.IP \fIEsc+<Menu-Letter><Item-Letter>\fP
Brings down the selected Menu and executes the
selected menu Item.
.IP \fIF1\fP
Starts the "Help" window.
.IP \fIALT-F2\fP
Saves the current file.
.IP \fIF2\fP
Executes the "FileManager" popup Menu.
.IP \fI^-F4\fP
Closes current window. "^" is usually the CTRL key.
.IP \fIALT-F3\fP
Executes the "Search" popup Menu.
.IP \fIF3\fP
Search again.
.IP \fIAlt-F4\fP
Quit Xwpe.
.PP
.SH INVOCATION
On startup (subject to the \fB-sf\fP and \fB-so\fP options),
Xwpe reads the personal initialization file \fI$HOME/.xwpe/xwperc\fP.
If no such file exists, the system wide initialization file,
\fI/usr/local/lib/xwpe/xwperc\fP, is read. If neither file
exists, the default options will be used.
\fIxwperc\fP is a binary file written by the programming
environment.
.SH RESOURCES
The following resources are available. The application name is
either "\fBxwe\fP" or "\fBxwpe\fP". Both belong to the "Xwpe" class.
.IP "\fBfont (\fPclass \fBFont)\fP"
Specifies the name of the font to use. The default is ``8x13.''
.IP "\fBgeometry (\fPclass \fBGeometry)\fP"
Specifies the preferred size and position of the editor. Sizes of
less than 80 x 25 are ignored.
.IP "\fBcolor1 (\fPclass \fBColor1)\fP"
.IP "\fB...\fP"
.IP "\fBcolor16 (\fPclass \fBColor16)\fP"
\fBxwpe\fP uses 16 colors. The default setting is similar to the
PC-color set.
.SH SYNTAX-SUPPORT:
Xwpe supports the syntax of a language by using different
colors to display \fIkeywords\fP, \fIconstants\fP, \fIpreprocessor\fP,
\fIcomments\fP, \fIoperators\fP and everything else.
This support is defined already for the programming
languages C, C++, and FORTRAN. More languages can be
added to the user's syntax definition file, \fI$HOME/.xwpe/syntax_def\fP.
The syntax of any predefined language can also be overridden.
If no personal syntax definition file exists, the system
definition file, \fI/usr/local/lib/xwpe/syntax_def\fP, will be
used.
Each syntax highlighting is distinguished by the file extension.
The \fIsyntax_def\fP uses the following format for language
definition.
.\" Everything after this point needs fixing.
.EX
"string: The postfix for the filename."
"integer: The number of keywords."
"strings: The keywords."
"integer: Number of operators with more than one
character length."
"strings: Operators with more than one character
length."
"string: Operators containing one character."
"string: Beginning of comment"
"string: End of comment"
"string: Beginning of comment reaching until the end
of the line."
"string: Characters used for comments depending on the
column."
"string: Special single characters."
"integer: Column for comments (-1 for none)."
"integer: Column for continuing line (-1 for none)"
"Integer: Column for comment till the end of line (-1
for none)"
.EE
Strings and integers are separated by blanks or carriage returns. The
strings used for single character operators and for column
depending comments must not contain blanks. All strings used
for comments can contain NULL to indicate that there is no
such comment. An integer can be zero if there is no keyword
or multiple character operators. The string for special
single characters contains the following fields:
.EX
Character for string-constants
Character for character-constants
Character for preprocessor-commands
Character for quoting the next character
Character for next line is continuing line
(if it is the last character in the line)
Character (if not empty: the language is not
case sensitive)
.EE
If one character is not defined (e.g. missing) a blank is
inserted at the corresponding position.
An example:
.EX
.c
32
auto break case char const continue default do
double else enum extern float for goto if int
long register return short signed sizeof static
struct switch typedef union unsigned void volatile
while
0
~^()[]{}<>+-/*%=|&!.?:,; /* */ NULL NULL "'#\\ -1 -1 1000
.f
64
ACCESS ASSIGN BACKSPACE BLANK BLOCKDATA CALL CHARACTER
CLOSE COMMON COMPLEX CONTINUE DATA DIMENSION DIRECT DO
DOUBLE PRECISION ELSE END ENDFILE ENTRY EQUIVALENCE ERR
EXIST EXTERNAL FILE FMT FORM FORMAT FORMATTED FUNCTION
GOTO IF IMPLICIT INQUIRE INTEGER INTRINSIC IOSTAT
LOGICAL NAME NAMED NEXTREC NUMBER OPEN OPENED
PARAMETER PAUSE PRINT PROGRAM READ REAL REC RECL
RETURN REWIND SAVE SEQUENTIAL STATUS STOP SUBROUTINE
TO UNFORMATED UNIT WRITE
13
.AND. .EQ. .EQV. .FALSE. .GE. .GT. .LE. .LT. .NE.
.NEQV. .NOT. .OR. .TRUE.
()+-/*=$.:, NULL NULL ! C* ' 1 0 5 72
.EE
.SH COPYRIGHTS
.SH Copyright (C) 1993 Fred Kruse
Xwpe is free. Anyone may redistribute copies of Xwpe to
anyone under the terms stated in the
\fIGNU General Public License\fP. The author assumes no
responsibility for errors or omissions or damages resulting
from the use of Xwpe or this manual.
.SH MAINTAINER
Send questions or problems to Dennis Payne, payned@rpi.edu.
.SH BUGS
Debugging leaks memory. The exact cause is still unknown.
Relative paths to files loaded from the command line are not
treated properly. Instead of updating when changing directories,
they remain constant. This means the file will be saved to a
location relative to the current directory.
Erasing the executable name for a project is supposed to default
to a.out but doesn't.
Unsure if the column for continuing previous line is working.
Information on how to test this and what the result should be
would be greatly appreciated.
Documentation hasn't been updated.
Compilers are assumed to have a -c and -o option. This causes problems
for those who wish to use java, perl, or other languages.
Autoindent option is not currently saved with save options.
Autosave creates a backup file as well.
\fBmake install\fP installs x versions even if not compiled in.
Adding items when no project is open has odd behavior.
Changing the maximum column and using cut & paste can crash \fBxwpe\fP.
Autosave and emergency save will overwrite files on file systems without
long file names.