head	2.2;
access;
symbols
	Rel2_1:2.1
	Rel2_0:2.0
	Xo52:1.8
	Xo51:1.6;
locks; strict;
comment	@# @;


2.2
date	92.12.23.15.39.15;	author ware;	state Exp;
branches;
next	2.1;

2.1
date	92.08.11.00.33.54;	author pete;	state Exp;
branches;
next	2.0;

2.0
date	92.04.23.02.46.34;	author ware;	state Exp;
branches;
next	1.8;

1.8
date	92.03.04.03.44.19;	author ware;	state Exp;
branches;
next	1.7;

1.7
date	92.03.04.03.39.58;	author ware;	state Exp;
branches;
next	1.6;

1.6
date	92.03.03.17.15.41;	author ware;	state Exp;
branches;
next	1.5;

1.5
date	92.02.17.17.57.38;	author ware;	state Exp;
branches;
next	1.4;

1.4
date	92.02.04.21.17.06;	author pete;	state Exp;
branches;
next	1.3;

1.3
date	91.09.04.19.33.39;	author pete;	state Exp;
branches;
next	1.2;

1.2
date	91.09.03.10.59.48;	author pete;	state Exp;
branches;
next	1.1;

1.1
date	91.08.26.10.49.50;	author pete;	state Exp;
branches;
next	;


desc
@Part of the Xo widget set.
@


2.2
log
@Added macros to support using lex and yacc to Xo.tmpl.  Integrated new
scheme with XoUnitStd.h and Xo.tmpl.  Updated README.  Added Xpm3.2a
to the distribution.
@
text
@				  Xo
			 The Open Widget Set
			     Release 2.1
			     10 Aug 1992
			      Pete Ware
	   $Id: README,v 2.1 1992/08/11 00:33:54 pete Exp $

