summaryrefslogtreecommitdiff
path: root/xc/RELNOTES.TXT
blob: 669bd766c23458e0d7743b162da6d9b98d5c6b04 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
                   X Window System, Version 11, Release 6

                               Release Notes

                               Stephen Gildea

                                X Consortium

                                May 16, 1994

Copyright (C) 1994 X Consortium

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNEC-
TION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the X Consortium shall not
be used in advertising or otherwise to promote the sale, use or other deal-
ings in this Software without prior written authorization from the X Consor-
tium.

X Window System is a trademark of X Consortium, Inc.

1.  Easy Build Instructions

This quick summary is no substitute for reading the full build instructions
later in this document.

Edit xc/config/cf/site.def for local preferences.  If you want to build with
gcc uncomment the HasGcc2 line.  If you want to install somewhere other than
/usr/X11R6, change ProjectRoot.  (Do not use DESTDIR.)

If any fixes have been released by the X Consortium, stop here and follow
the instructions at the top of each patch, but don't do any of the make com-
mands suggested in the patches.  Then continue here.

Check the appropriate xc/config/cf/vendor.cf file to make sure that OSMa-
jorVersion and OSMinorVersion are set correctly for your system (change them
if necessary).

See if there is a BootstrapCFlags mentioned in the comments in the vendor.cf
file.  If there isn't one, cd to the xc directory and type:

     make World >& world.log

If there is a BootstrapCFlags, take its value and type:

     make World BOOTSTRAPCFLAGS="value" >& world.log

Do not call the output file "make.log".  If the build is successful, you can
install most of it with:

     make install >& install.log

You can install manual pages with:

     make install.man >& man.log

While the system is building (or if things fail), read the rest of these
Release Notes.

2.  What Is Release 6

This is the 6th release of X Window System software from the X Consortium.
X is a network-transparent window system which runs on a wide range of com-
puting and graphics machines.

The X Consortium is an independent, not-for-profit corporation, the succes-
sor to the MIT X Consortium, which was part of the MIT Laboratory for Com-
puter Science.  See the XConsortium manual page for details.

2.1.  Overview of the X Consortium Release

There are two parts to Release 6: X Consortium software and documentation,
and user-contributed software and documentation.  The X Consortium part con-
tains the following:

X Consortium Standards
     The X Consortium produces standards:  documents which define network
     protocols, programming interfaces, and other aspects of the X environ-
     ment.  See the XStandards manual page for a list of standards.

Sample Implementations
     For most of our standards, we provide sample implementations to demon-
     strate proof of concept.  These are not reference implementations; the
     written specifications define the standards.

Fonts
     A collection of bitmap and outline fonts are included in the distribu-
     tion, contributed by various individuals and companies.

Utility Libraries
     A number of libraries, such as the Athena Widget Set, are included.
     These are not standards, but are used in building X Consortium applica-
     tions and may be useful in building other applications.

Sample Programs
     We also provide a number of application programs.  A few of these pro-
     grams, such as xdm, should be considered essential in almost all envi-
     ronments.  The rest of the applications carry no special status; they
     are simply programs that have been developed and/or maintained by X
     Consortium staff.  In some cases, you will find better substitutes for
     these programs in the user-contributed part.

The user-contributed part contains whatever people contribute.  You'll find
a variety of software and documentation here: programs, demos, games,
libraries, X server extensions, etc.

2.2.  Supported Systems

We built and tested this release on the following systems:

     A/UX 3.0.1
     AIX 3.2.5
     BSD/386 1.0
     HP-UX 9.1
     IRIX 5.2
     Mach 2.5 Vers 2.00.1
     Microsoft Windows NT 3.1
     NCR Unix System V Release 4/MP-RAS
     NEWS-OS 6.0
     OSF/1 1.3
     OSF/1 1.0
     SunOS 4.1.3
     SunOS 5.3
     UNICOS 8.0
     UNIX System V/386 Release 4.2 Version 1
     Unix System V/860 Release 4.0 Version 3
     Ultrix-32 4.3

On NT, most of the release builds with the Microsoft SDK.  Missing are
Fresco, twm, xterm, xdm, xconsole, xinit, xhost, xsm, and the X server.  Xt,
Xaw, and Xmu libraries are not built as DLLs.  Imake works, albeit with some
restrictions.

2.3.  The XC Tree

The first thing you may notice is that you can't find anything.  The source
tree has undergone a major reorganization since R5.  The top-level directory
has been renamed from mit/ to xc/.

The general layout under xc/ is now as follows:

config/             config files, imake, makedepend, build utilities
doc/                all documentation other than per-program manual pages
fonts/              BDF, Speedo, Type1 fonts
include/            include files shared by multiple directories
lib/                all libraries
nls/                localization files
programs/           all programs, including the X server and rgb
test/               X Test Suite and other test suites
util/               patch, compress, other utilities
workInProgress/     snapshots of work in progress
bug-report          bug reporting template
registry            X Registry

2.3.1.  config/

The xc/config directory now has subdirectories:

config/cf/          all the config files: Imake.tmpl, Project.tmpl, etc.
config/imake/       the imake program
config/makedepend/  the makedepend program
config/util/        other configuration utility programs and scripts

2.3.2.  lib/

Xlib sources are in xc/lib/X11; we've renamed directories to match the lib-
name.a names.

2.3.3.  doc/

doc/specs/          X Consortium standards and other specifications
doc/man/            manual pages for libraries and general manual pages
doc/util/           macro packages and utilities for formatting
doc/hardcopy/       PostScript versions of the documentation

The xc/doc/hardcopy directory contains compressed, pre-formatted PostScript
versions of documentation elsewhere in the doc tree and the program manual
pages, which are in each program's source directory.  These files can be
uncompressed with the compress program, which is included in
xc/util/compress.

2.3.4.  extensions

There is no longer a top-level extensions directory.  Extension libraries
are now under xc/lib/, server extension code is under
xc/programs/Xserver/Xext/, and extension header files are under
xc/include/extensions/.

2.4.  Extensions supported

The core distribution includes the following extensions: BIG-REQUESTS, LBX,
MIT-SHM, MIT-SUNDRY-NONSTANDARD, Multi-Buffering, RECORD, SHAPE, SYNC, X3D-
PEX, XC-MISC, XIE, XInputExtension, XKEYBOARD, XTEST, and XTestExtension1.

2.5.  Implementation Parameters

Some of the specifications define some behavior as implementation-dependent.
Implementations of X Consortium standards need to document how those parame-
ters are implemented; this section does so.

XFILESEARCHPATH default
     This default can be set at build time by setting the imake variables
     XFileSearchPathDefault, XAppLoadDir, XFileSearchPathBase, and Project-
     Root in site.def.  See xc/config/cf/Project.tmpl for how they are used.

     By default, XFILESEARCHPATH has these components:

          /usr/X11R6/lib/X11/%L/%T/%N%C%S
          /usr/X11R6/lib/X11/%l/%T/%N%C%S
          /usr/X11R6/lib/X11/%T/%N%C%S
          /usr/X11R6/lib/X11/%L/%T/%N%S
          /usr/X11R6/lib/X11/%l/%T/%N%S
          /usr/X11R6/lib/X11/%T/%N%S

XUSERFILESEARCHPATH default
     If the environment variable XAPPLRESDIR is defined, the default value
     of XUSERFILESEARCHPATH has the following components:

          $XAPPLRESDIR/%L/%N%C
          $XAPPLRESDIR/%l/%N%C
          $XAPPLRESDIR/%N%C
          $HOME/%N%C
          $XAPPLRESDIR/%L/%N
          $XAPPLRESDIR/%l/%N
          $XAPPLRESDIR/%N
          $HOME/%N

     Otherwise it has these components:

          $HOME/%L/%N%C
          $HOME/%l/%N%C
          $HOME/%N%C
          $HOME/%L/%N
          $HOME/%l/%N
          $HOME/%N

XKEYSYMDB default
     Defaults to /usr/X11R6/lib/X11/XKeysymDB, assuming ProjectRoot is set
     to /usr/X11R6.

XCMSDB default
     Defaults to /usr/X11R6/lib/X11/Xcms.txt, assuming ProjectRoot is set to
     /usr/X11R6.

XLOCALEDIR default
     Defaults to the directory /usr/X11R6/lib/X11/locale, assuming Project-
     Root is set to /usr/X11R6.

XErrorDB location
     The Xlib error database file is /usr/X11R6/lib/X11/XErrorDB, assuming
     ProjectRoot is set to /usr/X11R6.

XtErrorDB location
     The Xt error database file is /usr/X11R6/lib/X11/XtErrorDB, assuming
     ProjectRoot is set to /usr/X11R6.

Supported Locales
     For a list of locales supported, see the files locale.dir and
     locale.alias in the xc/nls/X11/locale/ directory.

Input Methods supported
     The core distribution does not include any input methods servers.  How-
     ever, in Latin-1 locales, a default method that supports European com-
     pose processing is enabled.  See xc/nls/X11/locale/Compose/iso8859-1
     for the supported compositions.  There are input method servers in con-
     trib.

3.  Building X

This section gives detailed instructions for building Release 6: getting it
off the distribution medium, configuring, compiling, installing, running,
and updating.

More recent information about newly-discovered problems may be found in the
Frequently Asked Questions posting appearing monthly on the comp.windows.x
newsgroup and xpert mailing list.  It is also available via anonymous FTP on
ftp.x.org in the file contrib/faqs/FAQ.Z, or on your local X mirror site.

3.1.  Unpacking the Distribution

The distribution normally comes as multiple tar files, either on tape or
across a network, or as a CD-ROM.

If you are unpacking tar files, you will need about 150 megabytes to hold
the xc/ part.

3.1.1.  Unpacking a Compressed FTP Distribution

If you have obtained compressed tar files over the network, create a direc-
tory to hold the sources and cd into it:

     mkdir sourcedir
     cd sourcedir

Then for each tar file xc-*.tar.Z, execute this:

     zcat ftp-dir/xc-N.tar.Z | tar xpf -

For each tar file contrib-*.tar.Z, execute this:

     zcat ftp-dir/contrib-N.tar.Z | tar xpf -

3.1.2.  Unpacking a gzipped FTP Distribution

