Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xwpe(alpha)							     xwpe(alpha)

NAME
     xwpe, xwe, wpe, we - X-Window Programming Environment

SYNOPSIS
     xwpe [ options ] file ...
      xwe [ options ] file ...
      wpe [ options ] file ...
       we [ options ] file ...

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.  xwpe fires up
     the X interface together with the programming interface. xwe is the X  ver-
     sion but without the special features of the programming interface. In con-
     nection  with a simple character terminal you can use wpe to program and we
     as editor.

     Xwpe is a X-window programming environment designed for  use  on  UNIX-sys-
     tems.  It is similar to the 'Borland C++ or Turbo Pascal' environments. The
     differences between the programming environments from Borland and	xwpe  is
     that many compilers, linkers, and debuggers can be used in xwpe.  Menus and
     commands are accessible 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  project-file).   The	program  can  be
     started from within the Programming-Environment and errors may be found us-
     ing  a debugger. The debugging-environment 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 Watch-Window. This window is updated
     while reaching a breakpoint. The Stack-Window 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 help-functions.

     The editor may be used to edit up to 35 files at the same time.   They  are
     all  displayed  in a window of their own. A mouse is used to select special
     editor functions from the top menu.  These functions can also  be	selected
     by  hitting  a  special key or combinations of keys. Some of these features
     are a complete search and replace function (yes, it can search for  regular
     expressions)  and	a  file-manager. 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  pro-
     gramming features. If it is invoked as `xwe' (`we' if used with a character
     terminal) it can be used as an editor e.g. for shell-programming.

OPTIONS
     -pm    The next file is a message-file.

     -r     Start  xwpe  in  the recover mode. The internal buffers are saved in
	    files with the postfix `.ESV' in the name if a signal is  caught  by
	    xwpe  (except  for SIGKILL).  If the editor is invoked with the `-r'
	    option is specified in the command line, the old session will be re-
	    covered.

     -sf file
	    file  will	be  used  instead   of	 the   personal   option   file,
	    $HOME/.xwpe/xwperc.

     -so    The default options are used. The option file will not be read.

     The  following standard X command line options are available for the X-Win-
     dow versions.

     -display display
	    This option specifies the X server to contact; see X(1).

     -font font, -fn font
	    The font to used for the text can be  specified  with  this  option.
	    The default is 8x13.

     -geometry geometry, -g geometry
	    This option specifies the preferred size and and position of the ed-
	    itor; see X(1).

     -iconicThis  indicates  that xwpe should ask the window manager to start as
	    icon rather than a normal window.

     -pcmap This starts xwpe with a private colormap.

INVOCATION
     On startup (subject to the -sf and -so options), xwpe  reads  the	personal
     initialization file $HOME/.xwpe/xwperc.  If no such file exists, the system
     wide  initialization file, /usr/local/lib/xwpe/xwperc, is read.  If neither
     file exists, the default options will be used.

     xwperc is a text file written by  the  programming  environment.	Although
     modification by hand is possible comments will be erased if the options are
     latter saved from within xwpe.

RESOURCES
     The following resources are available. The application name is either "xwe"
     or "xwpe".  Both belong to the "Xwpe" class.

     font (class Font)
	    Specifies the name of the font to use.  The default is ``8x13.''

     geometry (class Geometry)
	    Specifies  the  preferred size and position of the editor.	Sizes of
	    less than 80 x 25 are ignored.

     color1 (class Color1)

     ...

     color16 (class Color16)
	    xwpe uses 16 colors. The default setting is similar to the	PC-color
	    set.

SYNTAX-SUPPORT:
     Xwpe supports the syntax of a language by using different colors to display
     keywords, constants, preprocessor, comments, operators 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,
     $HOME/.xwpe/syntax_def.   The syntax of any predefined language can also be
     overridden.  If no personal syntax definition file exists, the system defi-
     nition file, /usr/local/lib/xwpe/syntax_def, will be used.

     Each syntax highlighting is distinguished by the file extension.  The  syn-
     tax_def uses the following format for language definition.
     "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 (1000
	       for none)"
     Strings  and  integers  are  separated  by  blanks or carriage returns. The
     strings used for single character operators and for column  depending  com-
     ments  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 spe-
     cial single characters contains the following fields:
     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)
     If one character is not defined (e.g. missing) a blank is inserted  at  the
     corresponding position.

     An example:

      .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

COPYRIGHTS
     Copyright (C) 1993 Fred Kruse Xwpe is free.  Anyone may redistribute copies
     of xwpe to anyone under the terms stated in the GNU General Public License.
     The author assumes no responsibility for errors or omissions or damages re-
     sulting from the use of xwpe or this manual.

MAINTAINER
     Send questions or problems to Dennis Payne, dulsi@identicalsoftware.com.

BUGS
     Debugging leaks memory.  The exact cause is still unknown.

     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 appreci-
     ated.

     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.

     make install 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 xwpe.

     Clicking "edit" in the project menu when not on a file it loads a file with
     a name of " ".

     Esc key requires 3 presses to do the regular escape  function  under  Linux
     console (and perhaps other terminal types).

     No error for disk full.

     Check headers doesn't correctly handle comments and "ifndef" protection.

3rd Berkeley Distribution	   May 3, 1999			     xwpe(alpha)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xwpe&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help