ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/xcb/README
Revision: 1.1
Committed: Thu Oct 10 10:07:02 2002 UTC (21 years, 7 months ago) by root
Branch: MAIN
CVS Tags: HEAD
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.1
2     What is xcb?
3     ============
4     Do you ever wish you could cut two or more separate pieces of text
5     at once from a window? Do you ever need to save the output from one
6     command for reuse in several subsequent tasks? Do you ever find
7     yourself wanting some easy means of globally exporting data, e.g.
8     to a parent shell, to another xterm or application, or to another
9     machine or user? If you answer yes to any of these questions, then
10     xcb is for you.
11    
12     Xcb provides access to the cut buffers built into every X server.
13     It allows the buffers to be manipulated either via the command line,
14     or with the mouse in a point and click manner. The buffers can be
15     used as holding pens to store and retrieve arbitrary data fragments,
16     so any number of different pieces of data can be saved and recalled later.
17     The program is designed primarily for use with textual data.
18    
19    
20     What is so good about this release?
21     ===================================
22     Release 2.3i add I18n and Unicode support to the base xcb. It also
23     supports more formats, so applications requiring compound text
24     for example work. You cna also paste utf-8 and japanese text...
25    
26     Release 2.3 fixes a bug found in the XView code that prevented data
27     from being pasted from xcb to XView applications such as cmdtool.
28    
29     The release also adds a Motif GUI, selectable as a compile-time option.
30     Now you can choose between the Athena or the Motif look and feel.
31    
32    
33     Yes, but has it been ported to WHIZ-IX 12.1A.00x, on SRS-80 27-bit CPUs?
34     ========================================================================
35     Xcb has been ported to a wide variety of sites and systems.
36     In no particular order, the machines and operating systems known
37     to be running xcb include:-
38    
39     o OSx (5.1a) - Pyramid MIS-2/02
40     o DC/OSx (1.0) - Pyramid MIServer-S 1/32 r3000
41     o AT&T SYSV (SVR3.2, SVR4) - i386, DG Aviion 5200
42     o HP-UX (lots of versions) - HP 9000s
43     o SunOS (4.1) - Sun3, Sun4, Solbourne Series5, SPARCstations
44     o SPARC/OS (1.1)
45     o Solaris (2.1) - SPARCstations
46     o Irix (4.0, 5.2) - SGI
47     o ULTRIX (4.2) - DECstations
48     o UNICOS (6.1) - Cray Y-MP
49     o ConvexOS (10.0.2) - Convex 3100
50     o DYNIX (V3.0.17.10) - Sequent Symmetry S81
51     o AIX (3.2) - RS6000
52     o RISC/os (4.52) - MIPS
53     o Domain/OS (10.4) - Apollo DN3000, 3500, 4500, 5500
54     o Linux (lots of versions) - i486
55     o VMS (5.5)
56     o DGUX (5.4.2) - AViiON mc88100
57     o Dynix/ptx (1.3) - i386
58    
59    
60     Xcb has been written to compile using both ANSI and non-ANSI compilers.
61     It is in use in X11 R3, R4, R5 and R6 environments. The current version
62     uses either the Athena widgets (libXaw.a) or the Motif widgets (libXm.a),
63     plus the X Toolkit library (libXt.a).
64    
65    
66     Ok, where is it available?
67     ==========================
68    
69     This version is a branch of the original xcb sources. It's homepage can be
70     found at http://xcb.plan9.de/
71    
72    
73     So, it will compile, will it?
74     =============================
75     Yes! The makefiles will, by default, build the Athena widgets version
76     of xcb. If you prefer Motif, you should adjust the $(GUI) definition
77     to be -DMOTIF. In addition, if you wish to cut and paste text between
78     xcb and XView applications, you should also add the -DXVIEW flag.
79    
80     AT&T SVR4 sites need libnsl.a during linking. If you are using
81     SVR4, and you don't like Imakefiles, you will need to add -lnsl to the
82     LIBS in Makefile.std.
83    
84     HP-UX users may find that the Athena widgets are not installed on their
85     machine, even though the components are freely available as part of the
86     MIT X11 distribution. There is an HP maintained, but unsupported, set
87     of X11R4 libraries and utilities (including the Athena widgets) for the
88     HP 9000 Series 300, 400, 700, and 800. You can get the libraries,
89     include files, and config files (imake) via anonymous FTP from
90     hpcvaaz.cv.hp.com (15.255.72.15) - look for pub/MitX11R4/libs.s*00.tar.Z
91    
92     AIX 3.2 users may find their Athena components are installed in a
93     non-standard place. Check the directory /usr/lpp/X11/Xamples/lib/Xaw.
94    
95     VMS and ULTRIX users may find their Athena components are installed in
96     a non-standard place too. Check the directory /usr/include/mit for the
97     Athena include files.
98    
99    
100     And how do I set the thing up?
101     ==============================
102     That is pretty easy too. Once you have compiled the program,
103     you can start using it straight away - just put it in your favourite
104     bin directory. The program contains a minimal set of fallback resources
105     so that it will behave itself even if there are no X resource specifications
106     for it to feed on. To install the program, plus its application defaults
107     file, and the man page, simply type 'make install install.man', after
108     checking the target directories for the install in the Imakefile/Makefile.std.
109    
110    
111     Who is to blame? Where do I send complaints?
112     =============================================
113     Blame me. If you have any bug reports, porting problems, comments,
114     more comments, suggestions, patches, unwanted cash etc. please tell me.
115     I can be reached at the email address below.
116    
117     Marc Lehmann <pcg@goof.com>
118    
119     Feb 2001 ;)
120    
121    
122     I couldn't reach the original author, who wrote most of xcb, but your
123     mileage may vary. Xcb was originally brought to you by:
124    
125     Better still, if you really like xcb, send me a postcard!
126     (to P.O. Box 213, Belgrave, Victoria, Australia. 3160).
127    
128     Enjoy.
129     Farrell McKay (Farrell.McKay@mpx.com.au)
130     Nov 1994
131    
132