2
0

ReleaseNotes.sgm 69 KB

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