If you have obtained gzipped tar files over the network, create a directory
to hold the sources and cd into it:

     mkdir sourcedir
     cd sourcedir

Then for each tar file xc-*.tar.gz, execute this:

     gunzip -c ftp-dir/xc-N.tar.gz | tar xpf -

For each tar file contrib-*.tar.gz, execute this:

     gunzip -c ftp-dir/contrib-N.tar.gz | tar xpf -

3.1.3.  Unpacking a Split Compressed FTP Distribution

If you have obtained compressed and split tar files over the network, create

a directory to hold the sources:

     mkdir sourcedir

Then for each directory xc-*:

     cd ftp-dir/xc-N
     cat xc-N.?? | uncompress | (cd sourcedir; tar xpf -)

For each directory contrib-*, execute this:

     cd ftp-dir/contrib-N
     cat contrib-N.?? | uncompress | (cd sourcedir; tar xpf -)

3.1.4.  Unpacking the Tape Distribution

If you have obtained a tape, create a directory to hold the sources and
untar everything into that directory:

     mkdir sourcedir
     cd sourcedir
     tar xpf tape-device

3.1.5.  Using the CD-ROM

If you have obtained a CD-ROM, you don't have to do anything to unpack it.
However, you will have to create a symbolic link tree to build X.  See the
next section.

3.2.  Apply Patches

If there are fixes released, apply them now.  Follow the instructions at the
top of each patch, but don't do any make commands.  Then continue here.

3.3.  Symbolic Link Trees

If you expect to build the distribution on more than one machine using a
shared source tree, or you are building from CD-ROM, or you just want to
keep the source tree pure, you may want to use the program
xc/config/util/lndir.c to create a symbolic link tree on each build machine.
The links may use an additional 10 megabytes, but it is cheaper than having
multiple copies of the source tree.

It may be tricky to compile lndir before the distribution is built.  If you
have a copy from Release 5, use that.  Makefile.ini can be used for building
lndir the first time.  You may have to specify OSFLAGS=-Dsomething to get it
to compile.  What you would pass as BOOTSTRAPCFLAGS might work.  The command
line looks something like this:

     make -f Makefile.ini OSFLAGS=-Dflag

To use a symbolic link tree, create a directory for the build, cd to it, and
type this:

     lndir sourcedir

where sourcedir is the pathname of the directory where you stored the
sources.  All of the build instructions given below should then be done in
the build directory on each machine, rather than in the source directory.

xc/config/util/mkshadow/ contains mkshadow, an alternative program to lndir.

3.4.  Configuration Parameters

Build information for each source directory is in files called Imakefile.
An Imakefile, along with local configuration information in xc/config/cf/,
is used by the program imake to generate a Makefile.

Most of the configuration work prior to building the release is to set
parameters so that imake will generate correct files.  Most of those parame-
ters are set in xc/config/cf/site.def.  You will also need to check the
appropriate xc/config/cf/vendor.cf file to make sure that OSMajorVersion,
OSMinorVersion, and OsTeenyVersion are set correctly for your system (change
them if necessary).

The site.def file has two parts, one protected with "#ifdef BeforeVendorCF"
and one with "#ifdef AfterVendorCF".  The file is actually processed twice,
once before the .cf file and once after.  About the only thing you need to
set in the "before" section is HasGcc2; just about everything else can be
set in the "after" section.

The sample site.def also has commented out support to include another file,
host.def.  This scheme may be useful if you want to set most parameters
site-wide, but some parameters vary from machine to machine.  If you use a
symbolic link tree, you can share site.def across all machines, and give
each machine its own copy of host.def.

The config parameters are listed in xc/config/cf/README, but here are some
of the more common parameters that you may wish to set in site.def.

ProjectRoot
     The destination where X will be installed.  This variable needs to be
     set before you build, as some programs that read files at run-time have

     the installation directory compiled in to them.  Assuming you have set
     the variable to some value /path, files will be installed into
     /path/bin, /path/include/X11, /path/lib, and /path/man.

HasGcc
     Set to YES to build with gcc version 1.

HasGcc2
     Set to YES to build with gcc version 2.  Both this option and HasGcc
     look for a compiler named gcc, but HasGcc2 will cause the build to use
     more features of gcc 2, such as the ability to compile shared
     libraries.

HasCplusplus
     Declares the system has a C++ compiler.  C++ is necessary to build
     Fresco.  On some systems, you may also have to set additional variables
     to say what C++ compiler you have.

DefaultUsrBin
     This is a directory where programs will be found even if PATH is not
     set in the environment.  It is independent of ProjectRoot and defaults
     to /usr/bin.  It is used, for example, when connecting from a remote
     system via rsh.  The rstart program installs its server in this direc-
     tory.

InstallServerSetUID
     Some systems require the X server to run as root to access the devices
     it needs.  If you are on such a system and will not be using xdm, you
     can set this variable to YES to install the X server setuid to root.
     Note that the X server has not been analyzed by the X Consortium for
     security in such an installation; talk to your system manager before
     setting this variable.

MotifBC
     Causes Xlib and Xt to work around some bugs in older versions of Motif.
     Set to YES only if you will be linking with Motif version 1.1.1, 1.1.2,
     or 1.1.3.

GetValuesBC
     Setting this variable to YES allows illegal XtGetValues requests with
     NULL ArgVal to usually succeed, as R5 did.  Some applications erro-
     neously rely on this behavior.  Support for this will be removed in a
     future release.

The following vendor.cf files are in the release but have not been tested
recently and hence probably need changes to work: DGUX.cf, Mips.cf,
apollo.cf, bsd.cf, convex.cf, moto.cf, pegasus.cf, x386.cf.  Amoeba.cf is
known to require additional patches.

The file xc/lib/Xdmcp/Wraphelp.c, for XDM-AUTHORIZATION-1, is not included
in this release.  The file is available within the US; for details get
/pub/R6/xdm-auth/README from ftp.x.org via anonymous FTP.

3.5.  System Notes

This section contains hints on building X with specific compilers and oper-
ating systems.

3.5.1.  gcc

gcc version 2 is in regular use at the X Consortium.  You should have no
problems using it to build.  Set the variable HasGcc2.  X will not compile
on some systems with gcc version 2.5, 2.5.1, or 2.5.2 because of an incor-
rect declaration of memmove() in a gcc include file.

3.5.2.  SparcWorks 2.0

If you have a non-threaded program and want to debug it with the old Sparc-
Works 2.0 dbx, you will need to use the thread stubs library in
xc/util/misc/thr_stubs.c.  Compile it as follows:

     cc -c thr_stubs.c
     ar cq libthr_stubs.a thr_stubs.o
     ranlib libthr_stubs.a

Install libthr_stubs.a in the same directory with your X libraries (e.g.,
/usr/X11R6/lib/libthr_stubs.a).  Add the following line to site.def:

     #define ExtraLibraries -lsocket -lnsl $(CDEBUGFLAGS:-g=-lthr_stubs)

This example uses a make macro substitution; not all make implementations
support this feature.

3.5.3.  CenterLine C under Solaris 2.3

If you are using the CenterLine C compiler to compile the distribution under
Solaris 2.3, place the following line in your site.def:

     #define HasCenterLineC YES

If clcc is not in your default search path, add this line to site.def:

     #define CcCmd /path/to/your/clcc

If you are using CodeCenter 4.0.4 or earlier, the following files trigger
bugs in the clcc optimizer:

     xc/programs/Xserver/cfb16/cfbgetsp.c
     xc/programs/Xserver/cfb16/cfbfillsp.c

     xc/programs/Xserver/cfb/cfbgetsp.c

Thus to build the server, you will have to compile these files by hand with
the -g flag:

     % cd xc/programs/Xserver/cfb16
     % make CDEBUGFLAGS="-g" cfbgetsp.o cfbfillsp.o
     % cd ../cfb
     % make CDEBUGFLAGS="-g" cfbgetsp.o

This optimizer bug appears to be fixed in CodeCenter 4.0.6.

3.5.4.  Microsoft Windows NT

The set of operating systems that the client-side code will run on has been
expanded to include Microsoft Windows NT.  All of the base libraries are
supported, including multi-threading in Xlib and Xt, but some of the more
complicated applications, specifically xterm and xdm, are not supported.

There are also some other rough edges in the implementation, such as lack of
support for non-socket file descriptors as Xt alternate inputs and not using
the registry for configurable parameters like the system filenames and
search paths.

3.6.  The Build

On NT, type

     nmake World.Win32 > world.log

On other systems, find the BootstrapCFlags line, if any, in the vendor.cf
file.  If there isn't one, type

     make World >& world.log

otherwise type

     make World BOOTSTRAPCFLAGS="value" >& world.log

You can call the output file something other than "world.log", but do not
call it "make.log" because files with this name are automatically deleted
during the "cleaning" stage of the build.

Because the build can take several hours to complete, you will probably want
to run it in the background and keep a watch on the output.  For example:

     make World >& world.log &
     tail -f world.log

If something goes wrong, the easiest thing is to just start over (typing
"make World" again) once you have corrected the problem.  It is possible
that a failure will corrupt the top-level Makefile.  If that happens, simply
delete the file and recreate a workable substitute:

     cp Makefile.ini Makefile

3.7.  Installing X

If everything is built successfully, you can install the software by typing
the following as root:

     make install >& install.log

Again, you might want to run this in the background and use tail to watch
the progress.

You can install the manual pages by typing the following as root:

     make install.man >& man.log

3.8.  Shared Libraries

Except on SunOS 4, the version number of all the shared libraries has
changed to 6.0.  If you want programs linked against previous versions of
the libraries to use the R6 libraries, create a link from the old name to
the new name.

3.9.  Setting Up xterm

If your /etc/termcap and /usr/lib/terminfo databases do not have correct
entries for xterm, use the sample entries provided in the directory
xc/programs/xterm/.  System V users may need to compile and install the ter-
minfo entry with the tic utility.

Since each xterm will need a separate pseudoterminal, you need a reasonable
number of them for normal execution.  You probably will want at least 32 on
a small, multiuser system.  On most systems, each pty has two devices, a
master and a slave, which are usually named /dev/tty[pqrstu][0-f] and
/dev/pty[pqrstu][0-f].  If you don't have at least the "p" and "q" sets con-
figured (try typing "ls /dev/?ty??"), you should have your system adminis-
trator add them.  This is commonly done by running the MAKEDEV script in the
/dev directory with appropriate arguments.