Introduction.

   Xo is a widget set with functionality similar to that of Motif but
   with a cleaner design.  It interacts well with other widget sets
   and, more importantly, it is easy for others to write widgets to extend
   the base widget set.  Documentation is quite extensive and
   accurate.  Walking (hierarchical) and pulldown menus are provided.
   Keyboard traversals (using the keyboard instead of the mouse) and
   hardcopy output (at least postscript) are planned.  In particular,
   all the header files are programmatically generated.

   The latest version can be found in archive.cis.ohio-state.edu:pub/Xo/*
   Contact ware@@cis.ohio-state.edu for more information.

   Current widgets implemented are:
   Box		A manager widget that places widgets in a rectangular
		arrangment with identical sizes.
   Button	A widget that allows the user to ``press'' a button to
		cause something to happen.
   Column	Arranges children in a column
   CompBase	Provides common functionality for composite widgets.
   ConsBase	Provides common functionality for constraint widgets.
   Grip		A widget for allowing user to change widget dimensions
   Label	A widget that displays either text or a pixmap.
   Menu		A manager widget for holding the widgets in a menu.
   MenuBar	A manager widget for holding pulldown menus.
   MenuBarButton For pulldown menus inside a MenuBar.
   MenuButton	A widget that is placed inside of a menu.  Allows the
		display of either text or a pixmap.  Submenus can be
		attached to a menubutton.
   MenuShell	An override shell that allows multiple children
		(speeds up submenus signicantly).
   Obj2dBorder	Draws a simple line for border edge.
   Obj3dborder	Draws a beveled edge for a border.
   ObjArrow	An arrow that can point left, right, up or down.
   ObjBorder	Defines the basic behavior of borders.
   ObjDraw	Provides common function for gadgets.
   ObjLabel	A gadget that displays lines of text
   ObjLabelFormat
   		A gadget that allows for embedded control strings to
		signify formatting.
   ObjPixmap	A gadget that displays a pixmap (not yet implemented).
   Row		Arranges children in a row
   Scrollbar	Allows user to interactively change viewing area (incomplete).
   Seperator	A gadget that draws a chiseled edge.  Typically used in a
		\class{Label} widget to distuinguish between sections in
		a menu (soon implemented, not yet).
   Simple	A widget that provided common functionality for many of
		the widgets.  Never directly used.
   Vpane	Arranges widgets in a column and allows the user to
		interactively change the height.

Contents.

   ./X11	- For widget set include files
   ./X11/Xo	- The Xo include files.  MOST ARE AUTOMATICALLY GENERATED.
   ./build	- A program that actually generates the Xo include
		  files and documentation
   ./doc	- The LaTeX documentation for the system.
   ./examples	- Various example programs
   ./examples/xfontsel - Port of the xfontsel program to this widget set
   ./libtable	- A library that implements a generic insert/find/destroy
		  utility (currently only fixed size hashing).
   ./spec	- The description of the widget set that ``build'' uses to
		  generate the include files and documentation
   ./src	- The source for the Xo widgets
   ./test	- Test programs

Portability.

   This code is regularly compiled and run under:
        ______________________________________________________________________
        Machine	OS	       			Compiler		X11
        ______________________________________________________________________
   	Sun 3	SunOS 4.1      			gcc -Wall		R4,R5
	Sun 4	SunOS 4.1			gcc -Wall		R4,R5
	Sun 4	SunOS 4.1			cc			R4,R5
        ______________________________________________________________________


   This code has compiled and run under:
        ______________________________________________________________________
        Machine	OS	       			Compiler		X11
        ______________________________________________________________________
	Sun 4	Solaris 2.0			cc			R5
	SGI	IRIX 4.0, IRIX 3.3		cc			R4
	E&S	ES/os 2.0			cc -systype bsd43	R4
        ______________________________________________________________________

Installation.

   1. Examine ./Xo.tmpl.  It has an option for compiling with
      gcc.  If you have TeX/LaTex installed, you may also want to
      define HasTeX here so doc/Makefile gets generated correctly

      The most likely area of trouble is in X11/Xo/XoUnistd.h.  It is
      so difficult to get source to compile under various OS's and
      ANSI and non-ANSI compilers that this will almost always need
      some editing (unless you happen to be on a machine I use a lot).

   2. "xmkmf" to generate ./Makefile
   3. "make Makefiles" (to generate all the subdirectories' Makefiles)
   4. "make"
   5. "make depend" (if you like)

   Note that the "build" program must exist so the include files
   in X11/Xo can get generated from the specification in ./spec.  This
   also generated most of the LaTeX documents in ./doc.

Testing.

   Only one test program exists in ./src/test.

   A port of xfontsel to use pulldown menus is in ./examples/xfontsel.
@


2.1
log
@Working on introduction.
@
text
@d6 1
a6 1
	   $Id: README,v 2.0 1992/04/23 02:46:34 ware Exp $
d92 3
a94 3
	Sun 4	Solarix 2.0			cc			R5
	SGI	IRIX 4.0, IRIX 3.3		cc
	E&S	ESV2.0				cc -systype bsd43
d102 6
a121 1
   This is currently broken.
@


2.0
log
@First public release.
@
text
@d3 2
a4 2
			      Release 51
			     3 March 1992
d6 1
a6 1
	   $Id: README,v 1.8 1992/03/04 03:44:19 ware Exp $
d11 1
a11 1
   with a cleaner design.  It interacts well with other widget sets.
d16 2
a17 1
   hardcopy output (at least postscript) are planned.
d19 3
d42 1
d45 5
a49 4
   ObjPixmap	A gadget that displays a pixmap (not yet implemented, soon)
   ObjText	A gadget that displays lines of text\footnote{Should
		probably call this something else since Text seems to
		imply much more}.
d63 1
a63 1
   ./X11/Xo	- The Xo include files
d78 16
a93 5
   This code is daily compiled and run on:
        Machine	OS	       			Compiler
        -------	--				--------
   	Sun 3	SunOS 4.1      			gcc -Wall
	SGI	IRIX 4.0alpha, IRIX 3.3		cc
d95 1
d97 1
a97 1
Compiling.
d115 2
a116 2
   A port of xfontsel to use pulldown menus is in ./examples/xfontsel

@


1.8
log
@Testing, mostly
@
text
@d6 1
a6 1
	   $Id: README,v 1.7 1992/03/04 03:39:58 ware Exp $
@


1.7
log
@*** empty log message ***
@
text
@d6 1
a6 1
	$Id:$
@


1.6
log
@Adding scrollbar.
@
text
@d6 1
@


1.5
log
@*** empty log message ***
@
text
@d3 2
a4 2
			      Release 49
			     17 Feb 1992
d25 1
d35 4
a38 2
   ObjBorder	A gadget to draw borders that give a raised or
		indented appearance.
d44 1
d50 2
@


1.4
log
@Many Changes
@
text
@d3 2
a4 2
			      Release 42
			     09 Jan 1992
d11 1
a11 1
   More importantly, it is easy for others to write widgets to extend
@


1.3
log
@Updated to reflect current chagnes.
@
text
@d3 2
a4 2
			      Release 41
			     03 Sept 1991
d10 6
a15 6
   avoiding the many design errors of Motif.  It should interact with
   other well behaved widget sets.  More importantly, it is easy for
   others to write widgets to extend the base widget set.
   Documentation is quite extensive and accurate.  Walking
   (hierarchical) and pulldown menus are provided.  Keyboard
   traversals and hardcopy output (at least postscript) are planned.
d23 2
d33 1
a33 1
		(speeds up submenus signicantly)
d35 1
a35 1
		indented appearance
@


1.2
log
@Added new Row/Column widgets.
@
text
@d19 1
a19 1
		arrangment.
d73 2
a74 1
      gcc.
d79 4
@


1.1
log
@Initial revision
@
text
@d3 2
a4 2
			      Release 40
			    23 Aug 1991
d22 1
d38 1
@
