cde/historical/ReleaseNotes.sgm

   1 <!-- $XConsortium: ReleaseNotes.sgm /main/13 1996/12/23 17:14:32 dbrooks $ -->
   2 <!DOCTYPE BOOK PUBLIC "-//HaL and O'Reilly//DTD DocBook//EN" [
   3 <!ENTITY % ISOpublishing PUBLIC "ISO 8879-1986//ENTITIES Publishing//EN">
   4 %ISOpublishing;
   5 <!ENTITY % ISOnumeric PUBLIC "ISO 8879-1986//ENTITIES Numeric and Special Graphic//EN">
   6 %ISOnumeric;
   7 ]>
   8 <!-- (c) Copyright 1996 Digital Equipment Corporation. -->
   9 <!-- (c) Copyright 1996 Hewlett-Packard Company. -->
  10 <!-- (c) Copyright 1996 International Business Machines Corp. -->
  11 <!-- (c) Copyright 1996 Sun Microsystems, Inc. -->
  12 <!-- (c) Copyright 1996 Novell, Inc. -->
  13 <!-- (c) Copyright 1996 FUJITSU LIMITED. -->
  14 <!-- (c) Copyright 1996 Hitachi. -->
  15 <book>
  16 <title>CDE 2.1.0 Release Notes</title>
  17 <bookinfo>
  18 <bookbiblio>
  19 <authorgroup>
  20 <author><firstname> </firstname></author>
  21 </authorgroup>
  22 </bookbiblio>
  23 <legalnotice>
  24 <title>Legal Notices</title>
  25 <programlisting>&copy; Copyright 1993, 1994, 1995, 1996 Hewlett-Packard Company
  26 &copy; Copyright 1993, 1994, 1995, 1996 International Business Machines Corp.
  27 &copy; Copyright 1993, 1994, 1995, 1996 Sun Microsystems, Inc.
  28 &copy; Copyright 1993, 1994, 1995, 1996 Novell, Inc.
  29 &copy; Copyright 1995, 1996 Digital Equipment Corp.
  30 &copy; Copyright 1995, 1996 Fujitsu Limited
  31 &copy; Copyright 1995, 1996 Hitachi, Ltd.</programlisting>
  32 <para>ALL RIGHTS RESERVED</para>
  33 <para>All marks are trademarks or registered trademarks of their respective
  34 owners.</para>
  35 </legalnotice>
  36 </bookinfo>
  37 <chapter id=CDERelNotes>
  38 <title>CDE 2.1.0 Release Notes</title>
  39 <para><emphasis>December 1996</emphasis></para>
  40 <para>Legal Notices</para>
  41 <programlisting>&copy; Copyright 1993, 1994, 1995, 1996 Hewlett-Packard Company
  42 &copy; Copyright 1993, 1994, 1995, 1996 International Business Machines Corp.
  43 &copy; Copyright 1993, 1994, 1995, 1996 Sun Microsystems, Inc.
  44 &copy; Copyright 1993, 1994, 1995, 1996 Novell, Inc.
  45 &copy; Copyright 1995, 1996 Digital Equipment Corp.
  46 &copy; Copyright 1995, 1996 Fujitsu Limited
  47 &copy; Copyright 1995, 1996 Hitachi, Ltd.</programlisting>
  48 <para>ALL RIGHTS RESERVED</para>
  49 <para>All marks are trademarks or registered trademarks of their respective
  50 owners.</para>
  51 <sect1 id=chap1>
  52 <title>Introduction</title>
  53 <para>This document describes the Common Desktop Environment,
  54 CDE version 2.1.0 and Motif version 2.1.0.
  55 Wherever "CDE" is used in this document, it means CDE 2.1.0.
  56 Wherever "Motif" is used, it means Motif 2.1.0.
  57 </para>
  58 <para>The release of X11 provided with this CDE distribution is based on
  59 X11R6.2, which includes additional support for Vertical Writing,
  60 User-Defined Characters, and the X Print service.</para>
  61 <para>This document and accompanying text files contain important information.
  62 Please read them carefully before starting the build and installation procedures.
  63 </para>
  64 <para>The command line instructions provided here are for <command>csh</command>.
  65 They may vary depending on the particular shell you are using.</para>
  66 </sect1>
  67 <sect1 id=chap2>
  68 <title>Unloading the Distribution</title>
  69 <para>
  70 If you received this distribution on physical media (tape or CD)
  71 rather than electronically, the distribution includes
  72 appropriate instructions in hardcopy form.
  73 The hardcopy information pertains to your
  74 particular distribution format.</para>
  75 <para>The instructions in this document can be used for unloading from electronic
  76 distribution or tape.</para>
  77 <sect2 id=sect1>
  78 <title>Distribution Format</title>
  79 <para>The distribution consists of a single tape that contains nine tar files.
  80 These files contain the source code, test code, and documentation of CDE,
  81 Motif, and X11R6.2</para>
  82 <para>To unpack the distribution, create a directory to hold all of the sources
  83 and untar everything into that directory:</para>
  84 <programlisting>% mkdir $CDESOURCEDIR
  85 % cd $CDESOURCEDIR
  86 % tar xf tar-file-name-or-tape-device (nine times)</programlisting>
  87 <para>where $CDESOURCEDIR designates the CDE master source directory. If you
  88 are restoring from a tape, you should choose a device name that will not cause
  89 the tape to rewind between <command>tar</command> commands.</para>
  90 <para>The directories stored in the nine sections are:</para>
  91 <programlisting>$CDESOURCEDIR/cde and $CDESOURCEDIR/cde-contrib
  92 $CDESOURCEDIR/cde-test
  93 $CDESOURCEDIR/cde/doc
  94 $CDESOURCEDIR/motif
  95 $CDESOURCEDIR/motif/tests
  96 $CDESOURCEDIR/motif/doc
  97 $CDESOURCEDIR/x11/xc
  98 $CDESOURCEDIR/x11/xc/test
  99 $CDESOURCEDIR/x11/xc/doc</programlisting>
 100 <para>
 101 If you unpack the entire distribution, you will have the following
 102 five subdirectories under $CDESOURCEDIR:
 103 </para>
 104 <programlisting>cde
 105 cde-contrib
 106 cde-test
 107 motif
 108 x11</programlisting>
 109 <para>Note that directory permissions stored in the tar file are generally
 110 set world-writable. Make sure your <command>umask</command> is set the way
 111 you want before unpacking the distribution.</para>
 112 <para>The <filename>cde-contrib</filename> directory contains some unsupported
 113 contributed CDE software.</para>
 114 <para>The DocBook SGML source for these release notes can be found in the
 115 file <filename>$CDESOURCEDIR/cde/ReleaseNotes.sgm</filename>. The PostScript
 116 output can be found in <filename>$CDESOURCEDIR/cde/ReleaseNotes.ps</filename>.
 117 </para>
 118 </sect2>
 119 <sect2 id=sect2>
 120 <title>Disk Space Requirements</title>
 121 <para>The following amounts of disk space are required to unpack the various
 122 parts of the CDE distribution. All amounts are in MB.</para>
 123 <programlisting>cde, cde-contrib    93
 124 cde-test          1361
 125 cde/doc             91
 126 motif               19
 127 motif/tests         39
 128 motif/doc           15
 129 x11/xc              90
 130 x11/xc/test         13
 131 x11/xc/doc          39</programlisting>
 132 <para>Approximately 1Gb of additional disk space is required to build the
 133 release.</para>
 134 <para>Depending on the platform, approximately 140MB to 160MB of additional
 135 disk space is required to install the release (C locale only). Sample
 136 systems that were installed with several locales required between
 137 170MB and 230MB.</para>
 138 </sect2>
 139 </sect1>
 140 <sect1 id=chap3>
 141 <title>Building CDE</title>
 142 <para>This chapter provides a generic description of the build process for
 143 CDE. The x11, motif, and cde libraries and headers must be installed on your
 144 system prior to building cde-test. These libraries and headers
 145 are included in the CDE Distribution.
 146 </para>
 147 <para>CDE has been built on the following reference platforms:</para>
 148 <programlisting>Digital  AlphaStation 200   Digital UNIX V4.0
 149
 150 Fujitsu  DS/90 7000         UXP/DS V20L10
 151
 152 HP       HP9000/7xx         HP-UX 10.01
 153
 154 IBM      RS/6000            AIX 4.2
 155
 156 Novell   Intel 486/Pentium  UnixWare 2.02
 157
 158 Sun      SPARCstation       Solaris 2.4</programlisting>
 159 <para>For a detailed definition of the reference platforms, see
 160 "Reference Platforms."</para>
 161 <para>To build CDE, you must have an ANSI C compiler and a C++ compiler.
 162 You must also have <command>perl</command> version 4.0 or higher for all platforms
 163 (except SUN, which needs version 5.0 or higher). <command>perl</command>
 164 is publicly available via anonymous <command>ftp</command> at ftp.uu.net.
 165 <command>perl</command> must be installed on your system and available in your $PATH.
 166 You must not have <filename>/usr/ucb</filename> in your $PATH, or the build
 167 may fail.
 168 </para>
 169 <para>
 170 If you expect to build the distribution on more than one machine using
 171 a shared source tree, or if you just want to keep the binaries out of the
 172 source tree, you may want to use the X11 program <command>lndir</command>
 173 to create a symbolic link tree on each build machine. The links require additional
 174 disk space but take less disk space than multiple copies of the source tree.
 175 </para>
 176 <para>Create a build directory that is not a subdirectory of the CDE master
 177 source directory:</para>
 178 <programlisting>% mkdir $CDEBUILDDIR</programlisting>
 179 <para>Then, create a symbolic link tree:</para>
 180 <programlisting>% lndir $CDESOURCEDIR $CDEBUILDDIR</programlisting>
 181 <para>where $CDESOURCEDIR is the CDE master source directory. Note that the
 182 directory containing the <command>lndir</command> program must be in your
 183 $PATH.</para>
 184 <para>Note that the builds described below may not be done in parallel; each
 185 subsystem depends upon the results of builds in previous subsystems.</para>
 186 <sect2 id=sect3>
 187 <title>Building X11</title>
 188 <orderedlist>
 189 <listitem><para>Customize <filename>$CDEBUILDDIR/x11/xc/config/cf/site.def
 190 </filename> to reflect local preferences for install locations, compilers,
 191 paths, etc.</para>
 192 </listitem>
 193 <listitem><para>Federal law prohibits the X Consortium from shipping Data
 194 Encryption Standard (DES) source code outside the United States. If you
 195 have a copy of this source
 196 (<filename>x11/xc/lib/Xdmcp/Wraphelp.c</filename>) and wish to allow use of
 197 the <symbol>XDM-AUTHORIZATION-1</symbol> protocol, enable
 198 <symbol>HasXdmAuth</symbol> in your <filename>site.def</filename>
 199 file.</para>
 200 </listitem>
 201 <listitem><para>Set your current directory as follows:</para>
 202 <programlisting>% cd $CDEBUILDDIR/x11/xc</programlisting>
 203 </listitem>
 204 <listitem><para>See if there is a BootstrapCFlags mentioned in the comments
 205 in the <filename>&lt;vendor>.cf</filename> file. This file is in the directory <filename>
 206 $CDEBUILDDIR/x11/xc/config/cf</filename>, and the &lt;vendor> string identifies
 207 the platform on which you are building. If there isn't a definition for BootstrapCFlags,
 208 enter:</para>
 209 <programlisting>% make World >&amp; world.log</programlisting>
 210 <para>If there is a BootstrapCFlags definition, take its value and enter:</para>
 211 <programlisting>% make World BOOTSTRAPCFLAGS="value" >&amp; world.log</programlisting>
 212 </listitem>
 213 </orderedlist>
 214 </sect2>
 215 <sect2 id=sect4>
 216 <title>Building Motif</title>
 217 <orderedlist>
 218 <listitem><para>Customize <filename>$CDEBUILDDIR/motif/config/cf/site.def
 219 </filename> to reflect local preferences for install locations, compilers,
 220 paths, etc.</para>
 221 </listitem>
 222 <listitem><para>If you are building with imports (the default setup in <filename>
 223 site.def</filename>), construct the necessary links, as follows:</para>
 224 <programlisting>% cd $CDEBUILDDIR/motif
 225 % mkdir imports
 226 % cd imports
 227 % ln -s ../../x11/xc/exports x11</programlisting>
 228 </listitem>
 229 <listitem><para>Set your current directory as follows:</para>
 230 <programlisting>% cd $CDEBUILDDIR/motif</programlisting>
 231 </listitem>
 232 <listitem><para>See if there is a BootstrapCFlags mentioned in the comments
 233 in the <filename>&lt;vendor>.cf</filename> file. This file is in the directory <filename>
 234 $CDEBUILDDIR/motif/config/cf</filename>. If there isn't a definition for
 235 BootstrapCFlags, enter:</para>
 236 <programlisting>% make World >&amp; world.log</programlisting>
 237 <para>If there is a BootstrapCFlags definition, take its value and enter:</para>
 238 <programlisting>% make World BOOTSTRAPCFLAGS="value" >&amp; world.log</programlisting>
 239 </listitem>
 240 </orderedlist>
 241 </sect2>
 242 <sect2 id=sect5>
 243 <title>Building CDE</title>
 244 <orderedlist>
 245 <listitem><para>Customize <filename>$CDEBUILDDIR/cde/config/cf/site.def</filename>
 246 to reflect local preferences for install locations, compilers, paths, etc.
 247 </para>
 248 </listitem>
 249 <listitem><para>If you are building with imports (the default setup in <filename>
 250 site.def</filename>), construct the necessary links, as follows:</para>
 251 <programlisting>% cd $CDEBUILDDIR/cde
 252 % mkdir imports
 253 % cd imports
 254 % ln -s ../../motif/imports/x11 x11
 255 % ln -s ../../motif/exports motif</programlisting>
 256 </listitem>
 257 <listitem><para>Set your current directory as follows:</para>
 258 <programlisting>% cd $CDEBUILDDIR/motif</programlisting>
 259 </listitem>
 260 <listitem><para>See if there is a BootstrapCFlags mentioned in the comments
 261 in the <filename>&lt;vendor>.cf</filename> file. This file is in the directory <filename>
 262 $CDEBUILDDIR/cde/config/cf</filename>. If there isn't a definition for BootstrapCFlags,
 263 enter:</para>
 264 <programlisting>% make -k World >&amp; world.log</programlisting>
 265 <para>If there is a BootstrapCFlags definition, take its value and enter:</para>
 266 <programlisting>% make -k World BOOTSTRAPCFLAGS="value" >&amp; world.log</programlisting>
 267 </listitem>
 268 </orderedlist>
 269 <para>On Solaris, documents build with a large number of SGML errors that
 270 can be ignored, as a result of using <command>sgmls</command> rather than
 271 <command>nsgmls</command>.</para>
 272 </sect2>
 273 </sect1>
 274 <sect1 id=chap4>
 275 <title>Installing CDE</title>
 276 <para>CDE should be installed or re-installed in single-user mode.  It may
 277 not be sufficient merely to stop the CDE-related processes on a system that
 278 already has a CDE version installed.</para>
 279 <para>Before installing CDE, check to see if <filename>/usr/dt</filename>
 280 exists. If this directory or link already exists and you want a completely
 281 new installation (which is recommended), then rename it or back it up and
 282 then remove it.</para>
 283 <variablelist>
 284 <varlistentry><term>HP-UX only:</term>
 285 <listitem>
 286 <para>If CDE is running, use <command>init</command>(1M) to change the runlevel
 287 to a level that will stop <command>dtlogin</command> and other CDE processes (see <filename>
 288 /etc/inittab</filename> for more information). For example:</para>
 289 <programlisting>% /sbin/init 2</programlisting>
 290 </listitem>
 291 </varlistentry>
 292 <varlistentry><term>AIX only:</term>
 293 <listitem>
 294 <para>If "lslpp -h | grep X11.Dt" shows an AIX installation of CDE, use <command>
 295 smit</command> to remove the filesets. Otherwise, if a tar installation of
 296 CDE was made in <filename>/usr/dt</filename>, remove or rename it.</para>
 297 <para>If CDE is running, do the following to stop all of the CDE processes:
 298 </para>
 299 <orderedlist>
 300 <listitem><para>Kill all running <command>dtlogin</command> processes</para>
 301 </listitem>
 302 <listitem><para>Kill the X server</para>
 303 </listitem>
 304 </orderedlist>
 305 </listitem>
 306 </varlistentry>
 307 </variablelist>
 308 <para>The installation process creates directory hierarchies rooted at <filename>
 309 /etc/dt</filename> and <filename>/var/dt</filename>, but does not install
 310 any files there. Delete files in these directories with care. Important
 311 customizations made by applications are stored here, and this information
 312 may be "unrecoverable" if removed.</para>
 313 <sect2 id=sect6>
 314 <title>Installing X11</title>
 315 <para>To install X do the following as root:</para>
 316 <programlisting>% cd $CDEBUILDDIR/x11/xc
 317 % make install >&amp; install.log</programlisting>
 318 <para>You can install manual pages with:</para>
 319 <programlisting>% make install.man >&amp; man.log</programlisting>
 320 </sect2>
 321 <sect2 id=sect7>
 322 <title>Installing Motif</title>
 323 <para>To install Motif do the following as root:</para>
 324 <programlisting>% cd $CDEBUILDDIR/motif
 325 % make install.cde >&amp; install.log</programlisting>
 326 <para>Note this is NOT the same command used to install
 327 Motif without CDE.</para>
 328 </sect2>
 329 <sect2 id=sect8>
 330 <title>Installing CDE</title>
 331 <para>To install CDE do the following as root (since <command>inetd</command>
 332 is affected, you
 333 should do this at the console, rather than remotely):</para>
 334 <programlisting>% cd $CDEBUILDDIR/cde
 335 % ./admin/IntegTools/dbTools/installCDE -s $CDEBUILDDIR/cde</programlisting>
 336 <para>where $CDEBUILDDIR is the path to the directory where CDE was built.
 337 This installs CDE into <filename>/usr/dt/</filename>.</para>
 338 <para>
 339 You must reboot the system after installation.
 340 </para>
 341 <para>This script requires the user to have root permissions.</para>
 342 <para>To print the usage message for the script, run:</para>
 343 <programlisting>% installCDE '-?'</programlisting>
 344 <para>Note that many of the options for <command>installCDE</command> have not been
 345 tested.</para>
 346 <para>You must install into <filename>/usr/dt</filename>.
 347 You can use the <literal>-pI</literal> option to specify an alternative
 348 directory for the actual file storage, but <filename>/usr/dt</filename>
 349 will be created as a symbolic link to that directory because
 350 CDE will not operate without that link.
 351 </para>
 352 <para>To start CDE manually, run the following command as user root:</para>
 353 <programlisting>% /usr/dt/bin/dtlogin</programlisting>
 354 </sect2>
 355 <sect2 id=sect9>
 356 <title>Installing Localized Filesets</title>
 357 <para>After the base install of CDE, you can install localized filesets.
 358 Each locale has three filesets: message catalogs, resource and config files,
 359 and on-line help. The filesets for the C locale are installed by default.
 360 This section describes how to install filesets for supported locales other
 361 than C.
 362 </para>
 363 <para>To install the localized filesets for a locale, run
 364 <command>installCDE</command> as root as follows (the quotes are required):</para>
 365 <programlisting>% $CDEBUILDDIR/cde/admin/IntegTools/dbTools/installCDE \
 366         -s $CDEBUILDDIR/cde \
 367         -f "CDE-&lt;LOCALE> CDE-MSG-&lt;LOCALE> CDE-HELP-&lt;LOCALE>"</programlisting>
 368 <para>where "&lt;LOCALE>" is "DE" (German), "ES" (Spanish), "FR" (French),
 369 "IT" (Italian), or "JP" (Japanese). For example, to install Japanese filesets:
 370 </para>
 371 <programlisting>% $CDEBUILDDIR/cde/admin/IntegTools/dbTools/installCDE \
 372         -s $CDEBUILDDIR/cde \
 373         -f "CDE-JP CDE-MSG-JP CDE-HELP-JP"</programlisting>
 374 </sect2>
 375 <sect2 id=sect10>
 376 <title>Known Installation Problems</title>
 377 <para>Some known installation problems are listed below (additional information
 378 may be found in the files <filename>$CDESOURCEDIR/cde/OPENBUGS</filename>
 379 and <filename>$CDESOURCEDIR/motif/OPENBUGS</filename>):</para>
 380 <itemizedlist>
 381 <listitem><para>This problem occurs on Digital only.</para>
 382 <para>Deconfiguration will attempt to undo the installation operations. If
 383 it fails or needs to be undone manually, you can restore the non-CDE login
 384 with:</para>
 385 <programlisting># ln -f -s ../init.d/xdm /sbin/rc3.d/S95xdm</programlisting>
 386 <para>Rebooting will return the workstation to xdm mode.</para>
 387 </listitem>
 388 <listitem><para>If the Japanese filesets are installed, several files are reported as missing
 389 during the installation process. The Japanese translations of some
 390 documents are not part of the initial release of CDE 2.1.  This is not
 391 harmful to the installation.</para>
 392 </listitem>
 393 <listitem><para>On Solaris, the file
 394 <filename>/proj/cde/programs/nsgmls/nsgmls</filename> is reported as
 395 missing. This is expected.</para></listitem>
 396 </itemizedlist>
 397 </sect2>
 398 </sect1>
 399 <sect1 id=chap5>
 400 <title>X Print Services</title>
 401 <para>To print with CDE, a print server must be running, and the proper name
 402 of the server must be supplied to client applications.</para>
 403 <para>In addition, to enable users to select a printer setup dialog
 404 from within client applications, a print dialog manager (dtpdm) daemon
 405 must be running.</para>
 406 <sect2 id=sect11>
 407 <title>Running an X Print Server</title>
 408 <para>Running an X Print Server is identical to running any other X server.
 409 </para>
 410 <para>Here is a sample command line for use with a typical configuration:
 411 </para>
 412 <programlisting>% Xprt :1 -ac -fp /usr/lib/X11/fonts/misc,\
 413 /usr/lib/X11/fonts/Type1,/usr/lib/X11/fonts/100dpi,\
 414 /usr/dt/config/xfonts</programlisting>
 415 <para>
 416 The following options are available when running the print server:
 417 </para>
 418 <variablelist>
 419 <varlistentry><term>:1</term>
 420 <listitem>
 421 <para>
 422 Use a different display from the default.
 423 </para>
 424 </listitem>
 425 </varlistentry>
 426 <varlistentry><term>-ac</term>
 427 <listitem>
 428 <para>
 429 Disable access control, since no simple mechanism
 430 for sharing keys is provided.
 431 </para>
 432 </listitem>
 433 </varlistentry>
 434 <varlistentry><term>-fp</term>
 435 <listitem>
 436 <para>
 437 Point to the standard video fonts. Note that the only reason
 438 for doing this is to add the CDE aliases to the default set.
 439 </para>
 440 </listitem>
 441 </varlistentry>
 442 </variablelist>
 443 <para>
 444 In addition, the following new arguments are available:
 445 </para>
 446 <variablelist>
 447 <varlistentry><term>-XpFile</term>
 448 <listitem>
 449 <para>
 450 Points to file listing of available printers instead
 451 of default.
 452 </para>
 453 </listitem>
 454 </varlistentry>
 455 <varlistentry><term>XPCONFIGDIR</term>
 456 <listitem>
 457 <para>
 458 Environment variable specifying alternative location of
 459 configuration files.
 460 </para>
 461 </listitem>
 462 </varlistentry>
 463 </variablelist>
 464 <para>The server can be run within a user's session as an individual
 465 command or at boot time. These two methods of invocation
 466 represent two distinct styles. The latter style provides a centralized
 467 departmental service, while the former style usually serves a single
 468 user. However, because an X print server is no different from any other
 469 X server, there are many other configuration possibilities available.
 470 </para>
 471 </sect2>
 472 <sect2 id=sect12>
 473 <title>Informing Clients</title>
 474 <para>To select an X Print Server from a client that employs the Xprint server,
 475 simply type the name of the printer like this:</para>
 476 <programlisting>printerName@host:display</programlisting>
 477 <para>
 478 A default printer can be specified by providing a value for either the
 479 XpPrinter resource or the <systemitem class="environvar">XPRINTER</systemitem>
 480 environment variable.
 481 </para>
 482 <para>
 483 An alternative, and probably the simplest, way to provide an entire
 484 set of printers to all clients is to set the
 485 <systemitem class="environvar">XPSERVERLIST</systemitem> variable (or XpServerList
 486 resource) to the name of a X Print Server (for example, print_host:1). The
 487 user's default value of <systemitem class="environvar">LPDEST</systemitem>
 488 will be combined with the defined value to create a full printer name, allowing
 489 the user to use the GUI on the print setup box dialog to access other printers.
 490 </para>
 491 <para>
 492 You can set all of the above environment variables in the
 493 <filename>.dtprofile</filename> file in a user's home directory.
 494 </para>
 495 </sect2>
 496 <sect2 id=sect12point1>
 497 <title>Print Dialog Manager</title>
 498 <para>In order for users to access the print setup dialogs, a special
 499 client called the Print Dialog Manager must be running. The name of
 500 the daemon that implements the Print Dialog Manager is
 501 <command>dtpdmd</command>. You can invoke <command>dtpdmd</command>
 502 in either of two ways:
 503 </para>
 504 <itemizedlist>
 505 <listitem><para>
 506 Point it at a print server, as follows:
 507 </para>
 508 <programlisting>dtpdmd -d print_host:1 &</programlisting>
 509 </listitem>
 510 <listitem>
 511 <para>
 512 Point it at your video display, as follows:
 513 </para>
 514 <programlisting>dtpdmd &</programlisting>
 515 <para>Note that in this case, the environment variable
 516 <systemitem class="environvar">XPDMDISPLAY</systemitem>
 517 must be set to the value <literal>video</literal>.
 518 </para>
 519 </listitem>
 520 </itemizedlist>
 521 <para>
 522 You can apply either of these methods using the
 523 <filename>.dtprofile</filename> file in
 524 the user's home directory.
 525 </para>
 526 </sect2>
 527 </sect1>
 528 <sect1 id=chap6>
 529 <title>Documentation</title>
 530 <para>The documentation available with this release consists of:
 531 </para>
 532 <itemizedlist>
 533 <listitem><para>CDE and Motif man pages</para>
 534 </listitem>
 535 <listitem><para>CDE and Motif guides</para>
 536 </listitem>
 537 <listitem><para>CDE online help</para>
 538 </listitem>
 539 </itemizedlist>
 540 <sect2 id=sect13>
 541 <title>Man Pages</title>
 542 <para>This release provides English versions of the CDE and Motif man
 543 pages in traditional man format. The man pages are generated
 544 from DocBook source during the build process. Man pages are also
 545 viewable online with <command>dtinfo</command> using the English CDE information library.</para>
 546 </sect2>
 547 <sect2 id=sect14>
 548 <title>Guides</title>
 549 <para>The guides provided with this release include:</para>
 550 <itemizedlist>
 551 <listitem><para>English CDE guides, which have been converted to DocBook.
 552 These guides are viewable online with <command>dtinfo</command> using the English CDE
 553 information library. The DocBook source is located in
 554 <filename>$CDEBUILDDIR/cde/doc/C/guides</filename>. New volumes in this
 555 release are the <citetitle>Information Manager User's Guide</citetitle>,
 556 <citetitle>Information System Author's and Programmer's Guide</citetitle>, and
 557 <citetitle>Guide to the DocBook DTD</citetitle>.
 558 </para>
 559 </listitem>
 560 <listitem><para>English Motif guides, which have been converted to DocBook.
 561 These guides are viewable online with <command>dtinfo</command> using the
 562 English CDE information library. The DocBook source is located in
 563 <filename>$CDEBUILDDIR/motif/doc/C/guides</filename>.</para>
 564 <para>With this release, the Motif and CDE style guides have been combined
 565 and reworked into three new volumes:
 566 <citetitle>Motif and CDE Style Guide</citetitle>,
 567 <citetitle>Motif and CDE Style Guide Reference</citetitle>, and
 568 <citetitle>Motif and CDE Style Guide Certification Checklist</citetitle>.
 569 </para>
 570 </listitem>
 571 <listitem><para>Translations of selected CDE and Motif guides, which have
 572 been converted to DocBook. The CDE
 573 <citetitle>User's Guide</citetitle>,
 574 <citetitle>Information Manager User's Guide</citetitle>, and
 575 <citetitle>Advanced User's and System Administrator's Guide</citetitle>
 576 are available in all languages.
 577 Additional guides are available in Japanese.
 578 These guides are viewable online with dtinfo
 579 using the localized CDE information library.
 580 The DocBook source is located in
 581 <filename>$CDEBUILDDIR/cde/doc/LANG/guides</filename>, where LANG
 582 corresponds to one of the following locales:</para>
 583 <simplelist>
 584 <member>de_DE.ISO8859-1 (German)</member>
 585 <member>es_ES.ISO8859-1 (Spanish)</member>
 586 <member>fr_FR.ISO8859-1 (French)</member>
 587 <member>it_IT.ISO8859-1 (Italian)</member>
 588 <member>ja_JP.dt-eucJP (Japanese)</member>
 589 </simplelist></listitem>
 590 </itemizedlist>
 591 </sect2>
 592 <sect2 id=sect15>
 593 <title>Online Help</title>
 594 <para>This release contains complete English and translated CDE online
 595 help, which has been converted to DocBook. The online help is viewable with
 596 the Help Manager. New material includes online help for dtinfo and for
 597 printing. The English online help source can be found in
 598 <filename>$CDEBUILDDIR/cde/doc/C/help</filename>.
 599 The translated online help can be found in
 600 <filename>$CDEBUILDDIR/cde/doc/LANG/help</filename>,
 601 where LANG corresponds to the locales listed in the "Guides"
 602 section.</para>
 603 </sect2>
 604 </sect1>
 605 <sect1 id=chap7>
 606 <title>Building Tests</title>
 607 <para>This chapter provides a generic description of the build process for
 608 the CDE Test Suite.</para>
 609 <para>You must build and install CDE (including X11 and Motif) on your system
 610 prior to building these tests. Also, the actual CDE build tree must still
 611 be accessible.</para>
 612 <para>The CDE test suite has been built on the following reference platforms:
 613 </para>
 614 <programlisting>Digital  AlphaStation 200   Digital UNIX V4.0
 615
 616 Fujitsu  DS/90 7000         UXP/DS V20L10
 617
 618 HP       HP9000/7xx         HP-UX 10.01
 619
 620 IBM      RS/6000            AIX 4.2
 621
 622 Novell   Intel 486/Pentium  UnixWare 2.02
 623
 624 Sun      SPARCstation       Solaris 2.4</programlisting>
 625 <para>For a detailed definition of the reference platforms, see
 626 "Reference Platforms."</para>
 627 <sect2 id=sect16>
 628 <title>Configure the CDE Test Suite Build Environment</title>
 629 <para>Before building, you must make sure that symbolic links for the <filename>
 630 OSVersion.tmpl</filename> and the <filename>localtree.tmpl</filename> files
 631 are created and that these links are correct for your system. You must also
 632 modify the <filename>site.cf</filename> file. You can not skip this step,
 633 even though you have built CDE for your system, because the config directory for
 634 the CDE Test Suite is separate from the CDE build directory.</para>
 635 <para>Builds have been performed using the optimized shared library templates
 636 for <filename>localtree.tmpl</filename>.</para>
 637 <para>To create the links, go to the CDE Test config directory in the build
 638 directory:</para>
 639 <programlisting>cd $CDEBUILDDIR/cde-test/config</programlisting>
 640 <para>Make sure that cdesrcRoot is defined to point to <filename>$CDEBUILDDIR/cde
 641 </filename> in the file <filename>site.cf</filename>. For example, if $CDEBUILDDIR
 642 is <filename>/proj</filename>, the following lines should appear in the file
 643 (do not use environment variables here):</para>
 644 <programlisting>#ifndef cdesrcRoot
 645 #define cdesrcRoot /proj/cde
 646 #endif</programlisting>
 647 <para>Create the correct links for your system. For example, if your system
 648 is HP-UX 10.01 you will need to execute the following commands to create these
 649 links:</para>
 650 <programlisting>% ln -s OSVersiontemplates/10.01 OSVersion.tmpl
 651 % ln -s localtemplates/hpux/10.01/optimized.shared localtree.tmpl</programlisting>
 652 <para>The following are the correct links for the other platforms:</para>
 653 <variablelist>
 654 <varlistentry><term>Digital Unix 4.0</term>
 655 <listitem>
 656 <programlisting>OSVersion.tmpl -> OSVersiontemplates/4.0
 657 localtree.tmpl -> localtemplates/dec/alpha/osf/optimized.sharedlibs</programlisting>
 658 </listitem>
 659 </varlistentry>
 660 <varlistentry><term>Fujitsu UXP/DS V20L10</term>
 661 <listitem>
 662 <programlisting>OSVersion.tmpl -> OSVersiontemplates/20.10
 663 localtree.tmpl -> localtemplates/uxp/optimized.sharedlibs</programlisting>
 664 </listitem>
 665 </varlistentry>
 666 <varlistentry><term>IBM AIX 4.2</term>
 667 <listitem>
 668 <programlisting>OSVersion.tmpl -> OSVersiontemplates/4.2
 669 localtree.tmpl -> localtemplates/ibm/rs6000/aix4.2/optimized.sharedlibs</programlisting>
 670 </listitem>
 671 </varlistentry>
 672 <varlistentry><term>Sun Solaris 2.4</term>
 673 <listitem>
 674 <programlisting>OSVersion.tmpl -> OSVersiontemplates/5.4
 675 localtree.tmpl -> localtemplates/sun/optimized.sharedlibs</programlisting>
 676 </listitem>
 677 </varlistentry>
 678 <varlistentry><term>UNIXWARE</term>
 679 <listitem>
 680 <programlisting>OSVersion.tmpl -> OSVersiontemplates/4.2
 681 localtree.tmpl -> localtemplates/sun/optimized.sharedlibs</programlisting>
 682 </listitem>
 683 </varlistentry>
 684 </variablelist>
 685 </sect2>
 686 <sect2 id=sect17>
 687 <title>Building the CDE Test Suites</title>
 688 <para>Change to the directory containing the
 689 <command>test_build</command> program:</para>
 690 <programlisting>% cd $CDEBUILDDIR/cde-test/admin/BuildTools/master_build</programlisting>
 691 <para>Run <command>test_build</command> to build the CDE Test Suite on your
 692 system:</para>
 693 <programlisting>% ./test_build -build $CDEBUILDDIR/cde-test \
 694         -log $CDEBUILDDIR/cde-test/logs -c</programlisting>
 695 <para>
 696 The <command>test_build</command> command makes the Makefiles, includes,
 697 depend, and all targets in the specified build directory and creates build
 698 logs in the specified log directory. For a more complete description of the <command>
 699 test_build</command> options, see the <command>master_build</command>.1 man
 700 page in <filename>$CDEBUILDDIR/cde/admin/man/man1</filename> (<command>test_build
 701 </command> and <command>master_build</command> support the same set of options).
 702 </para>
 703 </sect2>
 704 </sect1>
 705 <sect1 id=chap8>
 706 <title>Installing Tests</title>
 707 <para>Test execution is fully functional inside the cde-test directory structure.
 708 No installation is required.</para>
 709 </sect1>
 710 <sect1 id=chap9>
 711 <title>Running Tests</title>
 712 <para>The following sections give basic instructions for executing the various
 713 testing protocols and information on test results.</para>
 714 <sect2 id=sect18>
 715 <title>Test Execution</title>
 716 <sect3>
 717 <title>Automated Regression Tests</title>
 718 <para>The test execution cycle is divided into five phases based on
 719 dependencies.
 720 The phases are listed below in order of execution. The cycle outlined
 721 here
 722 is intended to accommodate the testing of multiple test suites
 723 automatically.</para>
 724 <orderedlist>
 725 <listitem><para>Configure test environment.</para>
 726 <para>The test environment requires a complete installation of CDE, a
 727 complete
 728 test build that includes TET, and a default user environment with the
 729 following
 730 X resources set:</para>
 731 <programlisting>*enableButtonTab: False
 732 *blinkRate: 0
 733 dtterm*blinkRate: 250</programlisting>
 734 <para>The tests can be run either from the test display itself or from a
 735 remote
 736 display. The following environment variables must be set:</para>
 737 <programlisting>TET_ROOT=$CDEBUILDDIR/cde-test
 738 TET_TMP_DIR=&lt;temporary space dir>
 739 DISPLAY=&lt;test display>
 740 PATH=$PATH:.</programlisting>
 741 <para>Then, general configuration data must be loaded:</para>
 742 <programlisting>$ . $TET_ROOT/DTConfig/`uname -s`/dt_env.sh -l</programlisting>
 743 </listitem>
 744 <listitem><para>Configure the component-specific test environment.</para>
 745 <para>Component-specific test environment configuration is set
 746 by:</para>
 747 <programlisting>$ cd $TET_ROOT/comp_suites/&lt;test suite name>
 748 $ . config/`uname -s`/env.sh -l</programlisting>
 749 <para>where &lt;test suite name> corresponds to the directory under
 750 <filename>$TET_ROOT/comp_suites</filename> for a CDE component
 751 (for example, dtfile, DtSvc/dragdrop, dthelp/dtHelpApi).
 752 </para>
 753 <para>Some test suites require additional setup that will have to be
 754 done
 755 manually. The instructions for additional setup (if any) can
 756 be found in</para>
 757 <programlisting>$TET_ROOT/comp_suites/&lt;test suite name>/README[.test suite name]
 758 </programlisting>
 759 </listitem>
 760 <listitem><para>Execute test suite.</para>
 761 <para>Tests are organized under "scenarios" (e.g. REGRESSION, all,
 762 TOUCH)
 763 which are listed in the file</para>
 764 <programlisting>$TET_ROOT/comp_suites/&lt;test suite name>/tet_scen</programlisting>
 765 <para>The tests are run through TET's <command>tcc</command> (test case
 766 controller):
 767 </para>
 768 <programlisting>$ tcc -i &lt;output dir> -j &lt;journal file> \
 769       -e comp_suites/&lt;test suite name> &lt;scenario></programlisting>
 770 <para>where &lt;journal file> is the path name of the file where test
 771 journal reports and results are stored. Any test data for inspection
 772 (for example, images) is stored under &lt;output dir>.</para>
 773 </listitem>
 774 <listitem><para>Clean up test suite.</para>
 775 <para>Component-specific test environment configuration cleanup is
 776 accomplished
 777 by:</para>
 778 <programlisting>$ cd $TET_ROOT/comp_suites/&lt;test suite name>
 779 $ . config/`uname -s`/env.sh -c</programlisting>
 780 </listitem>
 781 <listitem><para>Clean up general test environment.</para>
 782 <para>General test environment configuration cleanup is accomplished
 783 by:</para>
 784 <programlisting>$ . $TET_ROOT/DTConfig/`uname -s`/dt_env.sh -c</programlisting>
 785 </listitem>
 786 </orderedlist>
 787 <para>Alternatively, the test execution script <command>testCDE</command>,
 788 available in <filename>$TET_ROOT/bin</filename>, can be used. Usage of the
 789 script is:</para>
 790 <programlisting>$ $TET_ROOT/bin/testCDE -tet_root $CDEBUILDDIR/cde-test \
 791        { -suite &lt;test suite name&gt; | -list &lt;file with list of suites&gt; }
 792        [ -scen &lt;test scenario&gt; ] \
 793        [ -engr &lt;email address to notify&gt; ] \
 794        [ -record ]
 795        [ -res &lt;directory path name&gt; ]
 796 </programlisting>
 797 <para>The -record option is used to execute relevant suites in record mode (to
 798 generate golden data). The -res option is used to specify
 799 an alternative results directory (<filename>$HOME/test-results</filename> is the default).
 800 When the scenario is not specified using the -scen option, the REGRESSION
 801 scenario is selected by default.</para>
 802 <para>In addition to performing the configuration setup, test execution,
 803 and configuration cleanup steps (listed above for the first method of
 804 running tests), this script utilizes setup scripts (if any) found under
 805 <filename>$TET_ROOT/setup/&lt;test suite name&gt;</filename>. These setup scripts automate
 806 additional manual setup required for some test suites.
 807 </para>
 808 <Note>
 809 <Para>
 810 In many cases these setup scripts use site specific data such as user-ids.
 811 Make sure the site-specific data is updated before test execution.
 812 </Para>
 813 </Note>
 814 </sect3>
 815 <sect3>
 816 <title>Manual Regression Tests</title>
 817 <para>The following CDE components have predefined manual tests, with instructions
 818 located in the specified files. Some suites have a number of instruction
 819 files, indicated below with appropriate wildcards.</para>
 820 <programlisting> Suite             |  File (relative to $CDEBUILDDIR/)
 821  --------------------------------------------------------------------
 822  DefConfig         | cde-test/comp_suites/DefConfig/manual/*_tests
 823  DtSvc/DtMsgLog    | cde-test/comp_suites/DtSvc/DtMsgLog/manual/manualtests
 824  DtSvc/DtWsm       | cde-test/comp_suites/DtSvc/DtWsm/manual/ws*
 825  DtSvc/dragdrop    | cde-test/comp_suites/DtSvc/dragdrop/manual/assertion_misctest
 826  DtSvc/visuals     | cde-test/comp_suites/DtSvc/visuals/manual/icons
 827  RunTime           | cde-test/comp_suites/RunTime/manual/runtime*.des
 828  dtaction          | cde-test/comp_suites/dtaction/manual/test.checklist
 829  dtappgather       | cde-test/comp_suites/dtappgather/manual/README
 830  dtbuilder         | cde-test/comp_suites/dtbuilder/manual/Instructions
 831  dtcalc            | cde-test/comp_suites/dtcalc/manual/*/*
 832  dtcm              | cde-test/comp_suites/dtcm/manual/assertions.all
 833  dtfp              | cde-test/comp_suites/dtwm/fptests/manual/*/README
 834  dthelp            | cde-test/comp_suites/dthelp/manual/DtHelpManualTest.mif
 835  dthelp/CREInline  | cde-test/comp_suites/dthelp/manual/CREInline/README
 836  dtinfo            | cde-test/comp_suites/dtinfo/manual/README
 837  dtlp              | cde-test/comp_suites/dtlp/manual/README
 838  dtmail            | cde-test/comp_suites/dtmail/manual/Assertions.manual
 839  dtpad             | cde-test/comp_suites/dtpad/manual/dtpad.manual_checklist
 840  dtterm            | cde-test/comp_suites/dtterm/manual/manual
 841  dtwm              | cde-test/comp_suites/dtwm/wmtests/manual/*/README</programlisting>
 842 <para>For each suite, simply following the instructions listed in the specified
 843 files. Any suite-specific instructional information is listed below.</para>
 844 <variablelist>
 845 <varlistentry><term>dthelp</term>
 846 <listitem>
 847 <para>This file is in FrameMaker format.</para>
 848 </listitem>
 849 </varlistentry>
 850 <varlistentry><term>dtmail</term>
 851 <listitem>
 852 <para>There are two other files in the same directory called <filename>Mailer.assertion
 853 </filename> and <filename>README</filename>, the latter of which explains
 854 which file should be used.</para>
 855 </listitem>
 856 </varlistentry>
 857 </variablelist>
 858 </sect3>
 859 <sect3>
 860 <title>Motif Quality Assurance Test Suite Testing</title>
 861 <para>Most of the information required to build and run the CDE/QATS can be
 862 found in the following files:</para>
 863 <programlisting>$CDEBUILDDIR/motif/tests/docs/Output/draft/ps/chap1
 864 $CDEBUILDDIR/motif/tests/docs/Output/draft/ps/chap2
 865 $CDEBUILDDIR/motif/tests/docs/Output/draft/ps/chap3
 866 $CDEBUILDDIR/motif/tests/docs/Output/draft/ps/chap4
 867 $CDEBUILDDIR/motif/tests/environment/README</programlisting>
 868 <para>While these documents describe the original OSF test suite, they are
 869 applicable with some minor modifications to CDE.</para>
 870 <itemizedlist>
 871 <listitem><para>The following environment variables need to be set for running
 872 in playback mode:</para>
 873 <itemizedlist>
 874 <listitem><para><systemitem class="environvar">VFA_TOP</systemitem> to the
 875 top of the Motif tree (<filename>$CDEBUILDDIR/motif</filename>)</para>
 876 </listitem>
 877 <listitem><para><systemitem class="environvar">VISUAL_PATH</systemitem> to
 878 the parent of the directories containing the recorded images</para>
 879 </listitem>
 880 <listitem><para><systemitem class="environvar">VFA_RESULTS_DIR</systemitem>
 881 to the parent of the output directories (the directories must exist)</para>
 882 </listitem>
 883 </itemizedlist>
 884 </listitem>
 885 <listitem><para>You can run the automated test suite from the top of the test
 886 tree by invoking the RUN_auto located in <filename>$CDEBUILDDIR/motif/tests
 887 </filename>.</para>
 888 </listitem>
 889 <listitem><para>When recording, the <systemitem class="environvar">VISUAL_PATH
 890 </systemitem> and <systemitem class="environvar">VFA_RESULTS_DIR</systemitem>
 891 should be the same.</para>
 892 </listitem>
 893 </itemizedlist>
 894 <para>The QATS must be run on a display controlled by a Motif 2.x version
 895 of <command>mwm</command>, not <command>dtwm</command>. A suitable version
 896 of <command>mwm</command> is built in the
 897 <filename>$CDEBUILDDIR/motif/clients/mwm</filename> directory.</para>
 898 </sect3>
 899 <sect3>
 900 <title>Interplatform Tests</title>
 901 <para>Interplatform testing is the testing of CDE application functionality
 902 between platforms. The following CDE capabilities are tested:</para>
 903 <itemizedlist>
 904 <listitem><para>The ability of CDE applications to execute and interoperate
 905 in distributed fashion across a network of heterogeneous, interoperating
 906 hosts.</para>
 907 </listitem>
 908 <listitem><para>The ability of CDE users to execute the desktop on
 909 different heterogenous platforms in a consistent manner.</para>
 910 </listitem>
 911 </itemizedlist>
 912 <para>The general process used in the Interplatform tests is to startup CDE
 913 components from a client host and a daemon host (on the same display) using
 914 <command>dtaction</command> before running actual tests involving drag and drop on/between
 915 these components.</para>
 916 <para>The tests are located in
 917 <filename>$CDEBUILDDIR/cde-test/sys_suites/Intop/</filename>:
 918 The information required to initially configure the test systems before a test run
 919 is in the following files in the same directory:</para>
 920 <itemizedlist>
 921 <listitem><para><filename>HowToRun.interplatform</filename></para></listitem>
 922 <listitem><para><filename>README.interplatform</filename></para></listitem>
 923 <listitem><para><filename>README</filename></para></listitem>
 924 </itemizedlist>
 925 <para>The information in these files includes steps to configure the test
 926 machines to use the dtspc protocol, which is required by the tests.</para>
 927 <para>Once the test machines have been correctly setup, the tests can be
 928 executed in
 929 a similar fashion to other CDE tests described earlier in this document,
 930 with the exception that these tests are located in the
 931 <filename>sys_suites</filename> rather
 932 than the <filename>comp_suites</filename> sub-directory and so the
 933 pathnames will have to be correspondingly altered.</para>
 934 </sect3>
 935 </sect2>
 936 <sect2 id=sect19>
 937 <title>Test Execution Results</title>
 938 <para>The following sections give details on the results obtained with the
 939 various test protocols on the reference platforms.</para>
 940 <sect3>
 941 <title>Automated Regression Tests</title>
 942 <para>The following is a partial list of expected results for the six tested
 943 platforms. The first number indicates the number of passes for the given
 944 test suite
 945 and the second number indicates the total number of assertions that were
 946 run in that test suite.</para>
 947 <para>Note that not all results are available on all platforms. Defect reports
 948 have been submitted as appropriate for non-passes.</para>
 949 <?Pub _newpage>
 950 <programlisting>Suite                   IBM      Sun      Digital  HP       Fujitsu  Unixware
 951 =============================================================================
 952 CREPrinting             3/7      5/7      3/7      6/7      3/7      6/7
 953 ConfigDB                0/1      1/1      0/1      1/1      1/1      0/1
 954 DefConfig               3/5      3/16     3/23     3/4      2/28     3/4
 955 Desktop                          55/57    55/57    55/57    56/57    38/51
 956 DevEnv                  1/2      1/3      0/0      2/3      0/0      1/3
 957 DtAction                97/109   63/77    70/96    103/125  101/117  43/47
 958 DtClientPrinting_dtcm            13/26    13/26    13/26    14/26    13/26
 959 DtClientPrinting_dtmail          21/28    21/28    20/24    22/25    17/26
 960 DtClientPrinting_dtpad           12/14    11/14    12/14    9/10     12/14
 961 DtEditor                32/35    41/42    35/42    41/42    17/40    30/35
 962 DtHelp                  0/0               0/0                        0/6
 963 DtInit                  8/8      8/8      8/8      8/8      8/8      8/8
 964 DtMrm                   8/8      8/33                                2/6
 965 DtMsgLog                29/37    27/37    26/35    28/37    31/37    27/35
 966 DtSvc                   12/23    0/43     0/2                        0/43
 967 DtTerm                  1/3      0/7                                 0/8
 968 DtWidget                98/113   113/113  113/113  113/113  98/113   113/113
 969 DtWsm                   9/9      9/9      8/11     9/9      9/9      9/11
 970 Intop                   158/233
 971 Dtinfo printing                  19/32    18/32    19/32    3/12     18/27
 972 XmMT                    142/148  138/141  49/50                      83/85
 973 XmPrinting              15/22    16/22    17/22    17/22    7/7      17/22
 974 dragdrop                8/18     12/18    8/18     18/18    11/18    14/18
 975 dtGui                   17/34    21/34    15/21    22/34    0/15     0/21
 976 dtHelpApi               5/104    92/104   67/75    76/104   0/59     77/104
 977 dtHelpCanvas            1/2      2/2      1/2      1/2      2/2      2/2
 978 dtHelpGui               52/100   103/126  27/100   58/126   57/82    51/126
 979 dtPdm                   1/3      1/5      3/5      1/5      3/5      0/5
 980 dtaction                34/36    35/36    33/36    31/36    33/36    32/36
 981 dtappgather             0/4      4/4      4/4      4/4      3/4      3/4
 982 dtappintegrate          16/17    16/17    13/17    17/17    7/17     17/17
 983 dtcalc                  1/2      1/3      1/2      1/2      1/3      1/3
 984 dtcm                                               2/126
 985 dtdatatyping            21/27    21/27    18/27    21/27    21/27    18/27
 986 dtdocbook               0/3      2/4      2/4      2/4      2/4      2/4
 987 dtfile                  10/228   82/229   30/123   8/226    9/218    6/77
 988 dtfp                    17/23    20/21    2/21     10/21    7/13     15/20
 989 dthelpgen               18/23    20/23    20/23    0/19     19/23    13/19
 990 dthelpprint             2/10     2/10     6/10     0/10     7/10     7/10
 991 dthelptag               9/9      4/9      9/9      4/9      7/9      9/9
 992 dthelpview              20/42    29/42    42/42    33/42    32/42    33/42
 993 dtksh                   43/302   285/302  288/302  285/302  297/302  200/302
 994 dtlp                    13/14    13/14    12/14    13/14    12/14    12/14
 995 dtmail                  60/78    61/82    61/77    67/78    71/78    65/77
 996 dtpad                   128/190  141/157  139/157  141/157  128/145  138/153
 997 dtscreen                49/55    53/55    31/51    53/55    49/55    49/55
 998 dtsearchpath            26/26    26/26    24/26    26/26    0/26     24/26
 999 dtsession               39/40    39/40    41/41    40/41    40/41    41/41