3.10.  Starting Servers at System Boot

The xfs and xdm programs are designed to be run automatically at system
startup.  Please read the manual pages for details on setting up configura-
tion files; reasonable sample files are in xc/programs/xdm/config/ and
xc/programs/xfs/.

If your system uses an /etc/rc file at boot time, you can usually enable
these programs by placing the following at or near the end of the file:

     if [ -f /usr/X11R6/bin/xfs ]; then
             /usr/X11R6/bin/xfs &; echo -n ' xfs'
     fi

     if [ -f /usr/X11R6/bin/xdm ]; then
             /usr/X11R6/bin/xdm; echo -n ' xdm'
     fi

Since xfs can serve fonts over the network, you do not need to run a font
server on every machine with an X display.  You should start xfs before xdm,
since xdm may start an X server which is a client of the font server.

The examples here use /usr/X11R6/bin, but if you have installed into a dif-
ferent directory by setting (or unsetting) ProjectRoot then you need to sub-
stitute the correct directory.

If you are unsure about how system boot works, or if your system does not
use /etc/rc, consult your system administrator for help.

3.11.  Using OPEN LOOK applications

You can use the X11R6 Xsun server with OPEN LOOK applications, but you must
pass the new -swapLkeys flag to the server on startup, or the OPEN LOOK
Undo, Copy, Paste, Find, and Cut keys may not work correctly.  For example,
to run Sun's OpenWindows 3.3 desktop environment with an X11R6 server, use
the command:

     % openwin -server /usr/X11R6/bin/Xsun -swapLkeys

The keysyms reported by keys on the numeric keypad have also changed since
X11R5; if you find that OpenWindows applications do not respond to keypad
keys and cursor control keys when using the R6 server, you can remap the
keypad to generate R5 style keysyms using the following xmodmap commands:

     keysym Pause = F21
     keysym Print = F22
     keysym Break = F23
     keysym KP_Equal = F24
     keysym KP_Divide = F25

     keysym KP_Multiply = F26
     keysym KP_Home = F27
     keysym KP_Up = Up
     keysym KP_Prior = F29
     keysym KP_Left = Left
     keycode 100 = F31
     keysym KP_Right = Right
     keysym KP_End = F33
     keysym KP_Down = Down
     keysym KP_Next = F35
     keysym KP_Insert = Insert
     keysym KP_Delete = Delete

3.12.  Rebuilding after Patches

You shouldn't need this right away, but eventually you are probably going to
make changes to the sources, for example by applying X Consortium public
patches.

Each patch comes with explicit instructions at the top of it saying what to
do.  Thus the procedure here is only an overview of the types of commands
that might be necessary to rebuild X after changing it.

If you are building from CD-ROM, apply the patches to the symbolic link
tree.  The links to changed files will be replaced with a local file con-
taining the new contents.

If only source files are changed, you should be able to rebuild just by
going to the xc directory in your build tree and typing:

     make >& make.log

If configuration files are changed, the safest thing to do is type:

     make Everything >& every.log

"Everything" is similar to "World" in that it rebuilds every Makefile, but
unlike "World" it does not delete the existing objects, libraries, and exe-
cutables, and only rebuilds what is out of date.

Note that in both kinds of rebuilds you do not need to supply the Boot-
strapCFlags value any more; the information is already recorded.

3.13.  Building Contributed Software

The software in contrib is not set up to have everything built automati-
cally.  It is assumed that you will build individual pieces as you find the

desire, time, and/or disk space.  You need to have the X Consortium part
built and installed before building the contributed software.  To build a
program or library in contrib, look in its directory for any special build
instructions (for example, a README file).  If there are none, and there is
an Imakefile, cd to the directory and type:

     xmkmf -a
     make >& make.log

This will build a Makefile in the directory and all subdirectories, and then
build the software.  If the build is successful, you should be able to
install it using the same commands used for the xc software:

     make install >& install.log
     make install.man >& man.log

4.  What Is New in Release 6

This section describes changes in the X Consortium distribution since
Release 5.  Release 6 contains much new functionality in many areas.  In
addition, many bugs have been fixed.  However, in the effort to develop the
new technology in this release, some bugs, particularly in client programs,
did not get fixed.

Except where noted, all libraries, protocols, and servers are upward compat-
ible with Release 5.  That is, R5 clients and applications should continue
to work with R6 libraries and servers.

4.1.  New Standards

The following are new X Consortium standards in Release 6.  Each is
described in its own section below.

     X Image Extension
     Inter-Client Communications Conventions Manual (update)
     Inter-Client Exchange Protocol
     Inter-Client Exchange Library
     X Session Management Protocol
     X Session Management Library
     Input Method Protocol
     X Logical Font Descriptions (update)
     SYNC extension
     XTEST extension
     PEX 5.1 Protocol (released after R5)
     PEXlib (released after R5)
     BIG-REQUESTS extension
     XC-MISC extension

4.2.  XIE (X Image Extension)

The sample implementation in Release 6 is a complete implementation of full
XIE 5.0 protocol, except for the following techniques that are excluded from
the SI:

     ColorAlloc:         Match, Requantize
     Convolve:           Replicate
     Decode:             JPEG lossless
     Encode:             JPEG lossless
     Geometry:           AntialiasByArea, AntialiasByLowpass

xieperf exercises the server functionality; it provides unit testing and a
reasonable measure of multi-element photoflo testing.

A draft standard of the XIElib specification is included in this release and
is open for Public Review.  The XIElib code matches the 5.0 protocol.

The JPEG compression and decompression code is based on the Independent JPEG
Group's (IJG) JPEG software, Release 4.  This software provides baseline
Huffman DCT encoding as defined by ISO/IEC DIS 10918-1, "Digital Compression
and Coding of Continuous-tone Still Images, Part 1: Requirements and guide-
lines", and was chosen as a basis for our implementation of JPEG compression
and decompression primarily because the IJG's design goals matched ours for
the implementation of the XIE SI: achieve portability and flexibility with-
out sacrificing performance.  Less than half of the files distributed by the
IJG have been incorporated into the XIE SI.  The IJG's software is made
available with restrictions; see xc/programs/Xserver/XIE/mixie/jpeg/README.

4.3.  Inter-Client Communications Conventions Manual

Release 6 includes version 2.0 of the ICCCM.  This version contains a large
number of changes and clarifications in the areas of window management,
selections, session management, and resource sharing.

4.3.1.  Window Management

The circumstances under which the window manager is required to send syn-
thetic ConfigureNotify events have been clarified to ensure that any Config-
ureWindow request issued by the client will result in a ConfigureNotify
event, either from the server or from the window manager.  We have also
added advice about how a client should inspect events so as to minimize the
number of situations where it is necessary to use the TranslateCoordinates
request.

The window_gravity field of WM_NORMAL_HINTS has a new value, StaticGravity,
which specifies that the window manager should not shift the client window's
location when reparenting the window.

The base size in the WM_NORMAL_HINTS property is now to be included in the
aspect ratio calculation.

The WM_STATE property now has a formal definition (it was previously only
suggested).

4.3.2.  Selections

We have clarified the CLIENT_WINDOW, LENGTH, and MULTIPLE targets.  We have
also added a number of new targets for Encapsulated PostScript and for the
Apple Macintosh PICT structured graphics format.  We have also defined a new
selection property type C_STRING, which is a string of non-zero bytes.
(This is in contrast to the STRING type, which excludes many control charac-
ters.)

A selection requester can now pass parameters in with the request.

Another new facility is manager selections.  This use of the selection mech-
anism is not to transfer data, but to allow clients known as managers to
provide services to other clients.  Version 2.0 also specifies that window
managers should hold a manager selection.  At present, the only service
defined for window managers is to report the ICCCM version number to which
the window manager complies.  Now that this facility is in place, additional
services can be added in the future.

4.3.3.  Resource Sharing

A prominent new addition in version 2.0 is the ability of clients to take
control of colormap installation under certain circumstances.  Earlier ver-
sions of the ICCCM specified that the window manager had exclusive control
over colormap installation.  This proves to be inconvenient for certain sit-
uations, such as when a client has the server grabbed.  Version 2.0 allows
clients to install colormaps themselves after having informed the window
manager.  Clients must hold a pointer grab for the entire time they are
doing their own colormap installation.

Version 2.0 also clarifies a number of rules about how clients can exchange
resources.  These rules are important when a client places a resource ID
into a hints property or passes a resource ID through the selection mecha-
nism.

4.3.4.  Session Management

Some of the properties in section 5 of ICCCM 1.1 are now obsolete, and new
properties for session management have been defined.

4.4.  ICE (Inter-Client Exchange)

ICE provides a common framework to build protocols on.  It supplies authen-
tication, byte order negotiation, version negotiation, and error reporting
conventions.  It supports multiplexing multiple protocols over a single
transport connection.  ICElib provides a common interface to these mecha-
nisms so that protocol implementors need not reinvent them.

An iceauth program was written to manipulate an ICE authority file; it is
very similar to the xauth program.

4.5.  SM (Session Management)

The X Session Management Protocol (XSMP) provides a uniform mechanism for
users to save and restore their sessions using the services of a network-
based session manager.  It is built on ICE.  SMlib is the C interface to the
protocol.  There is also support for XSMP in Xt.

A simple session manager, xsm is included in xc/workInProgress/xsm.

A new protocol, rstart, greatly simplifies the task of starting applications
on remote machines.  It is built upon already existing remote execution pro-
tocols such as rsh.  The most important feature that it adds is the ability
to pass environment variables and authentication data to the applications
being started.

4.6.  Input Method Protocol

Some languages need complex pre-editing input methods, and such an input
method may be implemented separately from applications in a process called
an Input Method (IM) Server.  The IM Server handles the display of pre-edit
text and the user's input operation.  The Input Method (IM) Protocol stan-
dardizes the communication between the IM Server and the IM library linked
with the application.

The IM Protocol is a completely new protocol, based on experience with R5's
sample implementations.  The following new features are added, beyond the
mechanisms in the R5 sample implementations:

o    The IM Server can support any of several transports for connection with
     the IM library.

o    Both the IM Server and clients can authenticate each other for secu-
     rity.

