home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / comp / windows / openloo / 4368 next >
Encoding:
Internet Message Format  |  1992-11-07  |  48.0 KB

  1. Xref: sparky comp.windows.open-look:4368 comp.windows.x:18730 alt.toolkits.xview:1032 comp.windows.x.intrinsics:482
  2. Newsgroups: comp.windows.open-look,comp.windows.x,alt.toolkits.xview,comp.windows.x.intrinsics
  3. Path: sparky!uunet!uunet.ca!wildcan!sq!lee
  4. From: lee@sq.sq.com (Liam R. E. Quin)
  5. Subject: OPEN LOOK GUI frequently asked questions
  6. Message-ID: <1992Nov5.043432.10572@sq.sq.com>
  7. Organization: SoftQuad Inc., Toronto, Canada
  8. Date: Thu, 5 Nov 92 04:34:32 GMT
  9. Lines: 1040
  10.  
  11.  
  12. Frequently-asked questions about the OPEN LOOK Graphical User Interface.
  13. This is version: $Revision: 1.40 $; Last posted version:  1.38
  14. Changes and additions are marked with a | or + in the right margin.
  15.  
  16.  
  17. If your question isn't here, please try (at *least*)
  18.     man openwin
  19.     man xnews
  20.     man 7 xview
  21.         man olwm                                                             +
  22. and looking in the appropriate manuals listed in the Bibliography below
  23. before posting to the comp.windows.open-look, comp.windows.x or
  24. alt.toolkits.xview newsgroups and/or their corresponding mailing lists.
  25.  
  26. Frequently Asked Questions for X11 are posted to comp.windows.x monthly.
  27.  
  28.  
  29. Contents: (in rn and trn you can use control-G to go to the next topic)
  30.  
  31.     Subject: Terminology: OPEN LOOK, OpenWindows, X11, XView, (MO)OLIT, Motif
  32.     Subject: Window Managers -- olwm, olvwm
  33.     Subject: OpenWindows, Terminals, and Other Displays
  34.     Subject: Configuration Files: Getting started with OpenWindows
  35.     Subject: Key Bindings, Cut and Paste
  36.     Subject: Applications: Finding Out...
  37.     Subject: Troubleshooting: It Won't Let Me Type
  38.     Subject: Troubleshooting: Not authorized to use display
  39.     Subject: Trouble Shooting: other common problems
  40.     Subject: Trouble Shooting: XView problems
  41.     Subject: Fonts
  42.     Subject: Environment Variables
  43.     Subject: Where Can I get It? Ftp, implementations, etc...
  44.     Subject: Bibliography -- books, manuals, journals, papers, beer-mats
  45.     Subject: Getting this File, Revision History, Recent Changes
  46.  
  47.  
  48. Subject: Terminology: OPEN LOOK, OpenWindows, X11, XView, OLIT, MOOLIT, Motif
  49.  
  50. @ What is OPEN LOOK?
  51.     OPEN LOOK is a specification of a Graphical User Interface (GUI).
  52.     A GUI determines the `look and feel' of a system -- the shape of
  53.     windows, buttons and scroll-bars, how you resize things, how you
  54.     edit files, etc.
  55.  
  56.     The OPEN LOOK GUI is specified, developed and maintained jointly by
  57.     Sun Microsystems and AT&T.
  58.  
  59.     See Also:
  60.     Bibliography
  61.  
  62. @ What is OpenWindows?
  63.     OpenWindows is a windowing environment that conforms to the OPEN LOOK
  64.     Graphical User Interface Specifications.  It's compatible with the
  65.     X11 window system from MIT as well as (currently) Sun's NeWS and SunView, |
  66.     so you can intermix programs written for any of those systems.          |
  67.     It comes from Sun and also with System V Release 4 from certain vendors.  |
  68.     OpenWindows is sometimes also called openwin or xnews, after the
  69.     program used to start it and the main executable itself, respectively.
  70.     It should not be called `Windows' or 'OPEN LOOK' or `OpenLook', as
  71.     these terms are either wrong or apply to something else.
  72.     A commerical OpenWindows source licence costs about $5,000 for the        +
  73.     server, plus about $25,000 for DeskSet, and another $40,000 for ToolTalk. +
  74.     The current versions of OpenWindows for various platforms are:          +
  75.     SunOS 4.1.1 on Sun 3: 2.0                          +
  76.     Solaris 1.x (SunOS 4.1.x) on SPARC: 3.0                      +
  77.     Solaris 2.0 (SunOS 5) on SPARC: 3.0.1                      +
  78.  
  79.     See Also:
  80.     Mixing X11 and OpenWindows
  81.     Where can I get it?
  82.  
  83. @ What are OLIT, XView and TNT?
  84.     These are all toolkits for programmers to use in developing programs
  85.     that conform to the OPEN LOOK specifications.  See the Bibliography
  86.     for documentation on the individual toolkits.  Here's a brief summary:
  87.  
  88.     OLIT is AT&T's OPEN LOOK Intrinsics Toolkit for the X Window system;
  89.     it uses a widget set, and is probably the easiest for people who are
  90.     already X11 programmers to learn.  You can buy the source from AT&T.
  91.     Sun includes the OLIT library in OpenWindows (q.v.); it may also be
  92.     included in System V Release 4.  It's written in C.     The current
  93.     version of OLIT (included in OpenWindows, or available from AT&T) is 2.5.
  94.     The release of OLIT in OpenWindows 3.0 is OLIT 3.0.
  95.     See also: MOOLIT [sic]
  96.  
  97.     XView is Sun's toolkit for X11, written in C.  XView is similar in        |
  98.     programmer interface to SunView.  There's even a shell script to help     |
  99.     migrate source code from SunView to XView.     XView is often said to be    |
  100.     the easiest toolkit to learn if you are not familiar with X Windows.      |
  101.     The XView toolkit is included in OpenWindows, and full source is
  102.     available by anonymous ftp from export.lcs.mit.edu (and elsewhere).
  103.     The current version of XView from Sun is 3.0.
  104.     Despite rumours to the contrary -- some even from within Sun -- the       +
  105.     XView toolkit is *NOT* about to be dropped by Sun.  XView *will* be       +
  106.     included in the next release of OpenWindows, unlike NeWS.              +
  107.  
  108.     The NeWS Toolkit (TNT) was an object-oriented programming system based    |
  109.     on the PostScript language and NeWS.  TNT implements many of the
  110.     OPEN LOOK interface components required to build the user interface of
  111.     an application.  It's currently included in OpenWindows.              |
  112.  
  113.     The current version of TNT from Sun is 3.0; Release 3.0 contains some
  114.     incompatibilities with tNt 1.0 an 2.0, but Sun are committed to
  115.     supporting the API, at least until they stop NeWS support some time
  116.     later this year and replace it with Display PostScript.  Wail.
  117.     You might ask what `is committed to' means in this context; the          +
  118.     answer seems to be that it means absolutely nothing.              +
  119.  
  120.     The C++ User Interface Toolkit (UIT) consists of an object-oriented C++
  121.     class library layered on top of XView and a tool to generate code from
  122.     DevGuide 3 GIL files.  The UIT also includes features that simplify
  123.     event management and the use of PostScript and color.  It is said to be
  124.     compatible with OpenWindows V2 and V3, and presumably V3.0.1, since the
  125.     release mentions that it works on Solaris 2.
  126.     UIT is not an official Sun-supported product but an ongoing project of
  127.     various people within Sun.  It can be found on export.lcs.mit.edu in
  128.     the MIT contrib directory as UITV2.tar.Z (use binary mode!).
  129.  
  130. @ Where does Motif fit in?
  131.     It doesn't :-).  Motif is an alternative Graphical User Interface that
  132.     is being developed by OSF.    It has a `look and feel' reminiscent of
  133.     Microsoft Windows and the OS/2 Presentation Manager.  There are no non-
  134.     commercial Motif toolkits available, although the Motif source is sold
  135.     reasonably cheaply by OSF.    Although Motif is currently available on
  136.     more platforms than OpenWindows, the OPEN LOOK GUI is almost certainly
  137.     used on many more machines, simply because Sun (and SysVR4) have such a
  138.     large installed base.
  139.     Sun's CD/WARE Volume 2 contains a roadmap for improving Motif
  140.     applications by converting them to OLIT [:-)]; there are also notes in
  141.     the `Periodic Table' OLIT demo, $OPENWINHOME/demo/olittable.
  142.  
  143. @ What is MOOLIT?
  144.     MOOLIT is a version of OLIT from AT&T that lets users choose between a
  145.     Motif and an OPEN LOOK UI feel at run-time.  It will be part of System V
  146.     Release 4.2, which may also contain an X11R5 that supports Adobe's Type
  147.     Manager (ATM).  It isn't clear whether MOOLIT will replace OLIT.
  148.     Contact: Joanne Newbauer, jo@usl.com, (908) 522-6677
  149.  
  150. @ What about that Display PostScript thing?                                  +
  151.     Sun and Adobe have agreed that Sun will include the DPS extension to X   +
  152.     in the next release of OpenWindows.  DPS is essentially a badly designed +
  153.     hack on top of a slow Level 2 PostScript interpreter intended to give a  +
  154.     very small subset of the functionality of NeWS whilst simultaneously     +
  155.     being harder to use, as I understand it.  The only real advantage it     +
  156.     has over NeWS is that the manual is much smaller, being generally less   +
  157.     complete; DPS is also available on more kinds of machine.                +
  158.     Performance on the RS/6000 is not suitable for interactive work;         +
  159.     what it will be like on the SPARCStation remains to be seen.             +
  160.  
  161. Subject: Window Managers -- olwm, olvwm
  162.  
  163. @ What are olwm and olvwm?
  164.     They are window managers.  A window manager is the part of the X Window
  165.     system (e.g. X11) that is responsible for deciding how to lay out windows
  166.     on the screen, and for managing the user's interaction with the windows.
  167.  
  168.     Olwm is the standard OPEN LOOK window manager.
  169.     It's included with all of the OpenWindows (q.v.) implementations, and
  170.     you can also get the source by ftp, since Sun donated it.
  171.  
  172.     Olvwm is a version of olwm that manages a `virtual desktop' (hence the
  173.     `v' in its name).  It shows a little map on the screen, with the
  174.     currently displayed area represented by a little rectangle.     You can
  175.     move around by dragging the rectangle or with the arrow keys.  This
  176.     lets you run several clients (applications) and move the display around
  177.     from one to the other.  Olvwm was derived from the OpenWindows 3.0 olwm
  178.     by Scott Oaks; you need to have XView 3.0 to compile it.
  179.     Get olvwm from an ftp site such as export.lcs.mit.edu (in the contrib
  180.     directory; there are two patches).
  181.  
  182. @ Can I use my favorite window manager with OpenWindows instead of olwm?
  183.     Yes.  If you use twm, for example, or mwm, you won't be able to use
  184.     the Pin and Unpin feature of olwm, and you (probably) won't see the
  185.     footers some windows use to display certain messages.
  186.  
  187.     If you use twm, you'll want to use the f.delete function to unpin menus
  188.     and get rid of programs that don't have a `quit' button when not run
  189.     under olwm.
  190.     For twm, put this in your $HOME/.twmrc:
  191.     LeftTitleButton "target" = f.delete
  192.     where "target" is a 16x16 icon from /usr/include/X11/bitmaps.
  193.     Alternatively, try
  194.     # Add a menu to each window managed by twm or tvtwm
  195.     LeftTitleButton ":menu" = f.menu "OL.menu"
  196.  
  197.     menu "OL.menu" {
  198.         "Quit"         f.delete
  199.     }
  200.  
  201.     For mwm, you can double-click on the menu icon on the left of the title
  202.     bar to dismiss a pop-up window (I am told).
  203.  
  204.     See the manual page for your window manager (twm, etc).
  205.  
  206. Subject: OpenWindows, Terminals, and Other Displays
  207.  
  208. @ Can I use olwm and olvwm without OpenWindows or on an X Terminal?
  209.     The OpenWindows xnews server combines SunView, NeWS (PostScript) and X11.
  210.     This means that it can run programs compiled for any of those systems.
  211.     Unfortunately, it means that some OpenWindows programs need either NeWS
  212.     or SunView support, and thus won't run on an X terminal.  This includes
  213.     pageview in particular.
  214.  
  215.     You can use olwm or olvwm (see above) on an X terminal or a non-Open-
  216.     Windows display, and most OPEN LOOK clients (e.g. OLIT or XView ones)
  217.     will work perfectly well.  You may find that you get complaints about
  218.     fonts not being found.  If so, see the Fonts section below.
  219.     If you are running the window manager built-in to an NCD terminal, you
  220.     may have problems with input focus; setting *Input: True in the terminal's
  221.     XDefault file in /usr/lib/X11/xdm may or may not help.
  222.  
  223.  
  224. Subject: Configuration Files: Getting started with OpenWindows
  225.      
  226. @ What configuration files do I need to know about?
  227.  
  228.     .xinitrc and .xsessionrc
  229.  
  230.     The first time you run OpenWindows, a .xinitrc file will be created in
  231.     your login directory ($HOME).  If it already exists, you might have to
  232.     edit it somewhat; it's simplest to move it and any other old X11 files
  233.     you have to another directory, and then merge the old and new files.
  234.  
  235.     If your site uses xdm, you should use .xsession instead of .xinitrc,
  236.     since xdm doesn't look at your .xinitrc file.
  237.  
  238.     .openwin-init, .openwin-menu and .openwin-sys
  239.  
  240.     These are optional files you can create in your $HOME directory,
  241.     depending on which version of olwm or olvwm you use.
  242.     Look in $OPENWINHOME/lib (normally /usr/openwin/lib) for these files
  243.     without the leading . and copy any you want to change.  You may need
  244.     to edit your .xinitrc to get them recognized.  If you are not on an
  245.     X terminal, you will want to run a console window (such as cmdtool -C,
  246.     shelltool -C, xterm -C) or Chuck Musciano's "contool" program so that
  247.     system output will be directed there instead of writing over your screen.
  248.     Note that .openwin-sys is not executed unless you edit .xinitrc.
  249.  
  250.     .Xdefaults
  251.  
  252.     You can put X Windows resource specifications in here.  In particular,
  253.     it is a good idea to include at least:
  254.     OpenWindows.FocusLenience:    true
  255.     *Input: TRUE
  256.     These allow non-ICCCM-compliant programs to receive input even if they
  257.     forget to ask for it.
  258.  
  259.     Props, the program that runs when you select `properties' from the default
  260.     root menu under olwm or olvwm, writes your choices into .Xdefaults.
  261.     Don't put comments in .Xdefaults, since `props' deletes them.
  262.  
  263.     .startup.ps
  264.  
  265.     This is the NeWS user profile file, read by OpenWindows (actually xnews)
  266.     on startup.     This is documented in the NeWS programming manual, near the
  267.     back.  The most useful thing to put here is PostScript code to change
  268.     the keyboard repeat rate, although you must be very careful, since a
  269.     syntax error in the PostScript means that xnews will either not start up
  270.     at all or will get broken in strange ways.    The NeWS manual gives code
  271.     that is both incorrect and insufficient.
  272.     WARNING: things in this file rarely work on both OpenWindows 2 and 3.
  273.  
  274.     Note that the mouse speed is best set in your .xinitrc with xset m; see
  275.     the man page for xset ("man xset", and "xset -help") for more information.
  276.  
  277.     Here's what $HOME/.startup.ps  should look like if you want a delay of
  278.     about a third of a second (300000 microseconds), and a repeat rate of
  279.     twenty or so keys per second (30000 microseconds between repeats) for
  280.     OpenWindows 3.  You'll have to experiment a bit because the RepeatTime
  281.     is the delay between keys sent, and thus doesn't include the time to
  282.     process each key, which is probably higher on my 4/110 than on your
  283.     SuperSPARC 10/51 GTi injection :-)  Again, this is for OpenWindows 3...
  284.  
  285.     % don't want the demos - see p. xxxii of NeWS Toolkit Reference Manual
  286.     % /IncludeDemos? false def
  287.  
  288.     UserProfile begin
  289.         /KeyRepeatThresh 0 300000 timeval storetimeval def
  290.         /KeyRepeatTime 0 30000 timeval storetimeval def
  291.         % Note: 300000 and 30000 differ greatly...
  292.     end
  293.  
  294.     You must also have a .user.ps file in the same directory, like this:
  295.  
  296.     /NeWS 3 0 findpackage beginpackage
  297.     /TNTCore 3 0 findpackage beginpackage
  298.     /TNT 3 0 findpackage beginpackage
  299.  
  300.     ClassRepeatKeys pop    % force repeat.ps to autoload
  301.  
  302.     endpackage endpackage endpackage
  303.  
  304.     If you change these parameters, you can test them without restarting the
  305.     OpenWindows server like this:
  306.     $ psh -i .startup.ps
  307.     Welcome to X11/NeWS Version3
  308.     $ psh -i
  309.     Welcome to X11/NeWS Version3
  310.     /classinit ClassRepeatKeys send
  311.     %%% now press control-D
  312.  
  313.     You can also either of these two files (.startup.ps and .user.ps) to make
  314.     the root window be "retained", so that a PostScript drawing on the
  315.     background won't be erased when you move windows:
  316.     frambuffer /Retained true put
  317.     will do this.  Note that this may increase the amount of memory used
  318.     by the NeWS server (xnews) dramatically.
  319.     
  320.     See also:
  321.     Troubleshooting: It Won't Let Me Type
  322.     Troubleshooting: Is there an easy way to edit Xdefaults?
  323.     Environment Variables
  324.  
  325. @ How can I configure OPEN LOOK for a left-handed mouse and keyboard?
  326.     It's probably best to wait for OpenWindows 3.0, since some of the
  327.     functions are hard-coded and can't be changed.  In the mean-time, you
  328.     can use xmodmap to change the mouse buttons, but be prepared for one
  329.     or two occasional surprises.
  330.  
  331. @ How can I get the screen to go blank when the system is idle?
  332.  
  333.     Run screenblank from /etc/rc.local if you can; it's a boring but effective
  334.     screen saver.  See `man screenblank'.
  335.  
  336. Subject: Key Bindings, Cut and Paste
  337.  
  338. [please tell me if this section is useful! -- Lee, lee@sq.com]
  339.  
  340. @ How do I cut and paste between XTerm and OpenWindows programs?
  341.  
  342.     To go from XTerm to textedit (say):
  343.     * Select the text you want to copy by dragging the SELECT mouse button
  344.       in xterm
  345.     * Press COPY in the XTerm (this key is L6, or Meta+c (the O'Reilly
  346.       XView manual gets this wrong)
  347.     * Move to the textedit window, and press PASTE (L8 or Meta+v)
  348.  
  349.     If this doesn't work, see Troubleshooting: Cut and Paste
  350.  
  351.    To go the other way, from textedit to XTerm:
  352.     * Select the text in textedit.  No need to use COPY
  353.     * Move to the XTerm window and press ADJUST (the middle mouse button).
  354.     * You can also use the COPY/CUT and PASTE buttons.
  355.  
  356. @ COPY/PASTE is boring.     What short-cuts are available?
  357.  
  358.     Quick Copy within textedit, mailtool, etc:
  359.     * Click SELECT to get a text caret where you want the copied text to go
  360.     * Press and HOLD DOWN the PASTE (or CUT) button
  361.     * Select the text you want to copy/move.  You'll see that it's underlined
  362.       or crossed out, as appropriate.  (In the jed demo it goes grey)
  363.     * Let go of the PASTE (or CUT) button.
  364.     * The text you underlined or crossed out appears at the insert caret.
  365.  
  366.     Drag and Drop to Move a Selection
  367.     * Select the text you want to copy or move, by dragging or miltiple-
  368.       clicking the SELECT or ADJUST mouse button
  369.     * Put the mouse pointer anywhere within the selection
  370.     * Press and HOLD DOWN down the SELECT mouse button, and move the mouse
  371.       pointer a little to the right; you'll see the cursor changes to be the
  372.       first 3 letters of the text (or some other icon).
  373.     * Still holding SELECT down, move the mouse over the point where you want
  374.       to drop the text
  375.     * You may see the mouse pointer change to a rifle-sight or target, to show
  376.       that it's OK to drop things here
  377.     * Let go of SELECT, and the text is moved.    This works in text fields of
  378.       dialogue boxes as well as in text subwindows.
  379.  
  380.     Drag and Drop to Copy a Selection
  381.     * This is the same as using Drag and Drop to Move a Selection, except that
  382.       you must hold the CONTROL key down as well as the SELECT mouse button.
  383.  
  384. @ What are the default key bindings in textedit and elsewhere?
  385.  
  386.     See the man page for textedit(1) for some of them.
  387.     In general, the editing/moving commands go in the opposite direction when
  388.     shifted - e.g. Ctrl+w deletes a word, and Ctrl+W deletes the word to the
  389.     right of the insert point.
  390.  
  391.     Meta-i - include file        Meta-f - find selection (forward/backward)
  392.  
  393.     Ctrl-a - start of line        Ctrl-< - back word
  394.     Ctrl-e - end of line        Ctrl-> - forward word
  395.     Ctrl-w - delete word        Ctrl-u - delete to start/END of line
  396.     Ctrl-Return - move to end/START of document
  397.  
  398.     See the O'Reilly XView Reference Manual for a list of some of the default
  399.     keys; see also the olwm or olvwm manual page.
  400.  
  401. @ What can I put in my .ttysrc?     Where is it documented?
  402.  
  403.     See the manual page for shelltool.
  404.  
  405. Subject: Applications: Finding Out...
  406.     Contact SunSoft (or Sun) and ask for the Catalyst OPEN LOOK guide,
  407.     which lists over 200 pages of applications, and also the _huge_
  408.     Catalyst listing of products for Suns, updated six-monthly.
  409.  
  410.     Sun's free CDWare CD/ROMs each contain demo versions of several popular
  411.     OPEN LOOK applications.  Often you can simply contact the vendor
  412.     concerned to have the license upgraded from demo, and receive the full
  413.     product documentation.
  414.  
  415.     SunPICS produces a CD/ROM for NeWSPrint users, Printer's Pallate, which
  416.     contains NeWSprint drivers for a variety of printers and plotters, as
  417.     well as 600 scaleable fonts that you can license.
  418.  
  419.     There is a separate FAQ posting in comp.windows.open-look that lists
  420.     a number of free and commercial aplications; mail lee@sq.com for a
  421.     copy, including OPEN LOOK UI Application List in the Subject for a
  422.     faster reply.
  423.  
  424.  
  425. Subject: Fonts
  426.  
  427. @ Does OpenWindows support Type 1 PostScript fonts?
  428.     Yes, under either Solaris 2.0 or 2.1 (I'm not sure which).               |
  429.     Or, Not Yet, in other words.                                             |
  430.  
  431.     If you have FrameMaker there is a utility to import them, I'm told.
  432.     The 57 fonts supplied with OpenWindows are fully hinted, though, and
  433.     comparing them to the Microsoft Windows and Apple TrueType fonts is
  434.     interesting...  The F3 font format is described in a publication from the
  435.     Sun OpenFonts group, listed in the Bibliography below.  Documentation on
  436.     the unbundled version of TypeScaler is also available from Sun OpenFonts.
  437.  
  438.     You can buy F3 fonts from SunPICS, Monotype, Linotype, URW and probably
  439.     other major foundries.
  440.  
  441.     SunPICS' NeWSPrint software supports Type 1 fonts.                       |
  442.  
  443. @ Improving font rendering time
  444.     Although the Sun type renderer (TypeScaler) is pretty fast, it's not as
  445.     fast as loading a bitmap :-).  You can pre-generate bitmap fonts for sizes
  446.     that you use a lot, and you can also alter and access the font cache
  447.     parameters.     If you have a lot of memory you might want to increase the
  448.     font cache size.
  449.     $ psh -i
  450.     Welcome to X11/NeWS Version3 <--- psh will say this at you
  451.     currentfontmem =    % type this line ...
  452.     300    % and here's whai my server was using -- 300 Kbytes
  453.     1024 setfontmem
  454.     % Just to check:
  455.     currentfontmem =
  456.     1024
  457.     See pp. 328ff of the NeWS 3.0 Programmer's Guide.  You need to say psh -i
  458.     so that the PostScript packages are loaded - see the psh man page.
  459.  
  460. @ Making bitmap fonts for faster startup:
  461.     $ mkdir $HOME/myfonts
  462.     $ cd $HOME/myfonts
  463.     $ makeafb -20 -M $OPENWINHOME/lib/fonts/Bembo.f3b
  464.     Creating Bembo20.afb
  465.     $ convertfont -b Bembo20.afb
  466.     Bembo20.afb->./Bembo20.fb
  467.     Chars parameter greater than number of characters supplied.
  468.     $ ls
  469.     Bembo20.afb    Bembo20.fb    Synonyms.list
  470.     $ bldfamily
  471.     * Bembo               ./Bembo.ff (Encoding: latin)
  472.     cat: ./Compat.list: No such file or directory
  473.     $ xset +fp `pwd`
  474.     $ xset fp rehash
  475.  
  476.     If you want the server to see your new font directory every time,
  477.     add this directory to your FONTPATH environment variable in one
  478.     of your start-up files, e.g. .login or .profile.
  479.  
  480. @ Converting between font formats (convertfont, etc.)
  481.     You can also use Folio fonts with an X11 server, by converting them to a
  482.     bitmap (X11 bdf format) first.  Your licence forbids you from using the
  483.     fonts on another machine, and unless you have NeWSPrint you shouldn't
  484.     use them for printing.  Having said all that...  you can use makeafb and
  485.     convertfont to generate bdf files that you can compile with bdftosnf or
  486.     bdftopcf.
  487.  
  488.     Use mftobdf (from the SeeTeX distribution) to convert TeX pk fonts to
  489.     X11 bdf format, which you can then use with either X11 or OenWindows.
  490.  
  491.     You can also use der Mouse's "getbdf" to get bdf fonts from a running    +
  492.     X display server - ftp: larry.mcrcim.mcgill.edu (132.206.1.1) /X/getbdf  +
  493.  
  494. @ Xview/OLIT fonts at 100 dpi
  495.     There aren't any.  More precisely, the various text fonts, such as
  496.     Lucida Typewriter Sans, are available at 100 dpi, and in fact are
  497.     scalable under OpenWindows.     The glyph fonts are bitmaps, and don't
  498.     scale very well.
  499.  
  500. Subject: Troubleshooting: It Won't Let Me Type
  501.  
  502. @ When I try to type into some programs, I just get beeps or nothing happens
  503.     It is a good idea to include at least:
  504.     OpenWindows.FocusLenience:    true
  505.     *Input: TRUE
  506.     in your .Xdefaults file, as these allow non-ICCCM-compliant programs to
  507.     receive input even if they forget to ask for it.
  508.     See the next item for editing .Xdefaults
  509.  
  510. Subject: Troubleshooting: Cut and Paste not working
  511.  
  512. @ I can't paste between xterm and XView or deskset programs
  513.     Under OpenWindows 2, you need to add the following either to your
  514.     $HOME/.Xdefaults file, or to $OPENWINHOME/lib/app-defaults/XTerm instead:
  515.  
  516.     XTerm*VT100.Translations: #override \
  517.         <Key>L6:select-set(CLIPBOARD)\n\
  518.         <Key>L8:insert-selection(CLIPBOARD)
  519.   
  520.     You must not move the mouse between ending the selection and pressing
  521.     L8 (the Paste key)!
  522.  
  523.     Under OpenWindows 3, this is already in the app-defaults file, so if it
  524.     isn't working, check that XFILESEARCHPATH is set to
  525.     /usr/openwin/lib/%T/%N%S
  526.     and if it isn't, either set it or copy/merge the above lines from
  527.     $OPENWINHOME/lib/app-defaults/XTerm into /usr/lib/X11/app-defaults/XTerm.
  528.     [See also: Environment Variables]
  529.  
  530.     This version automatically puts each xterm selection onto the clipboard:
  531.     XTerm*VT100.translations: #override\n\
  532.         ~Ctrl ~Meta<Btn2Up>: insert-selection(PRIMARY,CUT_BUFFER0)\n\
  533.         ~Ctrl ~Meta<BtnUp>: select-end(PRIMARY,CUT_BUFFER0,CLIPBOARD)\n\
  534.         <KeyPress>L8: insert-selection(CLIPBOARD)
  535.     [Note: be sure that the \n\ is at the very end of the line, there must
  536.      be no following spaces, and any + or | signs showing that this FAQ file
  537.      was altered must also be removed!]
  538.  
  539.     Adding the lines
  540. <Key>L10: start-extend() select-end(PRIMARY, CLIPBOARD, CUT_BUFFER0)\n\
  541.        <KeyRelease>L10: kill-selection() \n
  542.     will even make L10 (CUT) work as a cut key! [untested]
  543.  
  544.     If you alter $HOME/.Xdefaults instead, you must use what X calls a
  545.     `more specific' resource name:
  546.     xterm.vt100.translations
  547.     will do.
  548.  
  549. @ I always get the same piece of text whn I press PASTE (L8, Meta+v)
  550.     Remove the file /tmp/textsw_shelf and see if that helps; see also the
  551.     next item.
  552.  
  553. * Cut Copy and Paste don't work at all (OpenWindows only)
  554.     Oh dear.  Use ps -xuaww | grep xv  to check that sv_xv_sel_svc is running
  555.     and that either you or root started it, depending on whether you started
  556.     OpenWindows with "openwin" or by logging in through xdm.
  557.     If not, start it.  If it dies, check that there is no /tmp/.sv_xv_sel_svc
  558.     before restarting it - you may need to be root to remove it, or you can
  559.     reboot your workstation.
  560.     Check that there is space in /tmp (use "df /tmp"), and also see if there
  561.     are a lot of files there with names like /tmp/tty.txt.a01246; if there are
  562.     several hundred of them, cut and paste may take so long that it times out.
  563.  
  564.     Quit any deskset tools such as mailtool, filemgr and cm (calendar), start
  565.     a terminal emulator and remove and /tmp/tty.txt* and /tmp/Text* files
  566.     that are still there.  It's simplest to quit openwin and start it again
  567.     after doing that, if cut and paste was broken, but if it starts working
  568.     again you can just carry on.  Note that files in /tmp not owned by you
  569.     might be in use by another worker comrade, so don't remove thos without
  570.     checking first!
  571.  
  572. Subject: Troubleshooting: Not authorized to use display
  573.  
  574.     If you get error messages that look like
  575.     Xlib:  connection to ":0.0" refused by server
  576.     Xlib:  Internal error during connection authorization check
  577.     Error: Can't Open display
  578.     try, on the machine running OpenWindows or X11,
  579.     xhost +machine
  580.     where "machine" is the computer on which you ran the command that failed.
  581.     If you want to let other users run programs on the same machine as you,
  582.     using your display, you will have to type the bizarre-looking
  583.     xhost +`hostname`
  584.     (or xhost +happyboy, if happyboy is the name of your workstation).
  585.     This lets ANY user on `happyboy' access your display.
  586.  
  587.     With OpenWindows 3.0 you can also use xauth, and the Programmer's Guide 
  588.     describes how to do this in Chapter 8, p. 101.  This is more secure.
  589.     [Also note that there is a CERT advisory notice and a Sun patch for users
  590.     of OpenWindows 3.0 under SunOS 4.1.1 to fix a serious security problem.]
  591.  
  592.     On an X Terminal, there may be a setup menu that lets you change or
  593.     disable the list of hosts that can access the display.
  594.  
  595.     If you start getting this message after you've been logged in overnight,
  596.     there might be a cron job that's removing the Unix sockets in /tmp
  597.     that are used to communicate with the server when $DISPLAY doesn't have
  598.     a hostname before the :, or is empty.  Have the system administrator
  599.     change the cron script to skip sockets.
  600.  
  601. Subject: Trouble Shooting: other common problems
  602.  
  603. @ I get console error messages on my screen and they don't go away (Sun 3 or 4)
  604.     If "refresh" makes the messages vanish, but new ones come along later,
  605.     you need to run "xterm -C" from your .xinitrc, or start one up in
  606.     the background and then  choose Save Workspace from the
  607.     Workspace->Utilities menu.  Better still, pick up "contool" and run
  608.     that.  Get it from export.lcs.mit.edu in the contrib directory.  It
  609.     will monitor the console and open, flash its icon or beep when a
  610.     message appears; it's very easy to configure.
  611.  
  612.     If "refresh" from the Workspace->Utilities menu doesn't make the messages,
  613.     go away...
  614.     a Sun with a cg4 frame buffer has two screens - you can move the
  615.     mouse off the right-hand (by default) edge of the screen and onto
  616.     a whole new (but monochrome) display, called ":0.1".  See the man.
  617.     page for openwin; I have a shell script that checks for this and,
  618.     if there's a /dev/cgfour0, does
  619.         openwin -dev /dev/cgfour0 -dev /dev/bwtwo0
  620.     If you are running X11 or OpenWindows 2, you might need to add this
  621.     to your .xinitrc or other startup file:
  622.     (
  623.         eval `svenv -display unix:0.1 -env`
  624.         olvwm -display unix:0.1
  625.     ) &
  626.     Later releases of olwm and olvwm do this automatically.
  627.     You can also run switcher -e 0 to get rid of the messages.  Also, see
  628.     the note about contool, above.
  629.  
  630. @ Is there an easy way of editing .Xdefaults?
  631.     Use `props', which appears in the default root menu as `properties'.
  632.     This starts `props', a property editor which will re-write your
  633.     .Xdefaults after removing comments.  It then applies any changes.
  634.     Keep comments by using "comment." instead of "!", for example,
  635.     comment.*.font: Palatino-Italic-37
  636.  
  637. @ How do I get the File manager to use emacs instead of textedit?
  638.     set the default editor to
  639.     sh -c "exec emacs -font lucidasanstypewriter-18 \"$FILE\""
  640.     (you can change the font if you prefer a smaller one)
  641.  
  642. @ How do I run OpenWindows in inverse video?
  643.     This tends not to work under OpenWindows 2.     With OpwnWindows 3.0,
  644.     there are various ways, including using -bg and -fg options.  If you're
  645.     using OpenWindows 2 on a Sun 3 , probably the best you can do (short of
  646.     upgrading the workstation to a SPARC!) is to use xterm instead of cmdtool.
  647.  
  648. @ Why don't flat check-boxes work?
  649.     A known bug may make Guide's output dump core if you use these.
  650.     A workaround is to edit the Guide output, as it's only Guide's output
  651.     that's broken, not the actual check-box code.
  652.     This applies only to versions of DevGuide before Devguide 3.0.  If you're
  653.     still using an ancient DevGuide, you should upgrade as soon as possible;
  654.     the new one is fantastic!
  655.  
  656. @ When I leave OpenWindows, my screen goes blank or my mouse cursor stays
  657.   on the screen.
  658.     Try running clear_colormap; if this helps, put it as the last line in
  659.     the shell script you use to start OpenWindows (e.g. `openwin').
  660.  
  661. @ When I use snapshot, the system crashes, or the server hangs, or something.
  662.     This was a bug related to some systems only.  The only work-round was to
  663.     use some other screen dump program, such as xwd, xv 2.21 or xgrabsc.
  664.     
  665. @ Why have some of my function keys stopped working?
  666.     Keys F11 and F12 changed from SunF36 and SunF37 to SunXK_F36 and SunXK_F37
  667.     respectively in OpenWindows 3.  Applications must be recompiled, or you
  668.     might be able to use xmodmap or the public domain xkeycaps program to
  669.     change your keyboard layout back again.
  670.  
  671. @ When I type shelltool or cmdtool or textedit, I get the Sunview version
  672.     Set your path so that $OPENWINHOME/bin and $OPENWIN/bin/xview come before
  673.     /bin (or /usr/bin, they're the same), or you'll get the SunView versions
  674.     of mailtool, cmdtool, shelltool, etc.
  675.  
  676.     (see also next item)
  677.  
  678. @ Mixing X11 and OpenWindows
  679.     (see also next item)
  680.  
  681.     Note that OpenWindows 3.0 includes the X11R4 core distribution (to patch
  682.     level 18), but not the contrib directory.  These notes apply to
  683.     OpenWindows 2.0, although you could also the same sort of thing with
  684.     OpenWindows 3.0 and X11R5.
  685.  
  686.     Install the X11 libraries in /usr/lib/X11.    You can intermix OpenWindows
  687.     and X11R4 or X11R5, they're all compatible in this respect.
  688.     Put the X11 binaries in (for example) /usr/bin/X11.
  689.  
  690.     Put /usr/bin/X11 last in your PATH, so that you get OpenWindows versions
  691.     of programs instead of X11 ones where appropriate, although this is a
  692.     matter of preference.  In any event, put the OpenWindows bin directory
  693.     first -- see the preceding item for more details on that.  If you have
  694.     /bin (or /usr/bin, they're the same directory on SunOS) earlier in
  695.     your PATH than $OPENWINHOME/bin/xview, you'll get SunView programs instead
  696.     of OpenWindows ones!
  697.  
  698.     Set LD_LIBRARY_PATH so that /usr/openwin/lib is last, after the X11
  699.     library directory.    This doesn't matter with OpenWindows 3.0, but with
  700.     older versions you'll get error messages from X11 programs if you don't
  701.     do this.  The messages are generally harmless (see next item), although
  702.     xdm core dumps if this isn't right.
  703.  
  704.     Set OPENWINHOME to the directory containing OpenWindows if it isn't
  705.     /usr/openwin.
  706.  
  707.     See Also:
  708.     Environment Variables
  709.  
  710. @ I get error messages on my screen about ld.so: libX11.so.4 not found
  711.     set LD_LIBRARY_PATH to be /usr/openwin.  If you also use X11, use
  712.          /usr/lib:/usr/5lib:/usr/openwin/lib
  713.     If you put this in a shell script or your .profile, use
  714.     ${OPENWINHOME-/usr/openwin}/lib instead of /usr/openwin; this is for
  715.     /bin/sh; for csh it is different.
  716.  
  717. @ I launch my filemgr and I get ld.so:map heap error (9) at /dev/zero
  718.     Your system needs to be patched.  Look in $OPENWINHOME/lib/OSpatches
  719.     and install the patch.
  720.  
  721. @ Why doesn't AnswerBook run for me?
  722.     You must be running OpenWindows to use AnswerBook.    It won't run under
  723.     X11 (on an X terminal or on anything else) because it uses NeWS to draw
  724.     the PostScript text and pictures.
  725.     If you are using OpenWindows 3.0, you need to use the OpenWindows 3.0
  726.     compatible navigator; it's called .navigator.ow3 on the AnswerBook CD/ROM.
  727.     If all AnswerBook users are using OpenWindows 3.0, you can replace
  728.     navigator wih .navigator.ow3 altogether (rename the old one first to
  729.     satisfy your sense of paranoia!)
  730.     The navigator.ow3 binary is also on CD/Ware Vol 2.
  731.  
  732. @ Why aren't there any fish in realxfishdb?
  733.     A fixed version of realxfishdb is available by ftp from
  734.     ftp.eng.auburn.edu [131.204.10.91] as /pub/xrealfishdb.Z
  735.  
  736. @ Why is the Properties choice disabled in the Window menu?
  737.     It isn't implemented yet.  Many programs do respond to the Properties
  738.     Key (L3), though, or have a pop-up menu with Properties on it.
  739.  
  740. @ File completion in the C-shell is broken in cmdtool
  741.     Sadly true, but use shelltool or xterm instead and it's fine.  It also
  742.     works if you run command tool on a remote machine.
  743.     Fixed in OpenWindows 3.0.1 shipped with Solaris 2.
  744.  
  745. @ When I run OLIT programs, some of the widgets are red!
  746.     Release 3 of OLIT added mouseless operation; action widgets can be
  747.     selected via the keyboard.  The currently selected item is highlighted
  748.     in red (the `Red Stain') to show that it has the input focus.
  749.     To disable it in most places, add this to your $HOME/.Xdefaults file:
  750.     *traversalOn: off
  751.     *TextEdit.traversalOn: on
  752.     *TextField.traversalOn: on
  753.     You can change the colour using (for example)
  754.     *InputFocusColor: grey50
  755.     *input*FocusColor: green
  756.     See the man page resources(3w), at the start of the OLIT 3 Widget Set
  757.     Reference Manual included in the OpenWindows 3 programmer documentation.
  758.     There is an OLIT `Jumbo Patch' that lets you make the Red Stain go away
  759.     altogether; I assume that this is available from Sun.
  760.  
  761. @ XDM breaks things
  762.     Command tool doesn't like being run without a Unix `controlling terminal'.
  763.     Use /etc/setsid to start your command tools and all will be well.
  764.     SunView applications may need to be run with svenv, as in
  765.     svenv -exec /usr/bin/traffic
  766.     because xdm won't set the necessary environment variables.
  767.     Note that the MIT xdm starts up the X server as root, which is a security
  768.     hole for OpenWindows; use the OpenWindows 3.0 xdm or be aware that your
  769.     users can access files and start Unix processes ass root...
  770.  
  771. @ Function keys 11 and 12 stopped working
  772.     In OpenWindows 3.0, the X11 names ("keysyms") for these keys was changed
  773.     to SunXK_F36 and SunXK_F37.     Code which uses them should be recompiled,
  774.     or you might be able to get away with
  775.     xmodmap -e 'keysym SunXK_F36 = SunF36'
  776.  
  777. Subject: Trouble Shooting: XView problems
  778.     This section is here only until an XView FAQ appears, which has been
  779.     promised, but hasn't reached here.    Note that there is also a usenet
  780.     newsgroup, alt.toolkits.xview, although it doesn't sem to have very
  781.     wide distribution and has triffic of the order of one or two articles
  782.     per month.    You should also look at the FAQ in comp.windows.x.
  783.  
  784. @ how do I set the font of individual Scrolling List items?
  785.     PANEL_LIST_FONT takes an int row_number and an Xv_opaque font_handle.
  786.     PANEL_LIST_FONTS take a NULL terminated list of Xv_opaque font_handles.
  787.     There is no easy way to make an entire list fixed width font.
  788.     You have to make sure that you always specify PANEL_LIST_FONT when you
  789.     insert a new row into that list, or write a convenience function
  790.     insert_row(list, row, string) that hides the nasty bits.
  791.  
  792. @ how do I keep an XView pop-up window displayed after a button is pressed?
  793.     In the button callback, do
  794.         xv_set(button, PANEL_NOTIFY_STATUS, XV_ERROR, NULL);
  795.     This will keep the window visible.
  796.  
  797. @ how do I make an XView button look pressed?
  798.     call panel_begin_preview() and panel_cancel_preview(); these are
  799.     documented in -- er -- the XView 3 source...
  800.  
  801. @ OpenWindows 3 imake doesn't work properly
  802.     Here is Greg Earle's patch, to be applied in $OPENWINHOME; note that you
  803.     should edit lib/config/sun.cf afterwards to get OSName and
  804.     OSMinorVersion right (MinorVersion is 1 in SunOS 4.1.2, for example).
  805.     I have edited the patch a little, so any bugs are mine [lee@sq.com] :-)
  806.  
  807. *** bin/xmkmf.orig    Wed Sep 18 07:02:02 1991
  808. --- bin/xmkmf    Tue Aug  6 00:39:20 1991
  809. ***************
  810. *** 30,34 ****
  811.   
  812.   elif [ -n "$OPENWINHOME" ]; then
  813. !     args="-DUseInstalled "$OPENWINHOME/lib/config
  814.   
  815.   else
  816. --- 30,34 ----
  817.   
  818.   elif [ -n "$OPENWINHOME" ]; then
  819. !     args="-I$OPENWINHOME/lib/config -DUseInstalled -DXCOMM="/**/#"
  820.   
  821.   else
  822. *** lib/config/site.def.orig    Wed Sep 18 01:26:19 1991
  823. --- lib/config/site.def    Tue Aug  6 00:44:37 1991
  824. ***************
  825. *** 0 ****
  826. --- 1,7 ----
  827. + #define BinDir $(OPENWINHOME)/bin
  828. + #define LibDir $(OPENWINHOME)/lib
  829. + #define IncRoot $(OPENWINHOME)/share/include
  830. + #define InstallNonExecFile(file,dest)                    @@\
  831. + install:: file                                @@\
  832. +     $(INSTALL) -c $(INSTDATFLAGS) file dest
  833. + #define NullParameter
  834.  
  835. [Note: the patch is new, but I have not marked each line with a "+" -- Liam]
  836.  
  837. Subject: Environment Variables
  838.  
  839.     Environment variables, and plausible values to use -- this list doesn't
  840.     take into account any local changes that you might have made, of course.
  841.     This list is for OpenWindows 3.0 -- differences for OpenWindows 2.0 are
  842.     marked, and I've added some comments for users of X11R4 and X11R5, too.
  843.  
  844.     DISPLAY  The name of the X Windows Display to use
  845.     :0.0 (on the local machine, the one actually running X11 or xnews)
  846.     :0.1 (on some machines for a second, monochrome screen)
  847.     machine-running-unix:0.0 (on other machines)
  848.     (You may need to do "xhost +other-machine" to let programs on other
  849.     machines use your display; see also under Troubleshooting, and see
  850.     the section on xauth in the OpenWindows Version 3 Programmer's Guide,
  851.     pp. 101ff)
  852.     See also: console messages, under Trouble Shooting
  853.     FONTPATH  Where xnews searches for fonts
  854.     /usr/openwin/lib/fonts
  855.     (you can also use "xset fp+ dir" to add a directory to the font path,
  856.     but you may have to do "xset fp rehash" afterwards.  This is fine
  857.     under OpenWindows, but many X11 servers have font problems)
  858.     HELPPATH  Where XView looks when you press the Help key (or F1)
  859.     /usr/openwin/lib/locale:/usr/openwin/lib/help
  860.     (On SunOS 4.0.*, or with OpenWindows 2.0, omit the first entry, which
  861.     is for sites using a local other than "C" or "USA").
  862.     LD_LIBRARY_PATH   Where to look to find shared C libraries
  863.     /usr/lib:/usr/5lib:/usr/openwin/lib:/usr/CC/`arch`
  864.     (the /usr/CC/`arch`/lib entry is only needed if you use C++ programs)
  865.     OPENWINHOME     Where OpenWindows lives
  866.     /usr/openwin  
  867.     KEYBOARD, MOUSE -- serial devices to use instead of the console
  868.     (don't set these for normal use; /dev/kbd and /dev/mouse)
  869.     PATH  Where the Shell searches for programs to run
  870.     $(OPENWINHOME)/bin:$(OPENWINHOME)/bin/xview:/usr/local/bin:.\
  871.     $HOME/bin.`arch`:/usr/ucb:/usr/bin:/usr/bin/X11:/usr/hosts:\
  872.     (you will certainly want to change this example!  There is no
  873.     $(OPENWINHOME)/bin/xview in OpenWindows 3.0)
  874.     XFILESEARCHPATH  Where programs look for app-defaults files
  875.     /usr/openwin/lib/%T/%N%S
  876.         (This is set automatically by "openwin" in OpenWindows 3.0)
  877.         You might want to use /usr/lib/X11/%T/%N%S, or perhaps both,
  878.         separated with a :, for example (for sh users)
  879.             XFILESEARCHPATH=$OPENWINHOME/lib/%T/%N%S:/usr/lib/X11/%T/%N%S
  880.         export XFILESEARCHPATH
  881.  
  882. Subject: Where Can I get It? Ftp, implementations, etc...
  883.  
  884.     XView 3.0 is available by anonymous ftp from export.lcs.mit.edu and
  885.     elsewhere.
  886.  
  887.     MoOLIT can be bought from AT&T in source form.                           |
  888.  
  889.     OpenWindows can be obtained from Sun, or you can get the source from
  890.     Interactive Systems Inc.  It is also included in some vendors' System V
  891.     Release 4 implementations, although that's not always the latest version.
  892.     The current release of OpenWindows from Sun for supported architectures
  893.     is 3.0; for the Sun 3 series it is frozen at OpenWindows 2.0.
  894.     Note that Sun includes OpenWindows with SunOS, and it is also included as
  895.     the windowing system for Solaris.
  896.  
  897.     There are said (by Sun) to be over 35 ports of OpenWindows either        |
  898.     available now or in progress.  Unfortunately, none of them seem to be    |
  899.     available from anywhere.  Contact anthony@ovi.com for more information.  |
  900.  
  901.  
  902. Subject: Bibliography: books, manuals, journals, papers, beer-mats
  903.  
  904.     The OPEN LOOK (tm) Graphical Interface is documented in two books:
  905.     Sun Microsystems Inc., `OPEN LOOK Graphical User Interface Application
  906.     Style Guidelines', Addison Wesley, 1989
  907.     and
  908.     Sun Microsystems Inc., `OPEN LOOK Graphical User Interface Functional
  909.     Specification', Addison Wesley
  910.  
  911.     The Main documentation for the X Window system comes from
  912.     O'Reilly & Associates in about nine or ten volumes.
  913.     The most useful for OPEN LOOK users are:
  914.     Volume 1: XLib Programming Manual
  915.     Volume 2: XLib Reference Manual
  916.     Volume 3: X Window System User's Guide
  917.         (An OPEN LOOK edition of Volume 3 should appear later this year)
  918.     Volume 7: XView Programmer's Manual [Dan Heller]
  919.         [make sure you get the 3rd edition for XView 3.0]
  920.     Companion to Volume 7: XView Reference Manual [Ed. Thomas Van Raalte]
  921.  
  922.     The Companion to Volume 7 is an expanded version of the Attribute
  923.     Summary from the previous edition of the XView Programming Manual,
  924.     together with other reference information, so that in practice you
  925.     have to buy both books.
  926.  
  927.     O'Reilly also have a thinnish orange book on the differences between
  928.     X11R4 and RX115.
  929.  
  930.     OLIT programmers will also want the Xt books - volumes 4 and 5.
  931.     There is a new big fat green Vol 5 updated for X11R5.
  932.  
  933.     A journal, The X Resource, may also be of interest.
  934.  
  935.     O'Reilly & Associates, 103 Morris Street, Suita A, Sebastopol, CA 95472
  936.     +1 707 829-0515, or, in the USA and Canada only, 1-800-998-9938
  937.     Fax: +1 707-829-0104.
  938.     Email nuts@ora.com or uunet!ora!nuts.
  939.     For other distributors: mail, FAX, or call +1 707-829-0515.
  940.  
  941.     Some of the O'Reilly examples are available fro ftp from
  942.     export.lcs.mit.edu in the contrib/OReilly directory.
  943.  
  944.     The System V Release 4 Documentation from Prentice Hall may also include
  945.     a section on OpenWindows.
  946.  
  947.     David Miller describes programming with OLIT in his
  948.     `An OPEN LOOK At Unix' (M&T press).
  949.     
  950.     Nabajyoti Brkakati gives an excellent introduction to X and to OLIT
  951.     programming, as well as setting up and using X and OpenWindows, in:
  952.     `Unix[R] Desktop Guide to OPEN LOOK'
  953.     SAMS, 1992  ISBN 0-672-30023-0
  954.     You can get the examples from this book as
  955.         export.lcs.mit.edu:contrib/naba-olguide-examples.tar.Z
  956.  
  957.     Also about using OLIT, and Xt in particular:
  958.     The X Window System: Programming and Applications with Xt,
  959.     OPEN LOOK Edition,
  960.     Doug Young and John Pew, Prentice Hall, 1992,
  961.     ISBN 0-13-982992-X
  962.     There are also HP Widgets and Motif (ugh) versions of this book.
  963.     The example source code in this book can be obtained by ftp from
  964.     export.lcs.mit.edu, file "contrib/young.pew.olit.Z".
  965.  
  966.     There is an introduction to XView in
  967.     `Writing Applications For Sun Systems', Vol 1, `A Guide for
  968.     Macintosh(R) Programmers' (Sun Microsystems, pub. Addison Wesley)
  969.     
  970.     To learn more about the NeWS and PostScript languages, see
  971.  
  972.     The NeWS Book, Springer Verlag, 1989 (sadly, a little out of date)
  973.  
  974.     PostScript Language Reference Manual, Second Edition,
  975.     Adobe Systems Inc., Addison Wesley, 1990 ["the Red Book"]
  976.         Note that OpenWindows 3 is a level 1 PostScript implementation,
  977.         with certain Level 2 features (such as Composite Fonts) to some
  978.         degree.
  979.     
  980.     PostScript Language Tutorial and Cookbook,
  981.     Adobe Systems Inc., Addison Wesley, 1985 ["The blue book"]
  982.     
  983.     There's at least one book on using Solaris (i.e. SunOS).
  984.  
  985.     Sun also supplies a large amount of documentation with OpenWindows,
  986.     although you may have to order it separately.  Here's what I have; they
  987.     are each a little over 21 cm square (wider than A4 paper), and vary from
  988.     about 1 cm to about 3cm thick.  They say `User's Guide' or `Programmer's
  989.     Guide' on the front.  The User manuals have a red stripe on the bottom,
  990.     and the Programmer ones have a green stripe.
  991.  
  992.     800-6006-10 OpenWindows Version 3 Release Manual
  993.     800-6029-10 OpenWindows Version 3 Installation and Start-Up Guide         |
  994.     800-6231-10 OpenWindows Version 3 DeskSet Reference Guide                |
  995.     800-6618-10 OpenWindows Version 3 User's Guide
  996.     800-6323-10 Desktop Integration Guide [also available in bookstores?]
  997.     800-6027-10 Programmer's Guide
  998.     800-6005-10 OpenWindows Version 3 Reference Manual [the man pages]
  999.     800-6319-10 The NeWS Toolkit 3.0 Reference Manual
  1000.     800-6736-10 NeWS 3.0 Programming Guide
  1001.     800-6055-10 OLIT 3.0 Widget Set Reference Manual
  1002.     800-6198-10 XView 3.0 Reference Manual: Converting SunView Applications
  1003.  
  1004.     800-6854-10 F3 Font Format Specification [order separately]
  1005.  
  1006.     There are also some other sets of documentation, including the TypeScaler
  1007.     documentation from the OpenFonts group, for example.  There doesn't seem
  1008.     to be a complete list anywhere.
  1009.  
  1010.     ??????????? ToolTalk 1.0 Setup and Administration Guide (SunSoft, 1991)
  1011.     800-6093-10 ToolTalk 1.0 Programmer's Guide (SunSoft, 1991)
  1012.     There might be documentation about the Link Manager somewhere, too.
  1013.  
  1014.     AT&T includes several large thorny bushes' worth of paper with OLIT.
  1015.  
  1016.     Sun's AnswerBook CD/ROM contains a lot of the above documentation,
  1017.     including some of the O'Reilly books (not the XView 3 Volume 7, though).
  1018.  
  1019.     Volume 8 of the O'Reilly series is about X Administration, and mentions  +
  1020.     OpenWindows, although it is primarily aimed at X11R5.                    +
  1021.  
  1022.     Several other books are in the works...
  1023.  
  1024.  
  1025. Subject: Getting this File, Revision History, Recent Changes
  1026.  
  1027.     Mail lee@sq.com to ask for it.  Douglas N. Arnold (dna@math.psu.edu)
  1028.     keeps an up-to-date copy on ftp.math.psu.edu (currently 128.118.24.22) in
  1029.     the file ~ftp/pub/FAQ/open-look.
  1030.     The net.answers archives and servers may or may not know about this file,
  1031.     since they've just changed hands and this file was previously in one
  1032.     archive but not the other.
  1033.  
  1034.     $Id: open-look.faq,v 1.40 92/11/04 23:22:27 lee Exp $
  1035.  
  1036.  
  1037. Acknowledgements:
  1038.     Ian Darwin <ian@sq.com>
  1039.     Charles Ditzel <Charles.Ditzel@West.Sun.COM>
  1040.     Rick Heli <Rick.Heli@Eng.Sun.CO>
  1041.     Larry W. Virden <lvirden@cas.org>
  1042.  
  1043.     And many others...    You get deleted from this list after a while.
  1044.  
  1045.  
  1046. -- 
  1047. lee@sq.com (Liam Quin) the barefoot programmer; SoftQuad Inc +1 416 239 4801
  1048.  OPEN LOOK UI FAQ; Metafont list; HexSweeper NeWS game; lq-text text retrieval
  1049. ``They thought him, and they justly thought him, one   [lq-text-request@sq.com
  1050.   Sent to do more than he appeared to have done.''   Wm. Cowper, Conversation
  1051.