1000 dtspcd                  11/11                      11/11    0/0      9/11
1001 dtsr                    8/12     7/12     8/12     8/12     8/12     7/12
1002 dtstyle                 10/10    10/10    10/10    10/10    0/9      8/10
1003 dtterm                  131/178  63/85    130/181  133/182  100/137  65/82
1004 dttypes                 0/7      0/7      0/0      0/7      0/0      0/7
1005 dtwm                    129/129  122/129  118/138  124/133  90/108   94/101
1006 mtDtHelp                6/6      0/6      0/0                        0/6
1007 mtDtMrm                 69/74    14/67    0/0                        6/58
1008 mtDtSvc                 38/43    0/43     0/2                        0/43
1009 mtDtTerm                14/19    0/13     0/0                        0/12
1010 mtDtWidget              101/107  6/152    6/8                        3/147
1011 mttt                             1/2
1012 sm-wm                            1/6               0/0
1013 tt                      2/30     27/34    4/31     22/31    4/32     10/13
1014 xpApi                   77/86    75/86    73/86    77/93    73/86    71/82
1015 xpConfig                18/18    8/8      15/18    5/30     15/18    15/18
1016 xpddx                   87/250   187/221  143/243  245/252  209/227  60/252
1017 -----------------------------------------------------------------------------</programlisting><!--emacsbug -->
1018 <para>Because QC/Replay was not available on AIX 4.2, the QC/Replay tests
1019 were not run on the IBM platform.</para>
1020 </sect3>
1021 <sect3>
1022 <title>Motif QATS tests</title>
1023 <para>The Motif/QATS automated tests and Motif window manager were built as
1024 described in an earlier section.</para>
1025 <para>Automated tests were built and run on all reference platforms.
1026 Sun, HP, and SGI displays were used for displaying tests. Motif window
1027 managers built on different platforms were used to manage the windows
1028 while running the tests. The complete QATS is executed on Sun, HPUX, and
1029 SGI platforms
1030 while only the new tests or suites were executed on the remaining reference
1031 platforms.</para>
1032 <sect4>
1033 <title>Missing Keys WARNINGS</title>
1034 <para>The keys on the keyboards used on the HP and Sun platforms are insufficient
1035 for the needs of the tests (keys missing from the keyboard that were expected
1036 to be mapped for the tests), causing "AUTOWARNING" errors in every one of
1037 the tests. The standard report generation scripts detect these benign errors
1038 and flag the entire test as an error. Since these were not considered to be
1039 fatal errors (after inspection of the test code), the analysis scripts filtered
1040 out AUTOWARNING errors that came from missing keys at the very beginning of
1041 a test run.</para>
1042 </sect4>
1043 <sect4>
1044 <title>New Test Clients</title>
1045 <para>Several new test clients were added to the QATS during this release, some
1046 automated and some manual. Test clients were added to the following
1047 directories:</para>
1048 <variablelist>
1049 <varlistentry><term>Automated:</term>
1050 <listitem><programlisting><filename>tests/Toolkit/Buttons</filename>
1051 <filename>tests/uil/widgets</filename></programlisting></listitem>
1052 </varlistentry>
1053 <varlistentry><term>Manual:</term>
1054 <listitem><programlisting><filename>tests/Manual/DtWidgets</filename></programlisting></listitem>
1055 </varlistentry>
1056 </variablelist>
1057 <para>Golden data was generated where necessary.</para>
1058 </sect4>
1059 <sect4>
1060 <title>Golden Data Generation</title>
1061 <para>Some new QATS test suites, which do not have any previous recordings,
1062 were run in record mode to generate golden data. The recordings were added
1063 to this release. These new automated test suites are:</para>
1064 <programlisting>tests/Toolkit/ComboBox
1065 tests/Toolkit/SpinBox
1066 tests/Toolkit/Notebook
1067 tests/Toolkit/IconVC</programlisting>
1068 </sect4>
1069 <sect4>
1070 <title>Test Results</title>
1071 <para>The results were compared with the recordings made against Motif 2.0.
1072 The results are mostly consistent with the previous runs carried out at OSF.
1073 There are failures due to both QATS problems and Motif defects. All the errors/failures
1074 reported during the run are due to known problems in both QATS and Motif code
1075 and have defects already opened against them. Also, the results were consistent
1076 across all the platforms on which the tests were executed.</para>
1077 </sect4>
1078 </sect3>
1079 </sect2>
1080 </sect1>
1081 <sect1 id=chap10>
1082 <title>Compatibility</title>
1083 <sect2 id=ch10s1>
1084 <title>OSF/Motif 2.0 Compatibility</title>
1085 <para>Compatibility with CDE/Motif 1.2 was given great emphasis in this
1086 release, even at the expense of compatibility with OSF/Motif 2.0.
1087 Some OSF/Motif 2.0 applications may experience problems because of the
1088 following changes:</para>
1089 <itemizedlist>
1090 <listitem><para>The <symbol>XmCSText</symbol> widget has been withdrawn, as
1091 have those APIs added to OSF/Motif 2.0 solely to support it.</para>
1092 </listitem>
1093 <listitem><para>Mrm support for word-size independent
1094 <filename>.uid</filename> files has been removed.
1095 Existing <filename>.uid</filename> files compiled with Motif 2.0
1096 <command>uil</command> may not be readable.
1097 As in OSF/Motif 1.2, <filename>.uid</filename> files are portable only
1098 between machines with the same word size.</para>
1099 </listitem>
1100 <listitem><para>New <symbol>XmComboBox</symbol>
1101 <symbol>XmNpositionMode</symbol> and <symbol>XmSpinBox</symbol>
1102 <symbol>XmNpositionType</symbol>
1103 resources default to incompatible index values, and should be forced
1104 by all applications using these widgets. <symbol>XmONE_BASED</symbol> is
1105 recommended for <symbol>XmComboBox</symbol> widgets because it lets applications
1106 distinguish between new values entered in the text field and the first item
1107 in the list.</para>
1108 </listitem>
1109 <listitem><para>The <symbol>_XmStrings</symbol> array has, on some
1110 machines, been split into multiple sub-arrays with the same techniques used
1111 by libXt. This preserves compatibility with Motif 1.2 and permits future
1112 expansion.</para>
1113 </listitem>
1114 <listitem><para>In Motif 2.0 there were two distinct
1115 <symbol>XmREPLACE</symbol> constants, with different values. The
1116 <symbol>XmMergeMode</symbol> constant has been renamed
1117 <symbol>XmMERGE_REPLACE</symbol>. This is a source compatibility issue;
1118 binary compatibility is unaffected.</para>
1119 </listitem>
1120 <listitem><para>A variety of changes to visual appearance may be noticed.
1121 See the <citetitle>Motif 2.1.0 Release Notes</citetitle> for details.</para>
1122 </listitem>
1123 </itemizedlist>
1124 </sect2>
1125 <sect2 id=ch10s2>
1126 <title>CDE Binary Compatability</title>
1127 <para>Binary Compatibility testing was carried out using products provided
1128 by SunSoft and IBM. In addition, binary executables built locally for the
1129 CDE 1.0.10 release were tested. Some incompatibilities were found, as
1130 described below. Some problems were found that were specific
1131 to the tested application and which we do not believe indicate a compatibility
1132 problem with the reference system.</para>
1133 <itemizedlist><listitem>
1134 <para>As with previous major releases of Motif, binary compatibility is not
1135 guaranteed for application widgets that subclass Motif widgets without
1136 using <symbol>XmResolvePartOffsets</symbol> to access instance fields.
1137 Subclasses that use <symbol>XmResolvePartOffsets</symbol>
1138 (or <symbol>XmResolveAllPartOffsets</symbol>) should be unaffected.</para>
1139 </listitem>
1140 <listitem>
1141 <para>On AIX, the CDE shared libraries are linked with the reentrant C
1142 library, <filename>libc_r.a</filename>.
1143 Legacy applications that reference the non-reentrant
1144 C library, <filename>libc.a</filename>, will experience difficulties
1145 because two different copies of data are being referenced. The
1146 solution recommended by IBM is to build and install a complete set of CDE
1147 libraries with the non-reentrant compiler, giving them the standard names,
1148 and another complete reentrant set, giving them names with the <filename>
1149 _r</filename> suffix (for example, <filename>libXm_r.a</filename>). The default
1150 configuration files build only the reentrant set.</para>
1151 </listitem>
1152 <listitem>
1153 <para>On AIX, the sample application <command>llenhcapture</command> did
1154 not execute. We believe this is due to an incompatibility in standard AIX
1155 libraries.</para>
1156 </listitem>
1157 <listitem>
1158 <para>On AIX, the sample application <command>SDE</command> did not execute,
1159 as it calls the undocumented and withdrawn function
1160 <filename>XmStringLoadQueryFont</filename>.</para>
1161 </listitem><listitem>
1162 <para>The DtHelp library has a dependency on the math library,
1163 <filename>libm.a</filename>. On SVR4 systems, any legacy application that
1164 does not already reference the math library must be re-linked.
1165 </para>
1166 </listitem></itemizedlist>
1167 <para>We did not use Digital or Fujitsu platforms in the BC testing
1168 since they were not reference platforms for the CDE1.0.10 release.</para>
1169 </sect2>
1170 </sect1>
1171 <sect1 id=chap11>
1172 <title>Pluggable Authentication Module (PAM)</title>
1173 <para>Pluggable Authentication Module (PAM) code supplied by SunSoft is included
1174 with the CDE source. The source is located in the <filename>$CDESOURCEDIR/cde/lib/pam
1175 </filename> subdirectory. Documentation, manual pages, examples, and a selection
1176 of modules (back-end code for some common authentication technologies) are
1177 provided in addition to the front-end pam library.</para>
1178 <para>PAM is built and installed automatically on Sun platforms. The <command>
1179 dtlogin</command> source contains conditionally compiled code to invoke the
1180 PAM front-end API.</para>
1181 </sect1>
1182 <sect1 id=chap12>
1183 <title>New Functionality</title>
1184 <para>The following paragraphs summarize the new functionality of this release relative
1185 to CDE1.0. Please refer to the specific on-line documentation for more detailed
1186 information.</para>
1187 <sect2 id=sect20>
1188 <title>Printing</title>
1189 <para>Starting with this release <command>dtpad</command>, <command>dtmail
1190 </command> and <command>dtcm</command> are using the X protocol based print
1191 server. This print server produces output in three formats: PCL, Postscript and
1192 Raster.</para>
1193 </sect2>
1194 <sect2 id=sect21>
1195 <title>Thread-Safe Libraries</title>
1196 <para>The following libraries are thread-safe enabled: Xm, tt, DtHelp,
1197 DtSvc, DtTerm, DtWidget, and Mrm. This means that the libraries themselves
1198 are thread safe and a multithreaded application need not do explicit
1199 locking when accessing these libraries. This is supported only for
1200 platforms that support multithreaded programming.</para>
1201 </sect2>
1202 <sect2 id=sect22>
1203 <title>X11R6.2</title>
1204 <para>This release is based on X11R6.2, which includes additional support
1205 for Vertical Writing, User-Defined Characters (UDCs) and the X Print
1206 Service.</para>
1207 <para>In addition, session management using the X11R6 XSMP is provided
1208 and supported by <command>dtsession</command> and
1209 <command>dtwm</command>.</para>
1210 </sect2>
1211 <sect2 id=sect23>
1212 <title>Internationalization</title>
1213 <para>There are several new features that support the internationalization
1214 of CDE and developing applications for international markets. CDE now supports
1215 the On-The-Spot input method for <command>Xm</command> and <command>dtterm
1216 </command>.
1217 Based on the session start-up locale, users can select their preferred
1218 Input method server either at startup time (using the new Input method
1219 server selection and launch) or during the session (via
1220 <command>dtstyle</command>). They can also select
1221 their preferred input method style (Off-The-Spot, On-The-Spot, etc.)
1222 via <command>dtstyle</command>.
1223 Users may use and define their own fonts with the User Definable
1224 Character (UDC) feature. Also, Vertical Writing is now supported.</para>
1225 </sect2>
1226 <sect2 id=sect24>
1227 <title>On-Line Information Access</title>
1228 <para>This release provides a standard set of online documentation that
1229 covers the various CDE and Motif components. The CDE desktop includes the
1230 Information Manager which can be used to access, read, and search through
1231 this documentation.</para>
1232 <para>The Information Manager replaces the the Help Manager on the Front
1233 Panel. Additional information about using Information Manager is available
1234 on-line in the <citetitle>CDE: Information Manager User's
1235 Guide</citetitle> and in the <command>dtinfo</command>
1236 man page. Information about authoring on-line documentation for use with
1237 the Information Manager is also available on-line in the
1238 <citetitle>CDE: Information System Author's and Programmer's
1239 Guide</citetitle> and in the <command>dtinfogen</command> man page.</para>
1240 <para>The Information Manager includes a general purpose text
1241 search and retrieval system. This functionality is provided
1242 by the DtSearch library and by the dtsr* programs.
1243 Applications can also directly access on-line information using
1244 the DtInfo Database Engine API provided by the DtMmdb library.</para>
1245 </sect2>
1246 <sect2 id=sect25>
1247 <title>Tests</title>
1248 <para>Several new test suites have been added for this release.
1249 </para>
1250 <itemizedlist>
1251 <listitem><para>Threadsafe Motif, Tooltalk and Dt libraries</para>
1252 </listitem>
1253 <listitem><para>Postscript and PCL ddx</para>
1254 </listitem>
1255 <listitem><para>Printing: API, PDM, XmPrinting, C/RE, and Dt clients</para>
1256 </listitem>
1257 <listitem><para>Dtinfo Desktop and Printing (QC/Replay based)</para>
1258 </listitem>
1259 <listitem><para>DtSearch</para>
1260 </listitem>
1261 <listitem><para>Error Message API</para>
1262 </listitem>
1263 <listitem><para>X11R6 session management</para>
1264 </listitem>
1265 <listitem><para>Standalone Window Manager (QC/Replay based)</para>
1266 </listitem>
1267 <listitem><para>Motif 2.0 changes (Motif QATS)</para>
1268 </listitem>
1269 <listitem><para>dtimsstart</para>
1270 </listitem>
1271 <listitem><para>I18N features (Vertical Writing, UDCs, on-the-spot IM)</para>
1272 </listitem>
1273 <listitem><para>SDL Converter</para>
1274 </listitem>
1275 </itemizedlist>
1276 </sect2>
1277 </sect1>
1278 <sect1 id=chap13>
1279 <title>Reference Platforms</title>
1280 <para>This chapter defines the reference platforms for this release. A reference
1281 platform is a system configuration on which the shipped CDE source has been
1282 verified to build and execute.</para>
1283 <sect2 id=sect26>
1284 <title>Digital</title>
1285 <variablelist>
1286 <varlistentry><term>Component</term>
1287 <listitem>
1288 <programlisting>Model                   AlphaStation 200
1289 RAM                     64 MB
1290 Graphics                1280x1024 8 plane</programlisting>
1291 </listitem>
1292 </varlistentry>
1293 <varlistentry><term>Software</term>
1294 <listitem>
1295 <programlisting>OS Version              Digital UNIX V4.0 (Rev. 386)
1296
1297 Patches to OS           none
1298
1299 Network Communications  NIS, NFS
1300
1301 Compiler(s)             DEC C V5.2-023
1302                         DEC C++ V5.4-006</programlisting>
1303 </listitem>
1304 </varlistentry>
1305 </variablelist>
1306 </sect2>
1307 <sect2 id=sect27>
1308 <title>Fujitsu</title>
1309 <variablelist>
1310 <varlistentry><term>Component</term>
1311 <listitem>
1312 <programlisting>Model                   DS/90 7000
1313 RAM                     64 MB
1314 Graphics                1280x1024 8 plane (CF1 or CF3 display
1315                         adapter required)</programlisting>
1316 </listitem>
1317 </varlistentry>
1318 <varlistentry><term>Software</term>
1319 <listitem>
1320 <programlisting>OS Version              UXP/DS V20L10
1321
1322 Patches to OS           PTF Y96021
1323                         and see below
1324
1325 Network Communications  NIS, NFS
1326
1327 Compiler(s)             C Development Set (CDS):
1328                         CC Driver UXP/DS R2.6
1329                         C++ V12L20
1330
1331 X Window System Server  UXP/DS X11R6 XServer V10L10</programlisting>
1332 </listitem>
1333 </varlistentry>
1334 <varlistentry><term>Comments</term>
1335 <listitem>
1336 <para>The following patches are currently available directly from Fujitsu:
1337 </para>
1338 <itemizedlist>
1339 <listitem><para>OS patch PEF TY12846 is required to repair some RPC
1340 problems. This fix will be included in V20L10 Y96111.</para>
1341 </listitem>
1342 <listitem><para>OS patch TY13126 may be required to fix some problems in
1343 building the release using NFS.</para></listitem>
1344 <listitem><para>The listen daemon needs a non-public patch to prevent a core
1345 dump when <command>rpc.ttdbserverd</command> is started.</para>
1346 </listitem>
1347 <listitem><para>A non-public patch is needed to solve an NFS locking problem
1348 seen at the X Consortium while attempting to perform CDE builds.</para>
1349 </listitem>
1350 <listitem><para>A non-public patch must be applied to the C++ compilation
1351 utilities (package name uxpcplus).</para>
1352 </listitem>
1353 <listitem><para>A non-public patch is needed to enter Japanese text; this
1354 lets the input server <command>xfeoak</command> run using X11R6.</para>
1355 </listitem>
1356 </itemizedlist>
1357 </listitem>
1358 </varlistentry>
1359 </variablelist>
1360 </sect2>
1361 <sect2 id=sect28>
1362 <title>Hewlett Packard</title>
1363 <variablelist>
1364 <varlistentry><term>Component</term>
1365 <listitem>
1366 <programlisting>Model                   HP9000/7xx
1367 RAM                     64 MB
1368 Graphics                Artist (HP208LC1280) 1280x1024 8 plane</programlisting>
1369 </listitem>
1370 </varlistentry>
1371 <varlistentry><term>Software</term>
1372 <listitem>
1373 <programlisting>OS Version              HP-UX 10.01
1374 Patches to OS           see below
1375 Network Communications  NIS, NFS
1376
1377 Compiler(s)             HP C/ANSI C Developer's Bundle for HP-UX 10.0
1378                         HP C++ Compiler Bundle
1379                         Patches PHSS_9138 (compiler) and PHSS_8831 (ld)
1380 Additional components   see below</programlisting>
1381 </listitem>
1382 </varlistentry>
1383 <varlistentry><term>Comments</term>
1384 <listitem>
1385 <para>The following additional patches should be applied. Patches listed are
1386 those available as of 11 December, 1996. All HP patches are subject to being
1387 superseded from time to time; all new patches list the old ones that they
1388 replace. Current replacement patches may be substituted for those listed below.
1389 </para>
1390 <para>The platforms at the X Consortium have some patches that have been
1391 superseded by those listed.
1392 </para>
1393 <para>Some of these patches are needed for correct operation of ClearCase
1394 release 2.0.3. They may not be necessary to build and run CDE from a locally
1395 installed tree.</para>
1396 <programlisting>PHCO_5803       fsck_hfs(1M) patch for possible corruption
1397 PHKL_5812       Fix panic when opening some fix partition disks
1398 PHKL_9114       fix for process hangs in semop(2)
1399 PHKL_9404       JFS, LVM, UFS, pstat cumulative patch
1400 PHNE_6419       cumulative STREAMS patch
1401 PHNE_6527       LAN products Patch
1402 PHNE_7514       cumulative telnet(1) patch
1403 PHNE_7553       telnetd(1M) cumulative patch
1404 PHNE_8114       NFS/NIS Runtime cumulative patch
1405 PHNE_8168       ARPA Transport cumulative patch
1406 PHNE_9089       Cumulative Mux and Pty Patch</programlisting>
1407 <para>The kernel parameter <symbol role="Variable">maxuprc</symbol> (maximum
1408 processes per user) should be increased from its default value of 50 to 100.
1409 </para>
1410 </listitem>
1411 </varlistentry>
1412 </variablelist>
1413 </sect2>
1414 <sect2 id=sect29>
1415 <title>IBM</title>
1416 <variablelist>
1417 <varlistentry><term>Component</term>
1418 <listitem>
1419 <programlisting>Model                   RS/6000
1420 RAM                     64 MB
1421 graphics                1280x1024 8 plane</programlisting>
1422 </listitem>
1423 </varlistentry>
1424 <varlistentry><term>Software</term>
1425 <listitem>
1426 <programlisting>OS Version              AIX 4.2
1427 Patches to OS           PTF 446072
1428 Network Communications  NIS, NFS
1429
1430 Compiler(s)             xlC.C     3.1.4.0
1431                         xlC.C++.* 3.1.4.0 (several filesets)
1432                         xlC.cpp   3.1.4.0
1433                         xlC.rts   3.1.4.0
1434 Additional components   See below</programlisting>
1435 </listitem>
1436 </varlistentry>
1437 <varlistentry><term>Comments</term>
1438 <listitem>
1439 <para>Version 3.1.4.0 of the C Programming Information filesets should also
1440 be installed.</para>
1441 <para>All platforms require the standard X11 filesets. At the X Consortium,
1442 we have found that the original standard installs did not have the following
1443 required fileset:</para>
1444 <programlisting>X11.samples.lib.Core</programlisting>
1445 <para>Performance testing using a software technique of removing memory
1446 requires the fileset perfagent.tools (Performance Analysis and Control
1447 Commands), version 2.1.3.0, to enable artificial memory degradation.</para>
1448 </listitem>
1449 </varlistentry>
1450 </variablelist>
1451 </sect2>
1452 <sect2 id=sect30>
1453 <title>Novell</title>
1454 <variablelist>
1455 <varlistentry><term>Component</term>
1456 <listitem>
1457 <programlisting>Model                   Intel 486/Pentium
1458 RAM                     64 MB
1459 Graphics                1280x1024 8 plane</programlisting>
1460 </listitem>
1461 </varlistentry>
1462 <varlistentry><term>Software</term>
1463 <listitem>
1464 <programlisting>OS Version              UnixWare 2.02
1465 Patches to OS           PTF2094 - TCP/IP Recovery
1466 Network Communications  NIS, NFS
1467
1468 Compiler(s)             CCS Optimizing C Compilation System 3.0
1469                         C++ Compilation System 2.0
1470
1471 Additional components   See below</programlisting>
1472 </listitem>
1473 </varlistentry>
1474 <varlistentry><term>Comments</term>
1475 <listitem>
1476 <para>It is necessary to increase some kernel limits, as follows:</para>
1477 <programlisting>SDATLIM 0x8000000
1478 HDATLIM 0x8000000
1479 SSTKLIM 0x8000000
1480 HSTKLIM 0x8000000
1481 SVMMLIM 0x10000000
1482 HVMMLIM 0x10000000
1483 </programlisting>
1484 <para>The following optional packages should be installed (this is pkginfo
1485 format):</para>
1486 <programlisting>application SDKdocs        Software Development Kit Documentation
1487 graphics    desksup        Desktop Manager Development
1488 application ihvkit         IHV Development Kit
1489 system      nmsdk          Network Management SDK
1490 system      softint        Software Packaging Tools
1491 system      stdcomps       Standard Components
1492 </programlisting>
1493 </listitem>
1494 </varlistentry>
1495 </variablelist>
1496 </sect2>
1497 <sect2 id=sect31>
1498 <title>Silicon Graphics</title>
1499 <para>This is a Motif-only platform.</para>
1500 <variablelist>
1501 <varlistentry><term>Component</term>
1502 <listitem>
1503 <programlisting>Model                   Indigo2
1504 RAM                     64 MB
1505 Graphics                1280x1024 8 plane</programlisting>
1506 </listitem>
1507 </varlistentry>
1508 <varlistentry><term>Software</term>
1509 <listitem>
1510 <programlisting>OS Version              SC4-W4DI2-6.2: 6.2 with Indigo2 R10000 Impact
1511 Patches to OS           None
1512 Network Communications  SC4-NFS-6.2.1: NFS software
1513
1514 Compiler(s)             SC4-IDO-7.0: IRIX Development Option
1515                         SC4-C++-7.0: C++ compiler</programlisting>
1516 </listitem>
1517 </varlistentry>
1518 <varlistentry><term>Comments</term>
1519 <listitem>
1520 <para>In addition, there are three patches that apply to the compilers:
1521 patches 1451, 1453 and 1463.</para>
1522 </listitem>
1523 </varlistentry>
1524 </variablelist>
1525 </sect2>
1526 <sect2 id=sect32>
1527 <title>Sun</title>
1528 <variablelist>
1529 <varlistentry><term>Component</term>
1530 <listitem>
1531 <programlisting>Model                   SPARCstation
1532 RAM                     64 MB
1533 Graphics                1152x900 8 plane</programlisting>
1534 </listitem>
1535 </varlistentry>
1536 <varlistentry><term>Software</term>
1537 <listitem>
1538 <programlisting>OS Version              Solaris 2.4
1539 Patches to OS           see below
1540 Network Communications  NIS, NFS
1541
1542 Compiler(s)             SPARCompiler C 2.0.1
1543                         SPARCompiler C++ 3.0.1
1544
1545 Additional components   See below</programlisting>
1546 </listitem>
1547 </varlistentry>
1548 <varlistentry><term>Comments</term>
1549 <listitem>
1550 <para>The Solaris Common Build Environment is required.</para>
1551 <para>The following patches are required. This list reflects patch numbers
1552 available as of 30 October, 1995. From time to time, replacement patches may
1553 be issued with changed suffix values; the current replacement patches may
1554 be substituted for those listed below.</para>
1555 <programlisting>100962-01       C++ patch for USL Cfront, release 3.0.2.
1556 100974-02       dbx/ld scoped libs
1557 101880-08       Mime message conversion field error
1558 101907-05       volume management fixes
1559 101925-02       Header file fixes
1560 101933-01       /dev/mouse open causes cursor to freeze
1561 101945-32       Kernel jumbo patch
1562 102057-20       Xserver jumbo patch
1563 102303-05       link editors require to provide for dynamic interfaces
1564 102330-03       WABI fixes
1565 102450-02       Docviewer will not start with full colormap
1566 102650-02       New Tooltalk
1567 103250-01       fd recalculate fix</programlisting>
1568 </listitem>
1569 </varlistentry>
1570 </variablelist>
1571 </sect2>
1572 </sect1>
1573 <sect1 id=chap14>
1574 <title>Open/Closed Defect Lists</title>
1575 <para>The following files listing defect reports are provided in the directories <filename>
1576 $CDESOURCEDIR/cde</filename> and <filename>$CDESOURCEDIR/motif</filename>:
1577 </para>
1578 <variablelist>
1579 <varlistentry><term><filename>OPENBUGS</filename></term>
1580 <listitem>
1581 <para>Lists the currently known unresolved defects reported against CDE or
1582 Motif components respectively.</para>
1583 </listitem>
1584 </varlistentry>
1585 <varlistentry><term><filename>CLOSEDBUGS</filename></term>
1586 <listitem>
1587 <para>Lists the defects that have been resolved since CDE 1.0.10 or
1588 Motif 2.0.</para>
1589 </listitem>
1590 </varlistentry>
1591 </variablelist>
1592 </sect1>
1593 <sect1 id=chap15>
1594 <title>Additional Note</title>
1595 <para>The <command>mapconv</command> utility function is available in the <filename>
1596 cde-contrib</filename> directory. It provides a method for converting a string
1597 of characters from one codeset type to another type.</para>
1598 </sect1>
1599 </chapter>
1600 </book>
1601