o    A client can connect to an IM Server without restarting even if it
     starts up before the IM Server.

o    A client can initiate string conversion to the IM Server for re-
     conversion of text.

o    A client can specify some keys as hot keys, which can be used to escape
     from the normal input method processing regardless of the input method
     state.

The R6 sample implementation for the internationalization support in Xlib
has a new pluggable framework, with the capability of loading and switching
locale object modules dynamically.  For backward compatibility, the R6 sam-
ple implementation can support the R5 protocols by switching to IM modules
supporting those protocols.  In addition, the framework provides the follow-
ing new functions and mechanisms:

X Locale database format:
     An X Locale database format is defined, and the subset of a user's
     environment dependent on language is provided as a plain ASCII text
     file.  You can customize the behavior of Xlib without changing Xlib
     itself.

ANSI C and non-ANSI C bindings
     The common set of methods and structures are defined, which bind the X
     locale to the system locales within libc, and a framework for imple-
     menting this common set under non-ANSI C base system is provided.

Converters
     The sample implementation has a mechanism to support various encodings
     by pluggable converters, and provides the following converters:

             - Light weight converter for C and ISO 8859
             - Generic converter (relatively slow) for other encoding
             - High performance converter for Shift-JIS and EUC
             - Converter for UCS-2 defined in ISO/IEC 10646-1

     You can add your converter using this mechanism for your specific per-
     formance requirement.

Locale modules
     The library is implemented such that input methods and output methods
     are separated and are independent of each other.  Therefore, an output-
     only client does not link with the IM code, and an input-only client
     does not link with the OM code.  Locale modules can be loaded on demand
     if the platform supports dynamic loading.

Transport Layer
     There are several kinds of transports for connection between the IM
     library and the IM Server.  The IM Protocol is independent of a spe-
     cific transport layer protocol, and the sample implementation has a
     mechanism to permit an IM Server to define the transports which the IM
     Server is willing to use.  The sample implementation supports transport
     over the X protocol, TCP/IP and DECnet.

There are IM Servers for Japanese and for Korean, internationalized clients
using IM services, and an IM Server developer's kit in contrib.  The IM
Server developer's kit hides the details of the IM Protocol and the trans-
port layer protocols, and hides the differences between the R5 and R6 proto-
cols from the IM Server developer, so that an IM developer has an easier

task in developing new IM Servers.

4.7.  X Logical Font Description

The X Logical Font Description has been enhanced to include general 2D lin-
ear transformations, character set subsets, and support for polymorphic
fonts.  See xc/doc/specs/XLFD/xlfd.tbl.ms for details.

4.8.  SYNC extension

The Synchronization extension lets clients synchronize via the X server.
This eliminates the network delays and the differences in synchronization
primitives between operating systems.  The extension provides a general
Counter resource; clients can alter the value of a Counter, and can block
their execution until a Counter reaches a specific threshold.  Thus, for
example, two clients can share a Counter initialized to zero, one client can
draw some graphics and then increment the Counter, and the other client can
block until the Counter reaches a value of one and then draw some additional
graphics.

4.9.  BIG-REQUESTS extension

The standard X protocol only allows requests up to 2^18 bytes long.  A new
protocol extension, BIG-REQUESTS, has been added that allows a client to
extend the length field in protocol requests to be a 32-bit value.  This
useful for PEX and other extensions that transmit complex information to the
server.

4.10.  XC-MISC extension

A new extension, XC-MISC, allows clients to get back ID ranges from the
server.  Xlib handles this automatically under the covers.  This is useful
for long-running applications that use many IDs over their lifetime.

4.11.  XTEST extension

The XTEST extension, which first shipped as a patch to Release 5, is
included.

4.12.  Tree Reorganization

Many of the directories under xc/ (renamed from mit/) have been moved.  See

the section The XC Tree for the new layout.  The reorganization has simpli-
fied dependencies in the build process.  Once you get used to the new lay-
out, things will be easier to find.

Various filenames have been changed to minimize name conflicts on systems
that limit file names to eight characters, a period, and three more charac-
ters.  Conflicts remain for various header (.h) files.

4.13.  Configuration Files

The configuration files have changed quite a bit, we hope in a mostly com-
patible fashion.  The main config files are now in xc/config/cf, imake
sources are in xc/config/imake, and makedepend sources are in
xc/config/makedepend.  The lndir program (for creating link trees) is in
xc/config/util; there is a Makefile.ini in that directory that may be useful
to get lndir built the first time (before you build the rest of the tree).

The rules for building libraries have changed a lot; it is now much easier
to add a new library to the system.

The selection of vendor.cf file has moved from Imake.tmpl to a new Imake.cf.

The config variable that was called ServerOSDefines in R5 has been renamed
to ServerExtraDefines, and applies globally to all X server sources.  The
variable ServerOSDefines now applies just to the os directory of the server.

There are a number of new config variables dealing with C++, all of which
have "Cplusplus" in their names.

"#" should no longer be thought of as a valid comment character in Imake-
files; use "XCOMM" instead.

There are new variables (e.g., HasPoll, HasBSD44Sockets, ThreadedX) and
rules (SpecialCObjectRule).  Read xc/config/cf/README for details.

The way libraries get built has changed: the unshared library .o's are now
placed in a subdirectory rather than the shared library .o's.

Multi-threaded programs can often just include Threads.tmpl in their Imake-
file to get the correct compile-time defines and libraries.

4.14.  Kerberos

There is a new authorization scheme for X clients, MIT-KERBEROS-5.  It
implements MIT's Kerberos Version 5 user-to-user authentication.  See the
Xsecurity manual page for details on how Kerberos works in X.  As with any
other authentication protocol, xdm sets it up at login time, and Xlib uses
it to authenticate the client to the X server.

If you have Kerberos 5 on your system, set the HasKrb5 config variable in
site.def to YES to enable Kerberos support.

4.15.  X Transport Library (xtrans)

The X Transport Library is intended to combine all system and transport spe-
cific code into a single place in the source tree.  This API should be used
by all libraries, clients and servers of the X Window System.  Note that
this API is not an X Consortium standard; it is merely in internal part of
our implementation.  Use of this API should allow the addition of new types
of transports and support for new platforms without making any changes to
the source except in the X Transport Interface code.

The following areas have been updated to use xtrans:

     lib/X11 (including the Input Method code)
     lib/ICE
     lib/font/fc
     lib/FS
     XServer/os
     xfs/os

The XDMCP code in xdm and the X server has not been modified to use xtrans.

No testing has been done for DECnet.

4.16.  Xlib

Xlib now supports multi-threaded access to a single display connection.
Xlib functions lock the display structure, causing other threads calling
Xlib functions to be suspended until the first thread unlocks.  Threads
inside Xlib waiting to read to or write from the X server do not keep the
display locked, so for example a thread hanging on XNextEvent will not pre-
vent other threads from doing output to the server.

Multi-threaded Xlib runs on SunOS 5.3, DEC OSF/1 1.3, Mach 2.5 Vers 2.00.1,
AIX 2.3, and Microsoft Windows NT 3.1.  Locking for Xcms and I18N support
has not been reviewed.  A version of ico that can be compiled to use threads
is in contrib/programs/ico.

The Display and GC structures have been made opaque to normal application
code; references to private fields will get compiler errors.  You can work
around some of these by compiling with -DXLIB_ILLEGAL_ACCESS, but better to
fix the offending code.

The Xlib implementation has been changed to support a form of asynchronous
replies, meaning that a request can be sent off to the server, and then
other requests can be generated without waiting for the first reply to come
back.  This is used to advantage in two new functions, XInternAtoms and

XGetAtomNames, which reduce what would otherwise require multiple round
trips to the server down to a single round trip.  It is also used in some
existing functions, such as XGetWindowAttributes, to reduce two round trips
to just one.

Lots of Xlib source files were renamed to fit better on systems with short
filenames.  The "X" prefix was dropped from most file names, and "CIE" and
"TekHVC" prefixes were dropped.

Support for using poll() rather than select() is implemented, selected by
the HasPoll config option.

The BIG-REQUESTS extension is supported.

The following Xlib functions are new in Release 6:

     XInternAtoms, XGetAtomNames
     XExtendedMaxRequestSize
     XInitImage
     XReadBitmapFileData
     IsPrivateKeypadKey
     XConvertCase
     XAddConnectionWatch, XRemoveConnectionWatch, XProcessInternalConnection
     XInternalConnectionNumbers
     XInitThreads, XLockDisplay, XUnlockDisplay

     XOpenOM, XCloseOM
     XSetOMValues, XGetOMValues
     XDisplayOfOM, XLocaleOfOM
     XCreateOC, XDestroyOC
     XOMOfOC
     XSetOCValues, XGetOCValues
     XDirectionalDependentDrawing, XContextualDrawing
     XRegisterIMInstantiateCallback, XUnregisterIMInstantiateCallback
     XSetIMValues

     XAllocIDs
     XESetBeforeFlush
     _XAllocTemp, _XFreeTemp

Support for MIT-KERBEROS-5 has been added.

4.17.  Internationalization

Internationalization (also known as I18N, there being 18 letters between the
i and n) of the X Window System, which was originally introduced in Release
5, has been significantly improved in R6.  The R6 I18N architecture follows
that in R5, being based on the locale model used in ANSI C and POSIX, with
most of the I18N capability provided by Xlib.  R5 introduced a fundamental
framework for internationalized input and output.  It could enable basic
localization for left-to-right, non-context sensitive, 8-bit or multi-byte

codeset languages and cultural conventions.  However, it did not deal with
all possible languages and cultural conventions.  R6 also does not cover all
possible languages and cultural conventions, but R6 contains substantial new
Xlib interfaces to support I18N enhancements, in order to enable additional
language support and more practical localization.

The additional support is mainly in the area of text display.  In order to
support multi-byte encodings, the concept of a FontSet was introduced in R5.
In R6, Xlib enhances this concept to a more generalized notion of output
methods and output contexts.  Just as input methods and input contexts sup-
port complex text input, output methods and output contexts support complex
and more intelligent text display, dealing not only with multiple fonts but
also with context dependencies.  The result is a general framework to enable
bi-directional text and context sensitive text display.

4.18.  Xt

