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  ev-
       erything	 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | INVOCATION | RESOURCES | SYNTAX-SUPPORT: | COPYRIGHTS | MAINTAINER | BUGS

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

home | help