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  version but without the special features of the programming
       interface. In connection	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-
       systems.	It is similar to the 'Borland C++ or  Turbo  Pascal'  environ-
       ments.  The  differences	between	the programming	environments from Bor-
       land 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  pro-
       gram  can be started from within	the Programming-Environment and	errors
       may be found using a debugger.  The  debugging-environment  allows  the
       user to set and unset breakpoints directly in the source	code. The con-
       tents of	variables may be displayed in a	special	window,	the Watch-Win-
       dow. This window	is updated while reaching a breakpoint.	The Stack-Win-
       dow 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
       programming 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-program-
       ming.

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 recovered.

       -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-
       Window 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
	      editor; see X(1).

       -iconic
	      This  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  per-
       sonal  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	 definition   file,   /usr/lo-
       cal/lib/xwpe/syntax_def,	will be	used.

       Each  syntax  highlighting is distinguished by the file extension.  The
       syntax_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
       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:
       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 Pub-
       lic  License.  The author assumes no responsibility for errors or omis-
       sions or	damages	resulting from the use of xwpe or this manual.

MAINTAINER
       Send  questions	or  problems  to  Dennis  Payne,  dulsi@identicalsoft-
       ware.com.

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

       Unsure if the column for	continuing previous line is working.  Informa-
       tion 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.

       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" protec-
       tion.

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=we&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help