Support has been added for participation in session management, with call-
backs to application functionality in response to messages from the session
manager.

The entire library is now thread-safe, allowing one thread at a time to
enter the library and protecting global data as necessary from concurrent
use.

Support is provided for registering event handlers for events generated by X
protocol extensions, and for dispatching those events to the appropriate
widget.

A mechanism has also been added for dispatching events for non-widget draw-
ables (such as pixmaps used within a widget) to a widget.

Two new widget methods for instance allocation and deallocation allow wid-
gets to be treated as C++ objects in a C++ environment.

A new interface allows bundled changes to the managed set of children of a
Composite, reducing the visual disruption of multiple changes to geometry
layout.

Several new resources have been added to Shell widgets, making the library
compliant with the Release 6 ICCCM.  Parameterized targets of selections
(new in Release 6) and the MULTIPLE target are supported with new APIs.

Safe handling of POSIX signals and other asynchronous notifications is now
provided.

A hook has been added to give notification of blocking in the event manager.

The client will be able to register callbacks on a per-display basis for
notification of a large variety of operations in the X Toolkit.  This fea-
ture is useful to external agents such as screen readers.

New String resource converters: XtStringToGravity and XtCvtStringToRestart-
Style.

The file search path syntax has a new %D substitution that inserts the
default search path, making it easy to prepend and append to the default
search path.

The Xt implementation allows a configuration choice of poll or select for
I/O multiplexing, selectable at compile time by the HasPoll config option.

The Release 6 Xt implementation requires Release 6 Xlib.  Specifically, it
uses the following new Xlib features: XInternAtoms instead of multiple XIn-
ternAtom calls where possible, input method support (Xlib internal connec-
tions), and tests for the XVisibleHint in the flags of XWMHints.

When linking with Xt, you now need to also link with SMlib and ICElib.  This
is automatic if you use the XTOOLLIB make variable or XawClientLibs imake
variable in your Imakefiles.

This implementation no longer allows NULL to be passed as the value in the
name/value pair in a request to XtGetValues.  The default behavior is to
print the error message "NULL ArgVal In XtGetValues" and exit.  To restore
the R5 behavior, set the config variable GetValuesBC in site.def.  The old
behavior was never part of the Xt specification, but some applications erro-
neously rely on it.

Motif 1.2 defines the types XtTypedArg and XtTypedArgList in VaSimpleP.h.
These types are now defined in IntrinsicP.h.  To work around the conflict,
in Motif VaSimple.c, if IntrinsicP.h is not already included before VaSim-
pleP.h, do so.  In VaSimpleP.h, fence off the type declarations with #if
(XT_REVISION < 6) and #endif.

See Chapter 13 of the Xt specification for more details.

4.19.  Xaw

Some minor bugs have been fixed.  Please note that the Athena Widgets have
been and continue to be low on our priority list; therefore many bugs remain
and many requests for enhancements have not been implemented.

Text and Panner widget translations have been augmented to include keypad
cursor keysyms in addition to the normal cursor keysyms.

The Clock, Logo, and Mailbox widgets have moved to their respective applica-
tions.

Internationalization support is now included.  Xaw uses native widechar sup-
port when available, otherwise it uses the Xlib widechar routines.  Per sys-
tem specifics are set in XawI18n.h.

The shared library major version number on SunOS 4 has been incremented
because of these changes.

4.19.1.  AsciiText

The name AsciiText is now a misnomer, but has been retained for backward
compatibility.  A new resource, XtNinternational, has been added.  If the
value of the XtNinternational resource is False (the default) AsciiSrc and
AsciiSink source and sink widgets are created, and the widget behaves as it
did for R5.  If the value is True, MultiSrc and MultiSink source and sink
widgets are created.  The MultiSrc widget will connect to an Input Method
Server if one is available, or if one isn't available, it will use an Xlib
internal pseudo input method that, at a minimum, does compose processing.
Application programmers who wish to use this feature will need to add a call
to XtSetLanguageProc to their programs.

The symbolic constant FMT8BIT has been changed to XawFmt8Bit to be consis-
tent with the new symbolic constant XawFmtWide.  FMT8BIT remains for back-
wards compatibility, however its use is discouraged as it will eventually be
removed from the implementation.  See the Xaw manual for details.

4.19.2.  Command, Label, List, MenuButton, Repeater, SmeBSB, and Toggle

Two new resources have been added, XtNinternational and XtNfontSet.  If
XtNinternational is set to True the widget displays its text using the spec-
ified fontset.  See the Xaw manual for details.

4.20.  PEX

In discussing PEX it is important to understand the nature of 3D graphics
and the purpose of the existence of the PEX SI.  The type of graphics for
which PEX provides support, while capable of being done in software, is most
commonly found in high performance hardware.  Creation and maintenance of
software rendering code is costly and resource consumptive.  The original
Sample Implementation for the PEX Protocol 5.0 was primarily intended for
consumption by vendors of the X Consortium who intended to provide PEX prod-
ucts for sale.  This implementation was intended to be fairly complete how-
ever it was understood that vendors who intended to commercialize it would
dispose of portions of it, often fairly substantial ones.  It was therefore
understood that functionality most likely to be disposed of by them might be
neglected in the development of a Sample Implementation.  As PEX is now a
fairly mature standard distributed by most if not all major vendors, and the
standard itself has evolved from the 5.0 protocol level to the 5.1 protocol
level, the X Consortium and its supporting vendors have recognized a need to
focus on certain portions of the PEX technology while deemphasizing others.

This release incorporates PEX functionality based upon the PEX 5.1 level
protocol.  The PEX Sample Implementation (SI) is composed of several parts.
The major components are the extension to the X Server, which implements the
PEX 5.1 protocol, and the client side API, which provides a mechanism by
which clients can generate PEX protocol.

The API now provided with the PEX-SI is called PEXlib.  This is a change
from R5 which shipped an API based upon the ISO IS PHIGS and PHIGS PLUS
Bindings.  That API has been moved to contrib in favor of the PEXlib API
based upon the PEXlib 5.1 binding, which itself is an X Consortium standard.
The PEXlib binding is a lower-level interface than the previous PHIGS bind-
ing was and maps more closely to the PEX protocol itself.  It supports imme-
diate mode rendering functionality as well as the previous PHIGS workstation
modes and is therefore suited to a wider range of applications.  It is also
suited for the development of higher level APIs.  There are in fact commer-
cial implementations of the PHIGS API which utilize the PEXlib API.

The PHIGS API based verification tool called InsPEX is moved to contrib.  A
prototype of a possible new tool called suspex is in the directory con-
trib/test/suspex.  Suspex is PEXlib based.

Demo programs are no longer supported and have moved to contrib.

4.20.1.  PEX Standards and Functionality

This release conforms to the PEX Protocol Specification 5.1 though it does
not implement all the functionality specified therein.

The release comes with 2 fonts, Roman and Roman_M (see the User's Guide for
more details).

As discussed briefly above certain functionality is not implemented in this
Sample Implementation.  Most notably Hidden Line, Hidden Surface Removal is
not implemented.  This is a result of both architectural decisions and the
fact that it surely would have been replaced by vendors with proprietary
code.  A contributed implementation which supports some of the HLHSR func-
tionality utilizing a Z buffer based technique is available for ftp from
ftp.x.org in the directory contrib/PEX_HLHSR.

This release does not support monochrome displays, though it does support 8
bit and 24 bit color.

Other functionality not complete in this release is:

     Backface Attributes and Distinguish Flag
     Font sharing between clients
     Patterns, Hatches and associated attributes
     Transparency
     Depth Cueing for Markers

Double Buffering is available for the PHIGS Workstation subsets directly
through the workstation.  The buffer mode should be set on when creating the
workstation.  For immediate mode users double buffering is achieved via the
Multi Buffering Extension (aka MBX) found in the directory xc/lib/Xext.

PEX 5.1 protocol adds certain functionality to the Server extension, acces-
sible directly via the PEXlib API.  This functionality includes Picking via

the Immediate Mode Renderer (Render Elements and Accumulate State commands
in Chapter 6, all of Chapter 7); new Escape requests to allow vendors to
support optional functionality; a Match Rendering Targets request to return
information about visuals, depth and drawables the server can support; a
noop Output command; Hierarchical HLHSR control (i.e., during traversals);
and renderer clearing controls are the most important features.

4.21.  Header Files

Two new macros are defined in Xos.h: X_GETTIMEOFDAY and strerror.
X_GETTIMEOFDAY is like gettimeofday() but takes one argument on all systems.
strerror is defined only on systems that don't already have it.

A new header file Xthreads.h provides a platform-independent interface to
threads functions on various systems.  Include it instead of the system
threads header file.  Use the macros defined in it instead of the system
threads functions.

4.22.  Fonts

There are three new Chinese bdf fonts in xc/fonts/bdf/misc (gb16fs.bdf,
gb16st.bdf, gb24st.bdf).

Bitmap Charter fonts that are identical to the output generated from the
outline font have been moved to xc/fonts/bdf/unnec_{75,100}dpi.

The Type 1 fonts contributed by Bitstream, IBM, and Adobe that shipped in
contrib in Release 5 have been moved into the core.

Some of the misc fonts, mostly in the Clean family, have only the ASCII
characters, but were incorrectly labeled "ISO8859-1".  These fonts have been
renamed to be "ISO646.1991-IRV".  Aliases have been provided for the Release
5 names.

The 9x15 font has new shapes for some characters.  The 6x10 font has the
entire ISO 8859-1 character set.

4.23.  Font library

The Type1 rasterizer that shipped in contrib in Release 5 is now part of the
core.

There is an option to have the X server request glyphs only as it needs
them.  The X server then caches the glyphs for future use.

Aliases in a fonts.alias file can allow one scalable alias name to match all
instances of another font.  The "!" character introduces a comment line in

fonts.alias files.

A sample font authorization protocol, "hp-hostname-1" has been added.  It is
based on host names and is non-authenticating.  The client requesting a font
from a font server provides (or passes through from its client) the host
name of the ultimate client of the font.  There is no check that this host
name is accurate, as this is a sample protocol only.

The Speedo rasterizer can now read fonts with retail encryption.  This means
that fonts bought over-the-counter at a computer store can be used by the
font server and X server.

Many, many bugs have been fixed.

4.24.  Font server

The font server has been renamed from fs to xfs to avoid confusion with an
AFS program.  The default port has changed from 7000 (used by AFS) to 7100
and has been registered with the Internet Assigned Numbers Authority.

The font server now implements a new major protocol version, version 2.
This change was made only to correct errors in the implementation of version
1.  Version 1 is still accepted by xfs.

You can now connect to xfs using the local/ transport.

Many, many bugs have been fixed.

4.25.  X server

The server sources have moved to xc/programs/Xserver.  Server-side extension
code exists as subdirectories.  The ddx directory is gone; mi, cfb, and mfb
are at the top level, and a hw (hardware) subdirectory now exists for hold-
ing vendor-specific ddx code.  Note: the absence of a ddx directory does not
imply that the conceptual split between dix and ddx is gone.

Function prototypes have been added to header files in
xc/programs/Xserver/include, cfb, mfb, mi, and os.

Support for pixmap privates has been added.  It is turned off by default,
but can be activated by putting -DPIXPRIV in the ServerExtraDefines parame-
ter in your vendor.cf file.  See the porting layer document for details.

New screen functions, called primarily by code in window.c, have been added
to make life easier for vendors with multi-layered framebuffers.  Several
functions and some pieces of functions have moved from window.c to miwin-
dow.c.  See the porting layer document for details.  Also, the contents of
union _Validate (validate.h) are now device dependent; mivalidate.h contains
a sample definition.

An implementation of the SYNC extension is in
xc/programs/Xserver/Xext/sync.c.  As part of this work, client priorities
have also been implemented; see the tail end of WaitForSomething() in Wait-
For.c.  The priority scheme is strict in that the client(s) with the highest
priority always runs.  twm has been modified to provide simple facilities
for setting client priorities.

The server can now fetch font glyphs on demand instead of loading them all
at once.  See xc/programs/Xserver/dix/dixfonts.c, xc/lib/font/fc/fserve.c,
and xc/lib/font/fc/fsconvert.c.  A new X server command line option, -defer-
glyphs, controls which types of fonts (8 vs. 16 bit) to demand load; see the
X manual page for details.

The os layer now uses sigaction on POSIX systems; a new function OsSignal
was added for convenience, which you should use in your ddx code.

A new timer interface has been added to the os layer; see the functions in
os/WaitFor.c.  This interface is used by XKB, but we haven't tried to use it
anywhere else (such as Xext/sleepuntil.c) yet.

Redundant code for GC funcs was moved from cfbgc.c and mfbgc.c to migc.c.
This file also contains a few utility functions such as miComputeComposite-
Clip, which replaces the chunk of code that used to appear near the top of
most versions of ValidateGC.

The cfb code can now be compiled multiple times to provide support for mul-
tiple depths in the same server, e.g., 8, 12, and 24.  See Imakefile and
cfb/cfbmskbits.h under the xc/programs/Xserver/ directory for starters.

The cfb and mfb code have been modified to perform 64 bit reads and writes
of the framebuffer on the Alpha AXP.  These modifications should be usable
on other 64 bit architectures as well, though we have not tested it on any
others.  There are a few hacks in dix, notably ProcPutImage and ProcGetIm-
age, to work around the fact that the protocol doesn't allow you to specify
64 bit padding.  Note that the server will still not run on a machine such
as a Cray that does not have a 32 bit data type.

For performance, all region operations are now invoked via macros which by
default make direct calls to the appropriate mi functions.  You can condi-
tionally compile them to continue calling through the screen structure.  The
following change was made throughout the server:

     "(*pScreen->RegionOp)(...)" changes to "REGION_OP(pScreen, ...)"

Some of the trivial region ops have been inlined in the macros.  For compat-
ibility, the region function pointers remain in the screen structure even if
the server is compiled to make direct calls to mi.  See include/regionstr.h.

A generic callback manager is included and can be used to add notification-
style hooks anywhere in the server.  See dixutils.c.  The callback manager
is now being used to provide notification of when the server is
grabbed/ungrabbed, when a client's state changes, and when an event is sent
to a client.  The latter two are used by the RECORD extension.

A new option has been added, -config filename.  This lets you put server
options in a file.  See os/utils.c.

Xtrans has been installed into the os layer.  See os/connection.c, io.c, and
transport.c.  As a result, the server now supports the many flavors of SVR4
local connections.

The client structure now has privates like windows, pixmaps, and GCs.  See
include/dixstruct.h, dix/privates.c, and dispatch.c.

Thin line pixelization is now consistent across cfb, mfb, and mi.  It is
also reversible, meaning the same pixels are touched when drawing from point
A to point B as are touched when drawing from point B to point A.  A new
header file, miline.h, consolidates some miscellaneous line drawing utili-
ties that had previously been duplicated in a number of places.

4.25.1.  Xnest

A new server, Xnest, uses Xlib to implement ddx rendering.  See
xc/programs/Xserver/hw/xnest.  Xnest lets you run an X server in a window on
another X server.  Uses include testing dix and extensions, debugging client
protocol errors, debugging grabs, and testing interactive programs in a
hardware-starved environment.

4.25.2.  Xvfb

Another new server, Xvfb, uses cfb or mfb code to render into a framebuffer
that is allocated in virtual memory.  See xc/programs/Xserver/hw/vfb.  The
framebuffer can be allocated in normal memory, shared memory, or as a memory
mapped file.  Xvfb's screen is normally not visible; however, when allocated
as a memory mapped file, xwd can display the screen by specifying the frame-
buffer file as its input.

4.25.3.  ddx

Sun ddx
     Expanded device probe table finds multiple frame buffers of the same
     type.  Expanded keymap tables provide support for European and Asian
     keyboards.  Added per-key autorepeat support.  Considerable cleanup and
     duplicate code eliminated.  Deletion of SunView support.  GX source
     code now included.

HP ddx
     cfb-based sources included as xc/programs/Xserver/hw/hp.

svga ddx
     new svga ddx for SVR4 included as xc/programs/Xserver/hw/svga.

xfree86 ddx
     ddxen from XFree86, Inc. included as xc/programs/Xserver/hw/xfree86.

Amoeba ddx
     ddx for Sun server on the Amoeba operating system included as
     xc/programs/Xserver/hw/sunAmoeba.  The server will require additional
     patches for this to be usable.

4.26.  New Programs

xc/config/util/mkshadow/, a replacement for lndir.

4.27.  Old Software

We have dropped support for the following libraries and programs and have
moved them to contrib: CLX library, PHIGS library, MacFS, auto_box,
beach_ball, gpc, ico, listres, maze, puzzle, showfont, viewres, xbiff,
xcalc, xditview, xedit, xev, xeyes, xfontsel, xgas, xgc, xload, xman, and
xpr.

4.28.  xhost

Two new families have been registered: LocalHost, for connections over a
non-network transport, and Krb5Principal, for Kerberos V5 principals.

To distinguish between different host families, a new xhost syntax "fam-
ily:name" has been introduced.  Names are as before; families are as fol-
lows:

     inet:     Internet host
     dnet:     DECnet host
     nis:      Secure RPC network name
     krb:      Kerberos V5 principal
     local:    contains only one name, ""

The old-style syntax for names is still supported when the name does not
contain a colon.

4.29.  xrdb

Many new symbols are defined to tell you what extensions and visual classes
are available.

4.30.  twm

An interface for setting client priorities with the Sync extension has been
added.

Many bugs have not been fixed yet.

4.31.  xdm

There is a new resource, choiceTimeout, that controls how long to wait for a
display to respond after the user has selected a host from the chooser.

Support has been added for a modular, dynamically-loaded greeter library.
This feature allows different dynamic libraries to by loaded by xdm at run-
time to provide different login window interfaces without access to the xdm
sources.  It works on DEC OSF/1 and SVR4.  The name of the greeter library
is controlled by another new resource, greeterLib.

When you log in via xdm, xdm will use your password to obtain the initial
Kerberos tickets and store them in a local credentials cache file.  The cre-
dentials cache is destroyed when the session ends.

4.32.  xterm

Now supports a few escape sequences from HP terminals, such as memory lock-
ing.  See xc/doc/specs/xterm/ctlseqs.ms for details.

The termcap and terminfo files have been updated.

ctlseqs.ms has moved out of the xterm source directory into
xc/doc/specs/xterm.

The logging mis-feature of xterm is removed.  This change first appeared as
a public patch to Release 5.

Many bugs have not been fixed yet.

4.33.  xset

The screen saver control option has two new sub-options to immediately acti-
vate or deactivate the screen saver: xset s activate and xset s reset.

4.34.  X Test Suite

The X Test Suite, shipped separately from R5, is now part of the core

distribution in R6.

The code has been fixed to work on Alpha AXP.  The Xi tests contributed by
HP and XIM tests contributed by Sun are integrated.

4.35.  Work in Progress

Everything under xc/workInProgress represents a work in progress of the X
Consortium.

Fresco, Low Bandwidth X (LBX), the Record extension, and the X Keyboard
extension (Xkb, which logically belongs here but was too tightly coupled
into Xlib and the server to extract) are neither standards nor draft stan-
dards, are known to need design and/or implementation work, are still evolv-
ing, and will not be compatible with any final standard should such a stan-
dard eventually be agreed upon.  We are making them available in early form
in order to gather broader experimentation and feedback from those willing
to invest the time and energy to help us produce better standards.

Any use of these interfaces in commercial products runs the risk of later
source and binary incompatibilities.

4.35.1.  Fresco

R6 includes the first sample implementation of Fresco, a user interface sys-
tem specified using CORBA IDL and implemented in C++.  Fresco is not yet a
Consortium standard or draft standard, but is being distributed as a work in
progress to demonstrate our current directions and to gather feedback on
requirements for a Fresco standard.

The Fresco Sample Implementation has been integrated into the X11R6 build
process, and will be built automatically if you have a C++ compiler avail-
able.  Documentation on Fresco can be found in xc/doc/specs/Fresco.  The
Fresco and Xtf libraries are found in xc/workInProgress/Fresco and
xc/workInProgress/Xtf, respectively.  There are some simple Fresco example
programs in contrib/examples/Fresco, and a number of related programs in
contrib/programs, including:

ixx  An IDL to C++ translator

i2mif
     A program to generate FrameMaker MIF documents from comments in an IDL
     specification

fdraw
     A simple Fresco drawing editor

dish A TCL interpreter with hooks to Fresco

Working Imakefiles are provided for all of the utilities and examples.

A demo program (dish) is included that shows how a scripting language (Tcl)
can rather easily be bound to Fresco through the CORBA dynamic invocation
mechanism.  A copy of Tcl is included in contrib/lib/tcl.

To build Fresco you must define HasCplusplus in site.def; in addition, you
may have to set CplusplusCmd and/or CplusplusDependIncludes to invoke the
appropriate C++ compiler and find the required header files during make
depend.  Finally, you should check the vendor.cf to see if there are any
other configuration variables you should set to provide information about
your C++ compiler.

Fresco requires a C++ compiler that implements version 3 of the C++ language
(as approximately defined by USL cfront version 3).  While Fresco does not
currently use templates or exceptions, it does make extensive use of nested
types, which were inadequately supported in earlier versions of the lan-
guage.

Fresco has been built with the following platforms and C++ compilers:

     SPARCstation     SunOS 4.1.3  CenterLine C++
     SPARCstation     Solaris 2.3  CenterLine C++ (requires v2.0.6)
     SPARCstation     Solaris 2.3  SPARCCompiler C++ v4.0
     HP 9000/700      HPUX 9.0.1   CenterLine C++
     SGI Indy         IRIX 5.2     SGI C++
     IBM RS/6000      AIX 3.2.5    IBM xlC
     Sony NEWS        NEWSOS 6.0   Sony C++

Fresco has also been compiled on the DEC Alpha under OSF/1 version 2.0 using
a beta test version of DEC C++ 1.3.  Fresco cannot be built with the Gnu C++
compiler (version 2.5.8 or earlier) due to bugs and limitations in g++.

Building Fresco with CenterLine C++ requires that you pass the -Xa flag to
the C++ compiler.  Place the following lines in your site.def:

     #define HasCenterLineCplusplus YES
     #define CplusplusOptions -Xa

If CC is not in your default search path, add this line to site.def:

     #define CplusplusCmd /path/to/your/CC

If you are building under Solaris 2, you must use ObjectCenter version 2.0.6
or later; the C++ compiler in ObjectCenter 2.0.4 will produce Fresco appli-
cations that dump core on startup.

Fresco does not yet build under Microsoft Windows/NT.

4.35.2.  XKB (X Keyboard Extension)

Support for XKB is not compiled in to Xlib by default.  It is compiled in
the X server by default only on Sun and Omron Luna machines.  You can com-
pile it in by setting

     #define BuildXKB YES          /* for support in the X server */
     #define BuildXKBLib YES       /* for support in the X library */

in the file xc/config/cf/site.def.  Note that enabling XKB in the X server
is a pervasive change; you need to clean the server and rebuild everything
if you change this option.

Turning on XKB in the X server usually requires changes to the vendor ddx
keyboard handling.  There is currently support only in the Sun and Omron
ddx.

If you turn on BuildXKBLib, additional functions are added to Xlib.  Since
the resulting library is non-standard, it is given a different name:
libX11kb instead of libX11.  All Makefiles produced by imake will use
-lX11kb to link Xlib.

The library changes for XKB are known not to work on the Cray; many other
systems have been tested, including the Alpha AXP.

There are some XKB test programs in contrib/test/Xkb.

The XKB support in Xlib is still at an early stage of formal review and
could change.  We expect some additions in an eventual standard, but few
changes to the interfaces provided in this implementation.  A working draft
of the protocol is in /xc/doc/specs/Xkb/.

4.35.3.  LBX (Low Bandwidth X)

The X Consortium is working to define a standard for running X applications
over serial lines, wide area networks, and other slow links.  This effort,
called Low Bandwidth X (LBX), aims to improve the startup time, performance,
and interactive feel of X applications run over low bandwidth transports.

LBX does this by interposing a pseudo-server (called the proxy) between the
X clients and the X server.  The proxy caches data flowing between the
server and the clients, merges the X protocol streams, and compresses the
data that is sent over the low bandwidth wire.  The X server at the other
end uncompresses the data and splits it back out into separate request
streams.  The target is to make many X applications transparently usable
over 9600 bps modems.

A snapshot of the code for this effort is included in xc/workInProgress/lbx/
for people to examine and begin experimenting with.  It contains the follow-
ing features:

o    LZW compression of the binary data stream.  Since commercial use of LZW
     requires licensing patented technology, we are also looking for an
     unencumbered algorithm and implementation to provide as well.

o    Delta compression of X packets (representing packets as differences
     from previously sent packets).

o    Re-encoding of some graphics requests (points, lines, segments, rectan-
     gles, and arcs).

o    Motion event throttling (to keep from flooding the wire).

o    Caching of data in the proxy for large data objects that otherwise
     would be transmitted over the wire multiple times (e.g., properties,
     font metrics, keyboard mappings, connection startup data, etc.).

o    Short-circuiting of requests for constant data (e.g., atoms, color-
     name/rgb mappings, and read-only color cells).

However, the following items have yet to be implemented (which is why it
isn't a standard yet):

o    Re-encoding of a number of requests (e.g., QueryFont), events, etc.

o    Support for BIG-REQUESTS extension.

o    A non-networked serial protocol for environments which cannot support
     os-level networking over serial lines.

o    A full specification needs to be written describing the network proto-
     col used between the proxy and the server.

The X Consortium is continuing to work on both the implementation of the
remaining items and the full specification.  The goal is to have all of the
pieces ready for public review later this year.  Since the specification for
LBX will change, we strongly recommend against anyone incorporating LBX into
a product based on this prototype.  But, they are encouraged to start look-
ing at the code, examining the concepts, and providing feedback on its
design.

4.35.4.  RECORD extension

RECORD is an X protocol extension that supports the recording of all core X
protocol and arbitrary X extension protocol.

A version of the extension is included in xc/workInProgress/record.  The
implementation does not quite match the version 1.2 draft specification, but
the spec is going to change anyway; the version 1.3 draft is in
xc/doc/specs/Xext/record.ms.  The GetConfig request is not fully imple-
mented.  A test program is in contrib/test/record.

4.35.5.  Simple Session Manager

A simple session manager has been developed to test the new Session Manage-
ment protocol.  At the moment, it does not exercise the complete XSMP proto-
col and the user interface is rather simple.  While it does have enough
functionality to make it useful, it needs more work before we would want
people to depend on it or use it as a good example of how to implement the
session protocol.

o    Handles accepting connections from clients

o    Handles graceful or unexpected termination of clients

o    Maintains database of all properties set by clients

o    User interface provides a way to issue checkpoint and shutdown messages
     to clients

o    Manages client interaction with the user

o    Can restart clients.  Clients running on remote machines are handled
     using the new rstart protocol.

o    Requires MIT-MAGIC-COOKIE-1 authentication from clients.

We have not yet written a proxy for connecting ICCCM 1.0 clients to the ses-
sion manager.

A sample client, xsmclient, has been written to demonstrate the session sup-
port in Xt.

4.35.6.  Multi-Threaded X Server

An attempt has been made to merge the multi-threaded server source with the
single-threaded source.  The result is in the xc/workInProgress/MTXserver
directory.  The sources here include only files that were changed from the
single-threaded server.  The multi-threaded server may not compile.  Unfor-
tunately, the single-threaded server sources have continued to evolve since
this snapshot of the MTXserver was produced, so there is work to be done to
get the MTXserver sources back into a state where they can be compiled.

4.36.  ANSIfication

We've changed our sources to stop using the BSD function names index,
rindex, bcopy, bcmp; we now use strchr, strrchr, memcpy/memmove, and memcmp.
We still use the name bzero (because there is no BSD equivalent for the gen-
eral case of memset) but it is translated to memset via a #define in
<X11/Xfuncs.h>.  The BSD function names are still supported in <X11/Xos.h>
and <X11/Xfuncs.h>.

Most client-side uses of caddr_t should now be gone from our sources.

Explicit declarations of errno are now only used on non-ANSI systems.

The libraries use more standard POSIX *_t types.

4.37.  Miscellaneous

A new version of the patch program is in xc/util/patch; it understands the
unified diff format produced by GNU diff.

5.  Filing Bug Reports

If you find a reproducible bug in software in the xc directory, or find bugs
in the xc documentation, please send a bug report to the X Consortium using
the form in the file xc/bug-report and this destination address:

     xbugs@x.org

Please try to provide all of the information requested on the form if it is
applicable; the little extra time you spend on the report will make it much
easier for us to reproduce, find, and fix the bug.  Receipt of bug reports
is generally acknowledged, but sometimes it can be delayed by a few weeks.

Bugs in contrib software should not be reported to the X Consortium.  Con-
sult the documentation for the individual software to see where (if any-
where) to report the bug.

6.  Public Fixes

We occasionally put out patches to X Consortium software, to fix any serious
problems that are discovered.  Such fixes (if any) can be found on ftp.x.org
in the directory pub/R6/fixes, or on your local X mirror site, using anony-
mous FTP.

For those without FTP access, individual fixes can be obtained by electronic
mail by sending a message to

     xstuff@x.org

In the usual case, the message should have a subject line and no body, or a
single-line body and no subject, in either case the line looking like:

     send fixes number

where number is a decimal number, starting from one.  To get a summary of
available fixes, make the line:

     index fixes

If you need help, make the line:

     help

Some mailers produce mail headers that are unusable for extracting return
addresses.  If you use such a mailer, you won't get any response.  If you
happen to know an explicit return path, you can include include one in the
body of your message, and the daemon will use it.  For example:

     path user%host.bitnet@mitvma.mit.edu

7.  Acknowledgements

Release 6 of X Version 11 is brought to you by X Consortium, Inc: Bob Schei-
fler, Janet O'Halloran, Ralph Swick, Matt Landau, Donna Converse, Stephen
Gildea, Jay Hersh, Kaleb Keithley, Ralph Mor, Dave Wiggins, and Gary Cut-
bill.

Many companies and individuals have cooperated and worked extremely hard to
make this release a reality, and our thanks go out to them.  You will find
many of them listed in the acknowledgements in the individual specifica-
tions.  Major implementation contributions come from Data General, Digital,
Fujitsu, HP, NCD, NCR, Omron, SGI, Sony, SunSoft, and XFree86.

Contributions were received from the follow people at various X Consortium
member companies.  Each X Window System release is the work of many, many
people, and this list is surely incomplete.

Fresco
     Mark Linton (Silicon Graphics); Chuck Price (SunSoft); Charles Brauer
     (Fujitsu); Steve Churchill (Fujitsu); Steve Tang (Stanford University);
     Douglas Pan (Fujitsu); Jean-Daniel Fekete (2001 S.A.)

Xlib
     Courtney Loomis (Hewlett-Packard Company); Daniel Dardailler (Open
     Software Foundation)

Xlib internationalization
     The manager of the internationalization project is Masahiko Narita
     (Fujitsu).  The principal authors of Input Method Protocol document are
     Hideki Hiura (SunSoft) and Masahiko Narita (Fujitsu).  The principal
     authors of Xlib specification Chapter 13 are Hideki Hiura (SunSoft) and
     Shigeru Yamada (Fujitsu OSSI).  The principal producers of the sample
     implementation of the internationalization facilities are Jeffrey

     Bloomfield (Fujitsu OSSI), Takashi Fujiwara (Fujitsu), Hideki Hiura
     (SunSoft), Yoshio Horiuchi (IBM), Makoto Inada (Digital), Hiromu Inukai
     (Nihon SunSoft), Song JaeKyung (KAIST), Riki Kawaguchi (Fujitsu),
     Franky Ling (Digital), Hiroyuki Miyamoto (Digital), Hidetoshi Tajima
     (HP), Toshimitsu Terazono (Fujitsu), Makoto Wakamatsu (Sony), Masaki
     Wakao (IBM), Shigeru Yamada (Fujitsu OSSI) and Katsuhisa Yano
     (Toshiba).  The coordinators of the integration, testing, and release
     of this implementation are Nobuyuki Tanaka (Sony) and Makoto Wakamatsu
     (Sony).  Others who have contributed on the architectural design or the
     testing of sample implementation are Hector Chan (Digital), Michael
     Kung (IBM), Joseph Kwok (Digital), Hiroyuki Machida (Sony), Nelson Ng
     (SunSoft), Frank Rojas (IBM), Yoshiyuki Segawa (Fujitsu OSSI), Makiko
     Shimamura (Fujitsu), Shoji Sugiyama (IBM), Lining Sun (SGI), Masaki
     Takeuchi (Sony), Jinsoo Yoon (KAIST) and Akiyasu Zen (HP).

Xt Intrinsics
     Douglas Rand (Open Software Foundation), parameterized selections; Paul
     Asente (Adobe Systems Incorporated), extension event handling; Ajay
     Vohra (SunSoft), support for multithreading; Sam Chang (Novell), widget
     caching research; Larry Cable (SunSoft), object allocation and change
     managed set; Vania Joloboff (Open Software Foundation); Courtney Loomis
     (Hewlett-Packard Company); Daniel Dardailler (Open Software Founda-
     tion); and Ellis Cohen (Open Software Foundation).  The following peo-
     ple at Georgia Tech contributed the extensions for disability access:
     Keith Edwards, Susan Liebeskind, Beth Mynatt, and Tom Rodriguez.

Athena Widget Set
     Frank Sheeran (Omron Data General)

X Logical Font Description
     Paul Asente (Adobe Systems Incorporated); Nathan Meyers (Hewlett-
     Packard Company); Jim Graham (Sun); Perry A. Caro (Adobe Systems Incor-
     porated)

Font Support Enhancments
     Nathan Meyers (Hewlett-Packard Company), implementation of matrix
     enhancement, glyph caching, scalable aliases, sample authorization pro-
     tocol

X Transport Library
     Stuart R. Anderson (AT&T Global Information Solutions)

X Keyboard Extension
     Erik Fortune (Silicon Graphics), design and sample implementation; Jor-
     dan Brown (Quarterdeck Office Systems); Will Walker (Digital Equipment
     Corporation), AccessX portion; Mark Novak (Trace Center), AccessX por-
     tion

Low-Bandwidth X
     Jim Fulton (Network Computing Devices); Dave Lemke (Network Computing
     Devices); Dale Tonogai (Network Computing Devices); Keith Packard (Net-
     work Computing Devices); Chris Kantarjiev (Xerox PARC)

X Image Extension
     Bob Shelley (AGE Logic), protocol architect, lead implementation archi-
     tect; Larry Hare (AGE Logic), server implementation; Dean Verheiden
     (AGE Logic), server implementation; Syd Logan (AGE Logic), xieperf;
     Gary Rogers (AGE Logic), JPEG code, XIElib documentation; Ben Fahy (AGE
     Logic), client and server implementation

ICCCM
     Stuart Marks (SunSoft); Gabe Beged-Dov (Hewlett-Packard Company); Chan
     Benson (Hewlett-Packard Company); Jordan Brown (Quarterdeck Office Sys-
     tems); Larry Cable (SunSoft); Ellis Cohen (Open Software Foundation);
     Brian Cripe (Hewlett-Packard Company); Susan Dahlberg (Silicon Graph-
     ics); Peter Daifuku (Silicon Graphics); Andrew deBlois (Open Software
     Foundation); Clive Feather (IXI); Christian Jacobi (Xerox PARC); Bill
     Janssen (Xerox PARC); Vania Joloboff (Open Software Foundation); Phil
     Karlton (Silicon Graphics); Mark Manasse (Digital Equipment Corpora-
     tion); Todd Newman (Silicon Graphics); Keith Taylor (Hewlett-Packard
     Company); Jim VanGilder (Digital Equipment Corporation); Mike Wexler
     (Kubota Pacific); Michael Yee (Apple Computer)

ICE
     Jordan Brown (Quarterdeck Office Systems); Vania Joloboff (Open Soft-
     ware Foundation); Stuart Marks (SunSoft)

XSMP
     Mike Wexler (Kubota Pacific); Jordan Brown (Quarterdeck Office Sys-
     tems); Ellis Cohen (Open Software Foundation); Vania Joloboff (Open
     Software Foundation); Stuart Marks (SunSoft)

SYNC Extension
     Tim Glauert (Olivetti Research Limited); Dave Carver (Digital Equipment
     Corporation); Jim Gettys (Digital Equipment Corporation); Pete Snider
     (Digital Equipment Corporation)

RECORD
     Martha Zimet (Network Computing Devices); Robert Chesler (Absol-puter);
     Kieron Drake (UniSoft); Marc Evans (Synergytics); Jim Fulton (Network
     Computing Devices); Ken Miller (Digital Equipment Corporation)

X Input Extension tests
     George Sachs (Hewlett-Packard Company)

PEX  Ken Garnett (Shographics); Cheryl Huntington (Sun Microsystems); Karl
     Schultz (IBM); Jeff Stevenson (Hewlett-Packard Company); Paula Womack
     (Digital Equipment Corporation)

Multi-Buffering Extension
     Eng-Shien Wu (IBM); John Marks (Hewlett-Packard Company); Ian Elliott
     (Hewlett-Packard Company)

X server
     Milind Pansare (SunSoft), pixmap privates; Peter Daifuku (SGI), layered
     window support; David Lister (Adobe Systems Incorporated), callback
     manager; Ken Whaley (Kubota Pacific), thin line pixelization; Joel

     McCormack (Digital Equipment Corporation), 64-bit mfb and cfb; Rob Lem-
     bree (Digital Equipment Corporation), 64-bit mfb and cfb; Davor Matic
     (MIT), xnest ddx; Nathan Meyers (Hewlett-Packard Company), font sup-
     port; Jordan Brown (Quarterdeck Office Systems), -config option;
     Michael Brenner (Apple Computer), macII ddx; Thomas Roell, svga ddx

Multi-Threaded X Server
     John A. Smith (while at Data General), team leader; H. Chiba (Omron),
     ddx; Akeio Harada (Omron), ddx; Mike Haynes (Data General), dix; Hide-
     nobu Kanaoka (Omron), ddx; Paul Layne (Data General), dix and ddx;
     Takayuki Miyake (Omron), ddx; Keith Packard (Network Computing
     Devices), design; Richard Potts (Data General), dix; Sid Manning (IBM),
     integration with core server; Rob Chesler (Absol-puter), integration
     with core server

xdm modular loadable greeter
     Peter Derr (Digital Equipment Corporation)

x11perf
     Joel McCormack (Digital Equipment Corporation); Graeme Gill (Labtam
     Australia); Mark Martin (CETIA)

config
     Stuart R. Anderson (AT&T Global Information Solutions); David Brooks
     (Open Software Foundation); Kendall Collett (Motorola); John Freeman
     (Cray); John Freitas (Digital Equipment Corporation); Patrick E. Kane
     (Motorola); Mark Kilgard (Silicon Graphics); Akira Kon (NEC); Masahiko
     Narita (Fujitsu); Paul Shearer (Sequent); Mark Snitily (SGCS)

XFree86 port
     Stuart R. Anderson (AT&T Global Information Solutions); Doug Anson;
     Gertjan Akkerman; Mike Bernson; David Dawes; Marc Evans; Pascal Haible;
     Matthieu Herrb; Dirk Hohndel; David Holland; Alan Hourihane; Jeffrey
     Hsu; Glenn Lai; Ted Lemon; Rich Murphey; Hans Nasten; Mark Snitily;
     Randy Terbush; Jon Tombs; Kees Verstoep; Paul Vixie; Mark Weaver; David
     Wexelblat; Philip Wheatley; Thomas Wolfram; Orest Zborowski

fonts
     Under xc/fonts/, the misc/ directory contains a family of fixed-width
     fonts from Dale Schumacher, several Kana fonts from Sony Corporation,
     two Hangul fonts from Daewoo Electronics, two Hebrew fonts from Joseph
     Friedman, two cursor fonts from Digital Equipment Corporation, and cur-
     sor and glyph fonts from Sun Microsystems.  The Speedo directory con-
     tains outline fonts contributed by Bitstream, Inc.  The 75dpi and
     100dpi directories contain bitmap fonts contributed by Adobe Systems,
     Inc., Digital Equipment Corporation, Bitstream, Inc., Bigelow and
     Holmes, and Sun Microsystems, Inc.