home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / open-look / 01-general next >
Encoding:
Text File  |  1997-07-25  |  57.1 KB  |  1,267 lines

  1. Newsgroups: comp.windows.open-look,alt.toolkits.xview,comp.windows.news,alt.toolkits.intrinsics,comp.answers,alt.answers,news.answers
  2. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!spool.mu.edu!uwm.edu!vixen.cso.uiuc.edu!news-peer.sprintlink.net!news-sea-19.sprintlink.net!news-in-west.sprintlink.net!news.sprintlink.net!Sprint!newsfeed.direct.ca!news.uunet.ca!gts!lethe!geac!sq!lee
  3. From: lee@sq.com (Liam Quin)
  4. Subject: OPEN LOOK GUI FAQ 01/04: General
  5. Message-ID: <liamfaq-ol1-63@sq.com>
  6. Followup-To: poster
  7. Summary: overview of OPEN LOOK Graphical User Interface
  8. Supersedes: <liamfaq-ol1-62@sq.com>
  9. Reply-To: lee@sq.com (Liam R. E. Quin)
  10. Organization: SoftQuad Inc., Toronto, Canada
  11. Date: Thu, 24 Jul 1997 22:06:08 GMT
  12. Approved: news-answers-request@MIT.EDU
  13. Expires: Sun, 24 Aug 1997 02:49:16 GMT
  14. Lines: 1251
  15. Xref: senator-bedfellow.mit.edu comp.windows.open-look:12919 alt.toolkits.xview:4460 comp.windows.news:5960 comp.answers:27241 alt.answers:27809 news.answers:108105
  16.  
  17. Archive-name: open-look/01-general
  18. Last-Modified: Apr 3 23:55
  19.  
  20. Frequently-asked questions about the OPEN LOOK Graphical User Interface.
  21.  
  22. If your question isn't here, please try (at *least*)
  23.     man openwin
  24.     man xnews
  25.     man 7 xview
  26. and looking in the appropriate manuals listed in the Bibliography below
  27. before posting to the comp.windows.open-look, comp.windows.x or
  28. alt.toolkits.xview newsgroups and/or their corresponding mailing lists.
  29.  
  30. Frequently Asked Questions for X11 are posted to comp.windows.x monthly.
  31.  
  32. This is version: $Revision: 1.58 $; Last posted version:  1.48
  33.  
  34. Contents: (in rn and trn you can use control-G to go to the next topic)
  35.  
  36.     Subject: Terminology: OPEN LOOK, OpenWindows, X11, XView, (MO)OLIT, Motif
  37.     Subject: The COSE agreement
  38.     Subject: Window Managers -- olwm, olvwm
  39.     Subject: OpenWindows, Terminals, and Other Displays
  40.     Subject: Configuration Files: Getting started with OpenWindows
  41.     Subject: Key Bindings, Cut and Paste
  42.     Subject: Applications: Finding Out...
  43.     Subject: DeskSet, Calendar Manager, etc.
  44.     Subject: Trouble Shooting: Strange Error Messages
  45.     Subject: Trouble Shooting: It Won't Let Me Type
  46.     Subject: Trouble Shooting: Not authorized to use display
  47.     Subject: Trouble Shooting: other common problems
  48.     Subject: Trouble Shooting: XView problems
  49.     Subject: Fonts
  50.     Subject: Environment Variables
  51.     Subject: Where Can I get It? Ftp, implementations, etc...
  52.     Subject: Bibliography -- books, manuals, journals, papers, beer-mats
  53.     Subject: Getting this File, Revision History, Recent Changes
  54.  
  55.  
  56. Subject: Terminology: OPEN LOOK, OpenWindows, X11, XView, OLIT, MOOLIT, Motif
  57.  
  58. @ What is OPEN LOOK?
  59.     OPEN LOOK is a specification of a Graphical User Interface (GUI).
  60.     A GUI determines the `look and feel' of a system -- the shape of
  61.     windows, buttons and scroll-bars, how you resize things, how you
  62.     edit files, etc.
  63.  
  64.     The OPEN LOOK GUI is specified, developed and maintained jointly by
  65.     Sun Microsystems and AT&T (or USL?).
  66.  
  67.     See Also:
  68.     Bibliography
  69.  
  70. @ What is OpenWindows?
  71.     OpenWindows is Sun's name for its windowing environment; the current
  72.     version conforms to the OPEN LOOK Graphical User Interface Specifications
  73.     (a later version will use OSF/Motif and CDE).
  74.     It's compatible with the X11 window system from MIT;
  75.     the SunOS 4.x versions of OpenWindows are compatible with Sun's NeWS and
  76.     SunView.  SunOS 5.x (Solaris 2) versions of OpenWindows after Solaris 2.2
  77.     use MIT X11R5 and include Adobe's DPS/X Display PostScript, which is
  78.     (in brief) a small subset of NeWS for displaying PostScript files.
  79.  
  80.     OpenWindows is sometimes also called openwin or xnews, after the
  81.     program used to start it and the main executable itself, respectively.
  82.     It should not be called `Windows' or 'OPEN LOOK' or `OpenLook', as
  83.     these terms are either wrong or apply to something else.
  84.  
  85.     The current versions of OpenWindows for various platforms are:
  86.     SunOS 4.1.1 on Sun 3: 2.0
  87.     Solaris 1.x (SunOS 4.1.x) on SPARC: 3.0
  88.     Solaris 2.4 (SunOS 5) on SPARC: 3.4
  89.  
  90.     See Also:
  91.     Mixing X11 and OpenWindows
  92.     Where can I get it?
  93.  
  94. @ What are OLIT, XView and TNT?
  95.     These are all toolkits for programmers to use in developing programs
  96.     that conform to the OPEN LOOK specifications.  See the Bibliography
  97.     for documentation on the individual toolkits.  Here's a brief summary:
  98.  
  99.     OLIT was AT&T's OPEN LOOK Intrinsics Toolkit for the X Window system;
  100.     it used a widget set, and was probably the easiest for people who were
  101.     already X11/Xt programmers to learn.  You could buy the source from AT&T,
  102.     although you didn't get the same version tht Sun ship.  Sun includes the
  103.     OLIT library in OpenWindows (q.v.); it is also often included in
  104.     System V Release 4.  It was written in C.  OLIT support passed to USL
  105.     (then a division of AT&T, now owned by Novell), who replaced it with
  106.     MoOLIT (q.v.).
  107.     Note that because of the nature of Xt subclassing, you will probably
  108.     want or need OLIT source in order to develop a large application or
  109.     anything else that uses subclasses.
  110.     [see the proceedings of the 1991 X Technical Conference]
  111.     OLIT was until recently Sun's recommended toolkit, although until
  112.     Solaris 2 was released OLIT lacked a long way behind XView (q.v.) in
  113.     many important areas.
  114.  
  115.     XView is Sun's toolkit for X11, written in C.  XView is similar in
  116.     programmer interface to SunView.  There's even a shell script to help
  117.     migrate source code from SunView to XView.     XView is often said to be
  118.     the easiest toolkit to learn if you are not familiar with X Windows.
  119.     The XView toolkit is included in OpenWindows, and full source is
  120.     available by anonymous ftp from ftp.x.org (and elsewhere).
  121.     The current version of XView from Sun is 3.2.  The XView toolkit is
  122.     still supported by Sun, although few if any enhancements beyond version
  123.     3.2 should be expected.
  124.  
  125.     The NeWS Toolkit (TNT) was an object-oriented programming system based
  126.     on the PostScript language and NeWS.  TNT implements many of the
  127.     OPEN LOOK interface components required to build the user interface of
  128.     an application.  It's included in OpenWindows up to release 3.2, but is
  129.     not supported (and will not run) under OpenWindows 3.3 (based on X11R5).
  130.  
  131.     The current version of TNT from Sun is 3.1; Release 3 contains some
  132.     incompatibilities with `tNt' 1.0 and TNT 2.0, but Sun were committed to
  133.     supporting the API, at least until they released Solaris 2.3 and `replaced'
  134.     it with Display PostScript.  Wail.
  135.     Sun currently asserts that it is committed to OLIT, however.
  136.     Correction: Sun is now committed to COSE, which is committed to a new
  137.     Motif toolkit, and OLIT support will presumably be dropped until the
  138.     wind changes again.
  139.     Note:
  140.     Solaris 2.3 does not include Motif: SMCC is shipping Motif separately
  141.     as part of the Solaris Software Developer's Kit.  In addition, SMCC
  142.     is shipping an unbundled version of the Motif toolkit.
  143.  
  144.     The C++ User Interface Toolkit (UIT) consists of an object-oriented C++
  145.     class library layered on top of XView and a tool to generate code from
  146.     DevGuide 3 GIL files.  The UIT also includes features that simplify
  147.     event management and the use of PostScript and color.  It is said to be
  148.     compatible with OpenWindows V2 and V3, and presumably beyond, since the
  149.     release mentions that it works on Solaris 2.
  150.     UIT is not an official Sun-supported product but an ongoing project of
  151.     various people within Sun.  It used to be available on ftp.x.org in
  152.     the MIT contrib directory as UITV2.tar.Z
  153.  
  154. @ Where does Motif fit in?
  155.     Motif is an alternative Graphical User Interface that was developed by OSF.
  156.     It has a `look and feel' reminiscent of Microsoft Windows and the OS/2
  157.     Presentation Manager.  There are no non-commercial Motif toolkits
  158.     available, and the Motif source by OSF is fairly expensive.
  159.     Fresco (in X11R6) will have a Motif-like user interface; TK, based on
  160.     the tcl language, looks a little like Motif.
  161.     There are commercial XView to Motif translation tools, such as Accent's.
  162.     OSF/Motif will be included in COSE (q.v.) in a somewhat changed form.
  163.  
  164. @ What is MoOLIT?
  165.     MoOLIT is a version of OLIT from AT&T/USL that lets users choose between
  166.     a Motif and an OPEN LOOK UI feel at run-time.  It will be part of System V
  167.     Release 4.2.  Contact: Joanne Newbauer, jo@usl.com, (908) 522-6677
  168.  
  169. @ What about that Display PostScript thing?
  170.     Sun and Adobe agreed that Sun include the DPS extension to X in
  171.     OpenWindows, and this is in Solaris 2.3 and later.
  172.     Unfortunately, this has also meant dropping the NeWS server, and hence
  173.     the NeWS toolkit (TNT), with what many consider to be a significant loss
  174.     of functionality and ease of programmability as a result.  On the other
  175.     hand, a number of commercial applications such as Adobe Illustrator and
  176.     Adobe PhotoShop have being ported to the Sun.
  177.     See the Solaris Porting guide [see Bibliography below] for a few more
  178.     details.
  179.  
  180. Subject: The COSE agreement
  181.  
  182. @ What is COSE?
  183.     The Common Operating System Environment is an agreement by several of the
  184.     largest Unix manufacturers, including e.g. Sun, HP, IBM and SCO, to provide
  185.     a compatible windowing environment (CDE) across all platforms.  It's widely
  186.     rumoured that only fear of Windows NT could have brought this on.
  187.  
  188. @ What's it like?
  189.     A snapshot of the Common Desktop Environment for HP, Sun, IBM, USL, SCO
  190.     has been released on CD/ROm and was given out at the CDE develoer's
  191.     conference.
  192.  
  193.     Some of the features include:
  194.     * Sun's Mailtool and Calander Manager
  195.     * Sun's ToolTalk protocol for desktop interoperability
  196.     * IXI's desktop file manager
  197.     * HP's VUE desktop manager - a little like olvwm without the map
  198.     * a Motif toolkit that offers all of the OPEN LOOK UI controls and
  199.       window decorations.  It isn't clear to me in what way it's still Motif.
  200.     * various games and demonstrations, `the entertainment value of these
  201.       should not be underestimated' :-)
  202.     * Sun's F3 outline font technology [actually I don't see this yet]
  203.  
  204. @ Why would I want it?
  205.     If you're using OpenWindows you probably don't, particularly, but you're
  206.     not the targeted market.  If you are not yet using X11 at all, or if you
  207.     get fed up of all the differences between the various vendors' X11
  208.     environments, you'll probably be interested.
  209.  
  210. @ When can I have it?
  211.     Not until the end of 1994, in order to give Windows NT a fair start :-)
  212.  
  213.  
  214. Subject: Window Managers -- olwm, olvwm
  215.  
  216. @ What are olwm and olvwm?
  217.     They are window managers.  A window manager is the part of the X Window
  218.     system (e.g. X11) that is responsible for deciding how to lay out windows
  219.     on the screen, and for managing the user's interaction with the windows.
  220.  
  221.     Olwm is the standard OPEN LOOK window manager.
  222.     It's included with all of the OpenWindows (q.v.) implementations, and
  223.     you can also get the source by ftp, since Sun donated it.
  224.  
  225.     Olvwm is a version of olwm that manages a `virtual desktop' (hence the
  226.     `v' in its name).  It shows a little map on the screen, with the
  227.     currently displayed area represented by a little rectangle.     You can
  228.     move around by dragging the rectangle or with the arrow keys.  This
  229.     lets you run several clients (applications) and move the display around
  230.     from one to the other.  Olvwm was derived by Scott Oaks from the Open-
  231.     Windows 3 olwm; you need to have libolgx (from XView 3.x) to compile it.
  232.     Get olvwm from an ftp site such as ftp.x.org (in the contrib directory;
  233.     watch out for any patches there).
  234.  
  235. @ Can I use my favorite window manager with OpenWindows instead of olwm?
  236.     Yes.  If you use twm, for example, or mwm, you won't be able to use
  237.     the Pin and Unpin feature of olwm, and you (probably) won't see the
  238.     footers some windows use to display certain messages.
  239.  
  240.     If you use twm, you'll want to use the f.delete function to unpin menus
  241.     and get rid of programs that don't have a `quit' button when not run
  242.     under olwm.
  243.     For twm, put this in your $HOME/.twmrc:
  244.     LeftTitleButton "target" = f.delete
  245.     where "target" is a 16x16 icon from /usr/include/X11/bitmaps.
  246.     Alternatively, try
  247.     # Add a menu to each window managed by twm or tvtwm
  248.     LeftTitleButton ":menu" = f.menu "OL.menu"
  249.  
  250.     menu "OL.menu" {
  251.         "Quit"         f.delete
  252.     }
  253.  
  254.     For mwm, you can double-click on the menu icon on the left of the title
  255.     bar to dismiss a pop-up window (I am told).  XView windows might simply
  256.     iconify themselves; there's a C work-round for this involving editing
  257.     the program to make the windows `transient'.
  258.  
  259.     See the manual page for your window manager (twm, etc).
  260.  
  261. Subject: OpenWindows, Terminals, and Other Displays
  262.  
  263. @ Can I use olwm and olvwm without OpenWindows or on an X Terminal?
  264.     The OpenWindows xnews server combines SunView, NeWS (PostScript) and X11.
  265.     This means that it can run programs compiled for any of those systems.
  266.     Unfortunately, it means that some OpenWindows programs need either NeWS
  267.     or SunView support, and thus won't run on an X terminal.  This includes
  268.     pageview in particular.
  269.  
  270.     You can use olwm or olvwm (see above) on an X terminal or a non-Open-
  271.     Windows display, and most OPEN LOOK clients (e.g. OLIT or XView ones)
  272.     will work perfectly well.  You may find that you get complaints about
  273.     fonts not being found.  If so, see the Fonts section below.
  274.     If you are running the window manager built-in to an NCD terminal, you
  275.     may have problems with input focus; setting *Input: True in the terminal's
  276.     XDefault file in /usr/lib/X11/xdm may or may not help.
  277.  
  278.  
  279. Subject: Configuration Files: Getting started with OpenWindows
  280.      
  281. @ What configuration files do I need to know about?
  282.  
  283.     .xinitrc and .xsessionrc
  284.  
  285.     The first time you run OpenWindows, a .xinitrc file will be created in
  286.     your login directory ($HOME).  If it already exists, you might have to
  287.     edit it somewhat; it's simplest to move it and any other old X11 files
  288.     you have to another directory, and then merge the old and new files.
  289.  
  290.     If your site uses xdm, you should use .xsession instead of .xinitrc,
  291.     since xdm doesn't look at your .xinitrc file.
  292.  
  293.     .openwin-init, .openwin-menu and .openwin-sys
  294.  
  295.     These are optional files you can create in your $HOME directory,
  296.     depending on which version of olwm or olvwm you use.
  297.     Look in $OPENWINHOME/lib (normally /usr/openwin/lib) for these files
  298.     without the leading . and copy any you want to change.  You may need
  299.     to edit your .xinitrc to get them recognized.  If you are not on an
  300.     X terminal, you will want to run a console window (such as cmdtool -C,
  301.     shelltool -C, xterm -C) or Chuck Musciano's "contool" program so that
  302.     system output will be directed there instead of writing over your screen.
  303.     Note that .openwin-sys is not executed unless you edit .xinitrc.
  304.  
  305.     .Xdefaults
  306.  
  307.     You can put X Windows resource specifications in here.  In particular,
  308.     it is a good idea to include at least:
  309.     OpenWindows.FocusLenience:    true
  310.     *Input: TRUE
  311.     These allow non-ICCCM-compliant programs to receive input even if they
  312.     forget to ask for it.
  313.  
  314.     Props, the program that runs when you select `properties' from the default
  315.     root menu under olwm or olvwm, writes your choices into either
  316.     .Xdefaults or, in newer versions, a file called .OWdefaults instead.
  317.     Don't put comments in .Xdefaults, since `props' and other programs
  318.     that re-write the file delete comments (this is an X problem, not a
  319.     Sun-specific bug...).  You can use resources like
  320.     comment.001 This is a comment
  321.     comment.002 Actually, it's an X default, but unless you have an
  322.     comment.003 X program called comment, it's pretty safe.
  323.  
  324.     .startup.ps
  325.  
  326.     This is the NeWS user profile file, read by OpenWindows (actually xnews)
  327.     on startup.     This is documented in the NeWS programming manual, near the
  328.     back.  The most useful thing to put here is PostScript code to change
  329.     the keyboard repeat rate, although you must be very careful, since a
  330.     syntax error in the PostScript means that xnews will either not start up
  331.     at all or will get broken in strange ways.    The NeWS manual gives code
  332.     that is both incorrect and insufficient.
  333.     WARNING: things in this file rarely work on both OpenWindows 2 and 3.
  334.  
  335.     Note that the mouse speed is best set in your .xinitrc with xset m; see
  336.     the man page for xset ("man xset", and "xset -help") for more information.
  337.  
  338.     Here's what $HOME/.startup.ps  should look like if you want a delay of
  339.     about a third of a second (300000 microseconds), and a repeat rate of
  340.     twenty or so keys per second (30000 microseconds between repeats) for
  341.     OpenWindows 3.  You'll have to experiment a bit because the RepeatTime
  342.     is the delay between keys sent, and thus doesn't include the time to
  343.     process each key, which is probably higher on my 4/110 than on your
  344.     SuperSPARC 10/51 GTi injection :-)  Again, this is for OpenWindows 3...
  345.  
  346.     % don't want the demos - see p. xxxii of NeWS Toolkit Reference Manual
  347.     % /IncludeDemos? false def
  348.  
  349.     UserProfile begin
  350.         /KeyRepeatThresh 0 300000 timeval storetimeval def
  351.         /KeyRepeatTime 0 30000 timeval storetimeval def
  352.         % Note: 300000 and 30000 differ greatly...
  353.     end
  354.  
  355.     You must also have a .user.ps file in the same directory, like this:
  356.  
  357.     /NeWS 3 0 findpackage beginpackage
  358.     /TNTCore 3 0 findpackage beginpackage
  359.     /TNT 3 0 findpackage beginpackage
  360.  
  361.     ClassRepeatKeys pop    % force repeat.ps to autoload
  362.  
  363.     endpackage endpackage endpackage
  364.  
  365.     If you change these parameters, you can test them without restarting the
  366.     OpenWindows server like this:
  367.     $ psh -i .startup.ps
  368.     Welcome to X11/NeWS Version3
  369.     $ psh -i
  370.     Welcome to X11/NeWS Version3
  371.     /classinit ClassRepeatKeys send
  372.     %%% now press control-D
  373.  
  374.     You can also either of these two files (.startup.ps and .user.ps) to make
  375.     the root window be "retained", so that a PostScript drawing on the
  376.     background won't be erased when you move windows:
  377.     frambuffer /Retained true put
  378.     will do this.  Note that this may increase the amount of memory used
  379.     by the NeWS server (xnews) dramatically.
  380.     
  381.     See also:
  382.     Trouble Shooting: It Won't Let Me Type
  383.     Trouble Shooting: Is there an easy way to edit Xdefaults?
  384.     Environment Variables
  385.  
  386. @ How can I configure OPEN LOOK for a left-handed mouse and keyboard?
  387.     You can use xmodmap to change the mouse buttons, but be prepared for one
  388.     or two occasional surprises.  See also "man 7 xview" for a list of
  389.     keybindings you can change, at least for XView programs.
  390.  
  391.     With OpenWindows 2.0, you can use defaultsedit to set the mouse mappings
  392.     and then let SunView handle them.  The status returned by svenv should
  393.     tell you whether your server is running under SunView or not; put this
  394.     in your .xinitrc:
  395.  
  396.     if eval `svenv -env`
  397.     then
  398.     xmodmap -e "pointer = 1 2 3"
  399.     input_from_defaults
  400.     else
  401.     xmodmap -e "pointer = 3 2 1"
  402.     fi
  403.  
  404.  
  405. @ How can I get the screen to go blank when the system is idle?
  406.  
  407.     Run screenblank from /etc/rc.local if you can; it's a boring but
  408.     effective screen saver.  See `man screenblank'.
  409.     Under Solaris 2 you'll need to copy screenblank from an older system, as
  410.     it's not supplied.  Then add a new file in /etc/rc2.d to make the system
  411.     run screenblank automatically.
  412.  
  413.     You can also pick up a replacement screenblank by
  414.     Jef Poskanzer (<jef@acme.com> or <jef@netcom.com>):
  415.     ftp://ftp.netcom.com/pub/je/jef/screenblank.tar.Z
  416.     ftp://ftp.ee.lbl.gov/screenblank.tar.Z
  417.  
  418.  
  419. Subject: Key Bindings, Cut and Paste
  420.  
  421. @ How do I cut and paste between XTerm and OpenWindows programs?
  422.  
  423.     To go from XTerm to textedit (say):
  424.     * Select the text you want to copy by dragging the SELECT mouse button
  425.       in xterm
  426.     * Press COPY in the XTerm (this key is L6, or Meta+c (the O'Reilly
  427.       XView manual gets this wrong)
  428.     * Move to the textedit window, and press PASTE (L8 or Meta+v)
  429.  
  430.     If this doesn't work, see Trouble Shooting: Cut and Paste
  431.  
  432.    To go the other way, from textedit to XTerm:
  433.     * Select the text in textedit.  No need to use COPY
  434.     * Move to the XTerm window and press ADJUST (the middle mouse button).
  435.     * You can also use the COPY/CUT and PASTE buttons.
  436.  
  437. @ COPY/PASTE is boring.     What short-cuts are available?
  438.  
  439.     Quick Copy within textedit, mailtool, etc:
  440.     * Click SELECT to get a text caret where you want the copied text to go
  441.     * Press and HOLD DOWN the PASTE (or CUT) button
  442.     * Select the text you want to copy/move.  You'll see that it's underlined
  443.       or crossed out, as appropriate.  (In the jed demo it goes grey)
  444.     * Let go of the PASTE (or CUT) button.
  445.     * The text you underlined or crossed out appears at the insert caret.
  446.  
  447.     Drag and Drop to Move a Selection
  448.     * Select the text you want to copy or move, by dragging or multiple-
  449.       clicking the SELECT or ADJUST mouse button
  450.     * Put the mouse pointer anywhere within the selection
  451.     * Press and HOLD DOWN down the SELECT mouse button, and move the mouse
  452.       pointer a little to the right; you'll see the cursor changes to be the
  453.       first 3 letters of the text (or some other icon).
  454.     * Still holding SELECT down, move the mouse over the point where you want
  455.       to drop the text
  456.     * You may see the mouse pointer change to a rifle-sight or target, to show
  457.       that it's OK to drop things here
  458.     * Let go of SELECT, and the text is moved.    This works in text fields of
  459.       dialogue boxes as well as in text subwindows.
  460.  
  461.     Drag and Drop to Copy a Selection
  462.     * This is the same as using Drag and Drop to Move a Selection, except that
  463.       you must hold the CONTROL key down as well as the SELECT mouse button.
  464.  
  465. [several sections moved to "deskset.faq" posted separately]
  466.  
  467. Subject: Applications: Finding Out...
  468.     Contact SunSoft (or Sun) and ask for the Catalyst OPEN LOOK guide,
  469.     which lists over 200 pages of applications, and also the _huge_
  470.     Catalyst listing of products for Suns, updated six-monthly.
  471.  
  472.     Sun's free CDWare CD/ROMs each contain demo versions of several popular
  473.     OPEN LOOK applications.  Often you can simply contact the vendor
  474.     concerned to have the license upgraded from demo, and receive the full
  475.     product documentation.
  476.  
  477.     SunPICS produces a CD/ROM for NeWSPrint users, Printer's Pallate, which
  478.     contains NeWSprint drivers for a variety of printers and plotters, as
  479.     well as 600 scaleable fonts that you can license.
  480.  
  481.     There is a separate FAQ posting in comp.windows.open-look that lists
  482.     a number of free and commercial aplications; mail lee@sq.com for a
  483.     copy, including OPEN LOOK UI Application List in the Subject for a
  484.     faster reply.
  485.  
  486. Subject: Fonts
  487.  
  488. @ Does OpenWindows support Type 1 PostScript fonts?
  489.     Yes, under either Solaris 2.  You must use .pfa format, not .pfb;
  490.     I have a program to convert them (lee@sq.com, ask for pfb2ps).
  491.     You will want to add an "XLFD" alias, e.g.
  492.     /-bruce rogers-centaur-medium-r-normal--0-0-0-0-p-0-iso8859-1
  493.     /Centaur-Roman _FontFamilySYN
  494.     (put these all on one line with tabs between them, in Synonyms.list,
  495.     before running bldfamily).
  496.  
  497.     If you have FrameMaker there is a utility to import them, I'm told.
  498.     The 57 fonts supplied with OpenWindows are fully hinted, though, and
  499.     comparing them to the Microsoft Windows and Apple TrueType fonts is
  500.     interesting...  The F3 font format is described in a publication from the
  501.     Sun OpenFonts group, listed in the Bibliography below.  Documentation on
  502.     the unbundled version of TypeScaler is also available from Sun OpenFonts.
  503.  
  504.     You can buy F3 fonts from SunPICS, Monotype, Linotype, URW and probably
  505.     other major foundries.
  506.  
  507.     SunPICS' NeWSPrint software supports both F3 and Type 1 fonts.
  508.  
  509.     TtrueType fonts are not supported at this time.
  510.  
  511. @ Improving font rendering time
  512.     Although the Sun type renderer (TypeScaler) is pretty fast, it's not as
  513.     fast as loading a bitmap.  You can pre-generate bitmap fonts for sizes
  514.     that you use a lot, and you can also alter and access the font cache
  515.     parameters.     If you have a lot of memory you might want to increase the
  516.     font cache size.
  517.     $ psh -i
  518.     Welcome to X11/NeWS Version3 <--- psh will say this at you
  519.     currentfontmem =    % type this line ...
  520.     300    % and here's whai my server was using -- 300 Kbytes
  521.     2000 setfontmem
  522.     % Just to check:
  523.     currentfontmem ==
  524.     2000
  525.     See pp. 328ff of the NeWS 3.0 Programmer's Guide.  You need to say psh -i
  526.     so that the NeWS packages are loaded, since the font memory controls
  527.     are NeWS extensions to PostScript - see the psh man page.
  528.  
  529. @ Making bitmap fonts for faster startup:
  530.     $ mkdir $HOME/myfonts
  531.     $ cd $HOME/myfonts
  532.     $ makeafb -20 -M $OPENWINHOME/lib/fonts/Bembo.f3b
  533.     Creating Bembo20.afb
  534.     $ convertfont -b Bembo20.afb
  535.     Bembo20.afb->./Bembo20.fb
  536.     Chars parameter greater than number of characters supplied.
  537.     $ ls
  538.     Bembo20.afb    Bembo20.fb    Synonyms.list
  539.     $ bldfamily
  540.     * Bembo               ./Bembo.ff (Encoding: latin)
  541.     cat: ./Compat.list: No such file or directory
  542.     $ xset +fp `pwd`
  543.     $ xset fp rehash
  544.  
  545.     If you want the server to see your new font directory every time,
  546.     add this directory to your FONTPATH environment variable in one
  547.     of your start-up files, e.g. .login or .profile.
  548.  
  549. @ Converting between font formats (convertfont, etc.)
  550.     You can also use Folio fonts with an X11 server, by converting them to a
  551.     bitmap (X11 bdf format) first.  Your licence forbids you from using the
  552.     fonts on another machine, and unless you have NeWSPrint you shouldn't
  553.     use them for printing.  Having said all that...  you can use makeafb and
  554.     convertfont to generate bdf files that you can compile with bdftosnf or
  555.     bdftopcf.
  556.  
  557.     Use mftobdf (from the SeeTeX distribution) to convert TeX pk fonts to
  558.     X11 bdf format, which you can then use with either X11 or OenWindows.
  559.  
  560.     You can also use der Mouse's "getbdf" to get bdf fonts from a running
  561.     X display server -- ftp: larry.mcrcim.mcgill.edu (132.206.1.1) /X/getbdf
  562.  
  563. @ Xview/OLIT fonts at 100 dpi
  564.     Put $OPENWINHOME/lib/fonts/100dpi first in your font path.  The glyph
  565.     font for XView controls isn't scaled until Solaris 2, when OLIT, TNT
  566.     and XView all use the same scaled font for controls.  You could probably
  567.     generate a bitmap (see above) for use on other systems, since the font
  568.     is included in the XView source, but I don't know if that's legal.
  569.  
  570. Subject: Trouble Shooting: Strange Error Messages
  571.  
  572. @ No manual entry for cm_lookup
  573.  
  574.     If man doesn't seem to find OpenWindows commands, even though you are
  575.     running OpenWindows, try setting the MANPATH environment variable:
  576.     MANPATH=$OPENWINHOME/share/man:/usr/man; export MANPATH
  577.     or
  578.     setenv MANPATH $OPENWINHOME/share/man:/usr/man
  579.     for csh users.  $OPENWINHOME should be /usr/openwin on most systems.
  580.  
  581. @ window: Window creation failed to get new fd 
  582. @ window: Base frame not passed parent window in environment 
  583. @ Cannot create base frame.  Process aborted. 
  584.  
  585.     These messages all come from SunView programs.  SunView was an
  586.     earlier windowing system for Suns, and was not networked.  Some of
  587.     the SunView programs are still around in /usr/bin, and have names
  588.     that are the same as their OpenWindows counterparts.  You almost
  589.     certainly want to run the programs in $OPENWINHOME instead.
  590.  
  591.     Set your path so that $OPENWINHOME/bin (and $OPENWIN/bin/xview for
  592.     OpenWindows 2) come before /bin (or /usr/bin, they're the same), or
  593.     you'll get the SunView versions of mailtool, cmdtool, shelltool, etc.
  594.  
  595.     If you are trying to run SunView programs, use
  596.     eval `svenv -env`
  597.     (see the man page for svenv) before running Sunview programs; you
  598.     can put this in your .xinitrc file.  The default Sun .xinitrc has this
  599.     already.
  600.  
  601.     NOTE:
  602.     You can't run SunView programs on an X terminal.  You can't run
  603.     SunViw programs to display anywhere except on the console of the
  604.     host running the program.  You may need to be running OpenWindows
  605.     rather than X to run Sunview programs (X can be compiled to work
  606.     with SunView, though).
  607.     SunView programs do not work beyond Solaris 2.2, so you should
  608.     consider moving.
  609.  
  610.  
  611. @ memory fault - core dumped
  612.     If you get this from the binder, or if binder vanishes suddenly,
  613.     get the following patches:
  614.     100493-02 Binder
  615.     100524-03 Cetables
  616.     100626-03 Tooltalk
  617.  
  618. @ Trouble compiling Xt, Xmu or OLIT programs: _get_wmShellWidgetClass
  619.  
  620.     If you are using OpenWindows 3.0 (X11R4-based Xt), contact your local
  621.     Sun office and request the following patches:
  622. 100512-02   4.1.x OpenWindows 3.0 libXt Jumbo patch
  623. 100573-03   4.1.x OpenWindows 3.0 undefined symbols when using shared libXmu
  624.  
  625.     If you can't install the patch, a workaround is to add 
  626.     -u get_wmShellWidgetClass -u get_applicationShellWidgetClass
  627.     on the link (ld or cc ... -o ...) line.  An alternative is to add
  628.     -assert nodefinitions
  629.     to CFLAGS in your Makefile, or even in Imake.tmpl.
  630.  
  631.  
  632. Subject: Trouble Shooting: It Won't Let Me Type
  633.  
  634. @ When I try to type into some programs, I just get beeps or nothing happens
  635.     It is a good idea to include at least:
  636.     OpenWindows.FocusLenience:    true
  637.     *Input: TRUE
  638.     in your .Xdefaults file, as these allow non-ICCCM-compliant programs to
  639.     receive input even if they forget to ask for it.
  640.     See the next item for editing .Xdefaults
  641.  
  642. Subject: Trouble Shooting: Cut and Paste not working
  643.  
  644. @ I can't paste from xterm to XView (including Sun DeskSet) programs
  645.     Under OpenWindows 2, you need to add the following either to your
  646.     $HOME/.Xdefaults file, or to $OPENWINHOME/lib/app-defaults/XTerm instead:
  647.  
  648.     XTerm*VT100.Translations: #override \
  649.         <Key>L6:select-set(CLIPBOARD)\n\
  650.         <Key>L8:insert-selection(CLIPBOARD)
  651.   
  652.     You must not move the mouse between ending the selection and pressing
  653.     L8 (the Paste key)!
  654.  
  655.     Under OpenWindows 3, this is already in the app-defaults file, so if it
  656.     isn't working, check that XFILESEARCHPATH is set to
  657.     /usr/openwin/lib/%T/%N%S
  658.     and if it isn't, either set it or copy/merge the above lines from
  659.     $OPENWINHOME/lib/app-defaults/XTerm into /usr/lib/X11/app-defaults/XTerm.
  660.     [See also: Environment Variables]
  661.  
  662.     This version automatically puts each xterm selection onto the clipboard:
  663.     XTerm*VT100.translations: #override\n\
  664.         ~Ctrl ~Meta<Btn2Up>: insert-selection(PRIMARY,CUT_BUFFER0)\n\
  665.         ~Ctrl ~Meta<BtnUp>: select-end(PRIMARY,CUT_BUFFER0,CLIPBOARD)\n\
  666.         <KeyPress>L8: insert-selection(CLIPBOARD)
  667.     [Note: be sure that the \n\ is at the very end of the line, there must
  668.      be no following spaces, and any + or | signs showing that this FAQ file
  669.      was altered must also be removed!]
  670.  
  671.     If you are using X11R5, you may find that adding the lines
  672. <Key>L10: start-extend() select-end(PRIMARY, CLIPBOARD, CUT_BUFFER0)\n\
  673.        <KeyRelease>L10: kill-selection() \n
  674.     before the <KeyPress>L8 line will make L10 (CUT) work as a cut key!
  675.  
  676.     If you alter $HOME/.Xdefaults instead, you must use what X calls a
  677.     `more specific' resource name:
  678.     xterm.vt100.translations
  679.     will do.
  680.  
  681. @ I can't paste from XView (including Sun DeskSet) programs to xterm
  682.  
  683.     If you don't have the Sun L keys on the left of your keyboard, you can
  684.     use Meta-x, Meta-c and Meta-v for cut, coy and paste respectively.
  685.     You can change the keys by adding the following two lines to
  686.     your .Xdefaults file, edited as you wish (the values shown here are the
  687.     defaults):
  688.  
  689.     Openwindows.KeyboardCommand.Copy: c+Meta,L6
  690.     OpenWindows.KeyboardCommand.Paste", "v+Meta,L8
  691.     
  692.     Lists of resources are in the manual page for xview, and also in the
  693.     thinnish blue book `Companion to Volume 7, XView Reference Manual' from
  694.     O'Reilly, and also in the olwm and olvwm manual pages.
  695.  
  696. @ I can't copy and paste between OSF/Motif and OpenWindows programs.
  697.  
  698.    Adding the following lines to your .Xdefaults file may help:
  699.     *XmText.translations: #override\n\
  700.             <Key>L6:        copy-clipboard()\n\
  701.             <Key>L8:        paste-clipboard()\n\
  702.             <Key>L10:       cut-clipboard()\n
  703.     *XmTextField.translations: #override\n\
  704.             <Key>L6:        copy-clipboard()\n\
  705.             <Key>L8:        paste-clipboard()\n\
  706.             <Key>L10:       cut-clipboard()\n
  707.  
  708. @ I always get the same piece of text when I press PASTE (L8, Meta+v)
  709.     Remove the file /tmp/textsw_shelf and see if that helps; see also the
  710.     next item.
  711.  
  712. @ Cut Copy and Paste don't work at all (OpenWindows only)
  713.     Oh dear.  Use ps -xuaww | grep xv  to check that sv_xv_sel_svc is running
  714.     and that either you or root started it, depending on whether you started
  715.     OpenWindows with "openwin" or by logging in through xdm.
  716.     If not, start it.  If it dies, check that there is no /tmp/.sv_xv_sel_svc
  717.     before restarting it - you may need to be root to remove it, or you can
  718.     reboot your workstation.
  719.     Check that there is space in /tmp (use "df /tmp"), and also see if there
  720.     are a lot of files there with names like /tmp/tty.txt.a01246; if there are
  721.     several hundred of them, cut and paste may take so long that it times out.
  722.  
  723.     Quit any deskset tools such as mailtool, filemgr and cm (calendar), start
  724.     a terminal emulator and remove and /tmp/tty.txt* and /tmp/Text* files
  725.     that are still there.  It's simplest to quit openwin and start it again
  726.     after doing that, if cut and paste was broken, but if it starts working
  727.     again you can just carry on.  Note that files in /tmp not owned by you
  728.     might be in use by another worker comrade, so don't remove those without
  729.     checking first!
  730.  
  731. Subject: Trouble Shooting: Not authorized to use display
  732.  
  733.     If you get error messages that look like
  734.     Xlib:  connection to ":0.0" refused by server
  735.     Xlib:  Internal error during connection authorization check
  736.     Error: Can't Open display
  737.     try, on the machine running OpenWindows or X11,
  738.     xhost +machine
  739.     where "machine" is the computer on which you ran the command that failed.
  740.     If you want to let other users run programs on the same machine as you,
  741.     using your display, you will have to type the bizarre-looking
  742.     xhost +`hostname`
  743.     (or xhost +happyboy, if happyboy is the name of your workstation).
  744.     This lets ANY user on `happyboy' access your display.
  745.  
  746.     With OpenWindows 3 you can also use xauth, and the Programmer's Guide 
  747.     describes how to do this in Chapter 8, p. 101.  This is more secure.
  748.     Also check the man page for fbtab(5) to stop other users accessing the
  749.     framebuffer directly!
  750.  
  751.     Also note that there is a Sun patch for OpenWindows 3.0 under SunOS 4.1.1
  752.     to fix a serious security problem.  It is available through your local
  753.     Sun Answer Center as well as through anonymous ftp from ftp.uu.net
  754.     [192.48.96.2] system in /sun-dist:
  755.     Fix                     PatchID        Filename            Checksum
  756.     loadmodule              1076118        100448-01.tar.Z     04354  5
  757.  
  758.     On an X Terminal, there may be a setup menu that lets you change or
  759.     disable the list of hosts that can access the display.
  760.  
  761.     If you start getting this message after you've been logged in overnight,
  762.     there might be a cron job that's removing the Unix sockets in /tmp
  763.     that are used to communicate with the server when $DISPLAY doesn't have
  764.     a hostname before the :, or is empty.  Have the system administrator
  765.     change the cron script to skip sockets, or log out when you go home!
  766.  
  767. Subject: Trouble Shooting: other common problems
  768.  
  769. @ Netscape (or some other Motif application) complains about a missing
  770.   keysym & I can't use the right mouse menu
  771.     You probably don't have an F10 key.
  772.     With a Sun Type 3 or 4 keyboard, try
  773.         xmodmap -e "keycode 0x34 = F10"
  774.     to map one of the R keys (I think it's R6) to F10; you can use
  775.     xev or (if you have it) xkeycaps to find out what keycode to use
  776.     for a given key.
  777.  
  778. @ I get console error messages on my screen and they don't go away (Sun 3 or 4)
  779.     If "refresh" makes the messages vanish, but new ones come along later,
  780.     you need to run "xterm -C" from your .xinitrc, or start one up in
  781.     the background and then  choose Save Workspace from the
  782.     Workspace->Utilities menu.  Better still, pick up "contool" and run
  783.     that.  Get it from ftp.x.org in the contrib directory.  It
  784.     will monitor the console and open, flash its icon or beep when a
  785.     message appears; it's very easy to configure.
  786.  
  787.     If "refresh" from the Workspace->Utilities menu doesn't make the messages,
  788.     go away...
  789.     a Sun with a cg4 frame buffer has two screens - you can move the
  790.     mouse off the right-hand (by default) edge of the screen and onto
  791.     a whole new (but monochrome) display, called ":0.1".  See the man.
  792.     page for openwin; I have a shell script that checks for this and,
  793.     if there's a /dev/cgfour0, does
  794.         openwin -dev /dev/cgfour0 -dev /dev/bwtwo0
  795.     If you are running X11 or OpenWindows 2, you might need to add this
  796.     to your .xinitrc or other startup file:
  797.     (
  798.         eval `svenv -display unix:0.1 -env`
  799.         olvwm -display unix:0.1
  800.     ) &
  801.     Later releases of olwm and olvwm do this automatically.
  802.     You can also run switcher -e 0 to get rid of the messages.  Also, see
  803.     the note about contool, above.
  804.  
  805. @ Is there an easy way of editing .Xdefaults?
  806.     Use `props', which appears in the default root menu as `properties'.
  807.     This starts `props', a property editor which will re-write your
  808.     .Xdefaults after removing comments.  It then applies any changes.
  809.     Keep comments by using "comment." instead of "!", for example,
  810.     comment.*.font: Palatino-Italic-37
  811.  
  812. @ How do I get the File manager to use emacs instead of textedit?
  813.     set the default editor to
  814.     sh -c "exec emacs -font lucidasanstypewriter-18 \"$FILE\""
  815.     (you can change the font if you prefer a smaller one)
  816.  
  817. @ How do I run OpenWindows in inverse video?
  818.     This tends not to work under OpenWindows 2.     With OpwnWindows 3.0,
  819.     there are various ways, including using -bg and -fg options.  If you're
  820.     using OpenWindows 2 on a Sun 3 , probably the best you can do (short of
  821.     upgrading the workstation to a SPARC!) is to use xterm instead of cmdtool.
  822.  
  823. @ Why don't flat check-boxes work?
  824.     A known bug may make Guide's output dump core if you use these.
  825.     A workaround is to edit the Guide output, as it's only Guide's output
  826.     that's broken, not the actual check-box code.
  827.     This applies only to versions of DevGuide before Devguide 3.0.  If you're
  828.     still using an ancient DevGuide, you should upgrade as soon as possible;
  829.     the new one is fantastic!
  830.  
  831. @ When I leave OpenWindows, my screen goes blank or my mouse cursor stays
  832.   on the screen.
  833.     Try running clear_colormap; if this helps, put it as the last line in
  834.     the shell script you use to start OpenWindows (e.g. `openwin').
  835.  
  836. @ When I use snapshot, the system crashes, or the server hangs, or something.
  837.     This was a bug related to some systems only.  The only work-round was to
  838.     use some other screen dump program, such as xwd, xv 2.21 or xgrabsc.
  839.     
  840. @ Why have some of my function keys stopped working?
  841.     Keys F11 and F12 changed from SunF36 and SunF37 to SunXK_F36 and SunXK_F37
  842.     respectively in OpenWindows 3.  Applications must be recompiled, or you
  843.     might be able to use xmodmap or the public domain xkeycaps program to
  844.     change your keyboard layout back again.
  845.  
  846. @ When I type shelltool or cmdtool or textedit, I get the Sunview version
  847.     See under "Trouble Shooting: Strange Error Messages" below.
  848.  
  849.     (see also next item)
  850.  
  851. @ Mixing X11 and OpenWindows
  852.     (see also next item)
  853.  
  854.     Note that OpenWindows 3.0 includes the X11R4 core distribution (to patch
  855.     level 18), but not the contrib directory.  These notes apply to
  856.     OpenWindows 2.0, although you could also the do same sort of thing with
  857.     OpenWindows 3.0 and X11R5.
  858.  
  859.     Install the X11 libraries in /usr/lib/X11.    You can intermix OpenWindows
  860.     and X11R4 or X11R5, they're all compatible in this respect.
  861.     Put the X11 binaries in (for example) /usr/bin/X11.
  862.  
  863.     Put /usr/bin/X11 last in your PATH, so that you get OpenWindows versions
  864.     of programs instead of X11 ones where appropriate, although this is a
  865.     matter of preference.  In any event, put the OpenWindows bin directory
  866.     first -- see the preceding item for more details on that.  If you have
  867.     /bin (or /usr/bin, they're the same directory on SunOS) earlier in
  868.     your PATH than $OPENWINHOME/bin/xview, you'll get SunView programs instead
  869.     of OpenWindows ones!
  870.  
  871.     Set LD_LIBRARY_PATH so that /usr/openwin/lib is last, after the X11
  872.     library directory.    This doesn't matter with OpenWindows 3.0, but with
  873.     older versions you'll get error messages from X11 programs if you don't
  874.     do this.  The messages are generally harmless (see next item), although
  875.     xdm core dumps if this isn't right.
  876.  
  877.     Set OPENWINHOME to the directory containing OpenWindows if it isn't
  878.     /usr/openwin.
  879.  
  880.     NOTE:
  881.     OpenWindows 3.3 is based on X11R5, so you don't need to do this.
  882.     In fact, you might as well simply stick to the Xsun server provided
  883.     by Sun, unless it turns out to be buggy.  OpenWindows 3.3 (or 4.0?)
  884.     will probably be released (with Solaris 2.3?) later this year.
  885.  
  886.     See Also:
  887.     Environment Variables (especially XFILESEARCHPATH).
  888.  
  889. @ I get error messages on my screen about ld.so: libX11.so.4 not found
  890.     set LD_LIBRARY_PATH to be /usr/openwin.  If you also use X11, use
  891.          /usr/lib:/usr/5lib:/usr/openwin/lib
  892.     If you put this in a shell script or your .profile, use
  893.     ${OPENWINHOME-/usr/openwin}/lib instead of /usr/openwin; this is for
  894.     /bin/sh; for csh it is different.
  895.  
  896. @ I launch my filemgr and I get ld.so:map heap error (9) at /dev/zero
  897.     Your system needs to be patched.  Look in $OPENWINHOME/lib/OSpatches
  898.     and install the patch.
  899.  
  900. @ Why doesn't AnswerBook run for me?
  901.     You must be running OpenWindows to use AnswerBook.    It won't run under
  902.     X11 (on an X terminal or on anything else) because it uses NeWS to draw
  903.     the PostScript text and pictures.
  904.     If you are using OpenWindows 3.0, you need to use the OpenWindows 3.0
  905.     compatible navigator; it's called .navigator.ow3 on the AnswerBook CD/ROM.
  906.     If all AnswerBook users are using OpenWindows 3.0, you can replace
  907.     navigator wih .navigator.ow3 altogether (rename the old one first to
  908.     satisfy your sense of paranoia!)
  909.     The navigator.ow3 binary is also on CD/Ware Vol 2.
  910.     Note that the data files are in PostScript, so you can look at them with
  911.     a PostSript viewer (q.v.).
  912.  
  913. @ Why aren't there any fish in realxfishdb?
  914.     A fixed version of realxfishdb is available by ftp from
  915.     ftp.eng.auburn.edu [131.204.10.91] as /pub/realxfishdb.Z
  916.  
  917. @ Why is the Properties choice disabled in the Window menu?
  918.     It isn't implemented yet.  Many programs do respond to the Properties
  919.     Key (L3), though, or have a pop-up menu with Properties on it.
  920.     Under Solaris 2, programs using the NeWS toolkit (TNT, q.v.) take one
  921.     last sneer at X by providing a Properties menu that lets you rotate or
  922.     scale the window!  Try $OPENWINHOME/demo/{rap,jet,jed,text} for example.
  923.  
  924. @ File completion in the C-shell is broken in cmdtool
  925.     Sadly true, but use shelltool or xterm instead and it's fine.  It also
  926.     works if you run command tool on a remote machine.
  927.     Fixed in Solaris 2, and presumably in the XView 3.2 distribution.
  928.  
  929. @ When I run OLIT programs, some of the widgets are red!
  930.     Release 3 of OLIT added mouseless operation; action widgets can be
  931.     selected via the keyboard.  The currently selected item is highlighted
  932.     in red (the `Red Stain') to show that it has the input focus.
  933.     To disable it in most places, add this to your $HOME/.Xdefaults file:
  934.     *traversalOn: off
  935.     *TextEdit.traversalOn: on
  936.     *TextField.traversalOn: on
  937.     You can change the color using (for example)
  938.     *InputFocusColor: grey50
  939.     *input*FocusColor: green
  940.     *List*inputFocusColor: <your background color>
  941.     See the man page resources(3w), at the start of the OLIT 3 Widget Set
  942.     Reference Manual included in the OpenWindows 3 programmer documentation.
  943.     Meanwhile contact your distributor and ask for patch id 100451-30, the
  944.     OLIT/3.0 CTE Jumbo Patch.
  945.  
  946.     Solaris 2 includes an OLIT that uses the Giant Caret, just like XView.
  947.  
  948. @ When I run several programs, the colors on the screen all change when
  949.   I move into a different window! ("colormap flashing")
  950.     
  951.     This is becasue most hardware can only display a few colors at a time.
  952.     However, you can minimise the effect with the following procedure:
  953.     *  Start all the applications with colors that you wish to reserve.
  954.     *  Run
  955.     cmap_compact save
  956.        to create the .owcolors file
  957.     *  Put the line
  958.     cmap_compact init
  959.        near the start of your start-up file (.xinitrc or .openwin-init) if
  960.        it is not already there.
  961.     *  Exit and then restart the window system.
  962.     *  cmap_compact init will push those colors .owcolors to the end of
  963.     the colormap and reserves them.
  964.  
  965.     Also note that control-L2 locks the colors of the current window, and
  966.     Control-L4 unlocks them -- this is described in the olwm manual page.
  967.  
  968. @ pageiew uses the wrong colors, or makes the colormap flash (see above):
  969.     This problem was reported by people for some reason running the Motif
  970.     window manager (mwm) with OpenWindows.
  971.     Try running pageview like this:
  972.     $OPENWINHOME/bin/reservecolors -svmono
  973.     $OPENWINHOME/bin/pageview
  974.     $OPENWINHOME/bin/reservecolors -discard
  975.  
  976. @ XDM breaks things
  977.     Command tool doesn't like being run without a Unix `controlling terminal'.
  978.     Use /etc/setsid to start your command tools and all will be well.
  979.     SunView applications may need to be run with svenv, as in
  980.     svenv -exec /usr/bin/traffic
  981.     because xdm won't set the necessary environment variables.
  982.     (You can't run SunView programs on an X terminal, of course!)
  983.     Note that the MIT xdm starts up the X server as root, which is a security
  984.     hole for OpenWindows; use the OpenWindows 3.0 xdm or be aware that your
  985.     users can access files and start Unix processes as root...
  986.  
  987. @ Function keys 11 and 12 stopped working
  988.     In OpenWindows 3.0, the X11 names ("keysyms") for these keys was changed
  989.     to SunXK_F36 and SunXK_F37.     Code which uses them should be recompiled,
  990.     or you might be able to get away with
  991.     xmodmap -e 'keysym SunXK_F36 = SunF36'
  992.  
  993. @ Motif applications make my screen hang
  994.    Apply patch 100444-77.
  995.    Note that Motif menus that lock up the screen can be taken down by
  996.    pressing Escape at them.
  997.  
  998. [the xview section is now posted separately]
  999.  
  1000. Subject: Environment Variables
  1001.  
  1002.     Environment variables, and plausible values to use -- this list doesn't
  1003.     take into account any local changes that you might have made, of course.
  1004.     This list is for OpenWindows 3.0 -- differences for OpenWindows 2.0 are
  1005.     marked, and I've added some comments for users of X11R4 and X11R5, too.
  1006.  
  1007.     DISPLAY  The name of the X Windows Display to use
  1008.     :0.0 (on the local machine, the one actually running X11 or xnews)
  1009.     :0.1 (on some machines for a second, monochrome screen)
  1010.     machine-running-unix:0.0 (on other machines)
  1011.     (You may need to do "xhost +other-machine" to let programs on other
  1012.     machines use your display; see also under Trouble Shooting, and see
  1013.     the section on xauth in the OpenWindows Version 3 Programmer's Guide,
  1014.     pp. 101ff)
  1015.     See also: console messages, under Trouble Shooting
  1016.     FONTPATH  Where xnews searches for fonts
  1017.     /usr/openwin/lib/fonts
  1018.     (you can also use "xset fp+ dir" to add a directory to the font path,
  1019.     but you may have to do "xset fp rehash" afterwards.  This is fine
  1020.     under OpenWindows, but many X11 servers have font problems)
  1021.     HELPPATH  Where XView looks when you press the Help key (or F1)
  1022.     /usr/openwin/lib/locale:/usr/openwin/lib/help
  1023.     (On SunOS 4.0.*, or with OpenWindows 2.0, omit the first entry, which
  1024.     is for sites using a local other than "C" or "USA").
  1025.     LD_LIBRARY_PATH   Where to look to find shared C libraries
  1026.     /usr/lib:/usr/5lib:/usr/openwin/lib:/usr/CC/`arch`
  1027.     (the /usr/CC/`arch`/lib entry is only needed if you use C++ programs)
  1028.     OPENWINHOME     Where OpenWindows lives
  1029.     /usr/openwin  
  1030.     KEYBOARD, MOUSE -- serial devices to use instead of the console
  1031.     (don't set these for normal use; /dev/kbd and /dev/mouse)
  1032.     PATH  Where the Shell searches for programs to run
  1033.     $(OPENWINHOME)/bin:$(OPENWINHOME)/bin/xview:/usr/local/bin:.\
  1034.     $HOME/bin.`arch`:/usr/ucb:/usr/bin:/usr/bin/X11:/usr/hosts:\
  1035.     (you will certainly want to change this example!  There is no
  1036.     $(OPENWINHOME)/bin/xview in OpenWindows 3.0)
  1037.     XFILESEARCHPATH  Where programs look for app-defaults files
  1038.     /usr/openwin/lib/%T/%N%S
  1039.         (This is set automatically by "openwin" in OpenWindows 3.0)
  1040.         You might want to use /usr/lib/X11/%T/%N%S, or perhaps both,
  1041.         separated with a :, for example (for sh users)
  1042.             XFILESEARCHPATH=$OPENWINHOME/lib/%T/%N%S:/usr/lib/X11/%T/%N%S
  1043.         export XFILESEARCHPATH
  1044.     If you use X11R5, you might instead want
  1045.         /usr/lib/X11/%L/%T/%N%C%S:
  1046.         /usr/lib/X11/%l/%T/%N%C%S:
  1047.         /usr/lib/X11/%T/%N%C%S:
  1048.         /usr/lib/X11/%L/%T/%N%S:
  1049.         /usr/lib/X11/%l/%T/%N%S:
  1050.         /usr/lib/X11/%T/%N%S:
  1051.         $OPENWINHOME/lib/%T/%N%S
  1052.     (put all this on one line, though, with no spaces!)
  1053.  
  1054.     Together with the following in lib/Xinitrc
  1055.     xrdb -merge <<'END_XRDB'
  1056.        *customization:
  1057.     END_XRDB
  1058.  
  1059.     xrdb -merge <<'END_XRDB'
  1060.     #ifdef COLOR
  1061.        *customization:  -color
  1062.     #endif
  1063.     END_XRDB
  1064.  
  1065.     you automatically get a color oclock, editres, bitmap, xcalc, and
  1066.     xlogo since they use the "*customization" resource appearing as %C in
  1067.     the XFILESEARCHPATH. (see oclock (n))
  1068.     according to Rainer Sinkwitz <sinkwitz@ifi.unizh.ch>.
  1069.  
  1070.  
  1071. Subject: Where Can I get It? Ftp, implementations, etc...
  1072.  
  1073.     XView 3.2 is available by anonymous ftp from ftp.x.org and
  1074.     elsewhere.
  1075.  
  1076.     MoOLIT can be bought from AT&T in source form.
  1077.  
  1078.     OpenWindows can be obtained from Sun, or you can get the source from
  1079.     Interactive Systems Inc.  It is also included in some vendors' System V
  1080.     Release 4 implementations, although that's not always the latest version.
  1081.     The current release of OpenWindows from Sun for supported architectures
  1082.     is 3.0; for the Sun 3 series it is frozen at OpenWindows 2.0.
  1083.     Note that Sun includes OpenWindows with SunOS, and it is also included as
  1084.     the windowing system for Solaris.
  1085.  
  1086.     There are said (by Sun) to be over 35 ports of OpenWindows either
  1087.     available now or in progress.  Unfortunately, none of them seem to
  1088.     be available from anywhere.  Contact anthony@ovi.com for more information.
  1089.  
  1090.  
  1091. Subject: Bibliography: books, manuals, journals, papers, beer-mats
  1092.  
  1093.     The OPEN LOOK (tm) Graphical Interface is documented in two books:
  1094.     Sun Microsystems Inc., `OPEN LOOK Graphical User Interface Application
  1095.     Style Guidelines', Addison Wesley, 1989
  1096.     and
  1097.     Sun Microsystems Inc., `OPEN LOOK Graphical User Interface Functional
  1098.     Specification', Addison Wesley
  1099.  
  1100.     The Main documentation for the X Window system comes from
  1101.     O'Reilly & Associates in about nine or ten volumes.
  1102.     The most useful for OPEN LOOK users are:
  1103.     Volume 1: XLib Programming Manual
  1104.     Volume 2: XLib Reference Manual
  1105.     Volume 3: X Window System User's Guide
  1106.         (An OPEN LOOK edition of Volume 3 should appear later this year)
  1107.     Volume 7: XView Programmer's Manual [Dan Heller]
  1108.         [make sure you get the edition for XView 3.2]
  1109.     Companion to Volume 7: XView Reference Manual [Ed. Thomas Van Raalte]
  1110.  
  1111.     The Companion to Volume 7 is an expanded version of the Attribute
  1112.     Summary from the previous edition of the XView Programming Manual,
  1113.     together with other reference information, so that in practice you
  1114.     have to buy both books.
  1115.  
  1116.     Unfortunately, the 3.2 edition covers the features new since 3.0
  1117.     only in an appendix, but it's still pretty helpful, and the attributes
  1118.     have been merged in the summary; in addition, much of the book has
  1119.     been reworked, so that it's worth considering the 3.2 edition even
  1120.     if you're using 3.0.
  1121.  
  1122.     O'Reilly also have a thinnish orange book on the differences between
  1123.     X11R4 and RX115.
  1124.  
  1125.     OLIT programmers will also want the Xt books - volumes 4 and 5.
  1126.     There is a new big fat green Vol 5 updated for X11R5.  Make sure you
  1127.     don't get the Motif versions of these books by mistake.
  1128.  
  1129.     A journal, The X Resource, may also be of interest.
  1130.  
  1131.     O'Reilly & Associates, 103 Morris Street, Suita A, Sebastopol, CA 95472
  1132.     +1 707 829-0515, or, in the USA and Canada only, 1-800-998-9938
  1133.     Fax: +1 707-829-0104.
  1134.     Email nuts@ora.com or uunet!ora!nuts.
  1135.     For other distributors: mail, FAX, or call +1 707-829-0515.
  1136.  
  1137.     Some of the O'Reilly examples are available for ftp from
  1138.     ftp.x.org in the contrib/OReilly directory.
  1139.  
  1140.     The System V Release 4 Documentation from Prentice Hall may also include
  1141.     a section on OpenWindows.
  1142.  
  1143.     David Miller describes programming with OLIT in his
  1144.     `An OPEN LOOK At Unix' (M&T press).
  1145.     
  1146.     Nabajyoti Brkakati gives an excellent introduction to X and to OLIT
  1147.     programming, as well as setting up and using X and OpenWindows, in:
  1148.     `Unix[R] Desktop Guide to OPEN LOOK' SAMS, 1992  ISBN 0-672-30023-0
  1149.     You can get the examples from this book as
  1150.         ftp.x.org:contrib/naba-olguide-examples.tar.Z
  1151.  
  1152.     Also about using OLIT, and Xt in particular:
  1153.     The X Window System: Programming and Applications with Xt,
  1154.     OPEN LOOK Edition, Doug Young and John Pew, Prentice Hall, 1992,
  1155.     ISBN 0-13-982992-X
  1156.     There are also HP Widgets and Motif versions of this book.
  1157.     The example source code in this book can be obtained by ftp from
  1158.     ftp.x.org, file "contrib/young.pew.olit.Z".
  1159.  
  1160.     There is an introduction to XView in
  1161.     `Writing Applications For Sun Systems', Vol 1, `A Guide for
  1162.     Macintosh(R) Programmers' (Sun Microsystems, pub. Addison Wesley)
  1163.     
  1164.     Another recent XView book is
  1165.     `Practical XView Programming', Kenneth W. Bibb and Larry Wake,
  1166.     John Wiley & Sons, Inc., 1993, ISBN 0-471-57460-0
  1167.     You can get the examples from this book as
  1168.         ftp.x.org:/contrib/xvprac.tar.Z
  1169.  
  1170.     Neither of these two XView books elimiates the need for the O'Reilly
  1171.     X Series vols 1, 2 and 7.
  1172.  
  1173.     To learn more about the NeWS and PostScript languages, see
  1174.  
  1175.     The NeWS Book, Springer Verlag, 1989 (sadly, a little out of date)
  1176.  
  1177.     PostScript Language Reference Manual, Second Edition,
  1178.     Adobe Systems Inc., Addison Wesley, 1990 ["the Red Book"]
  1179.         Note that OpenWindows 3 is a level 1 PostScript implementation,
  1180.         with certain Level 2 features (such as Composite Fonts) to some
  1181.         degree.
  1182.     
  1183.     PostScript Language Tutorial and Cookbook,
  1184.     Adobe Systems Inc., Addison Wesley, 1985 ["The blue book"]
  1185.     
  1186.     There are several books on using Solaris (i.e. SunOS).
  1187.     See the FAQ in the Solaris newsgroup.  I'll mention here:
  1188.     `Solaris Porting Guide', SunSoft ISV Engineering et. al.,
  1189.     1993, SunSoft Press (Prentice Hall), ISBN 0-13-030396-8
  1190.     for an excellent (if sometimes over-ebullient) introduction to the
  1191.     differences and new features of Solaris 2, including a clear section
  1192.     on localisation and internationalisation.   Includes diskette.
  1193.  
  1194.     Sun also supplies a large amount of documentation with OpenWindows,
  1195.     although you may have to order it separately.  Here's what I have; they
  1196.     are each a little over 21 cm square (wider than A4 paper), and vary from
  1197.     about 1 cm to about 3cm thick.  They say `User's Guide' or `Programmer's
  1198.     Guide' on the front.  The User manuals have a red stripe on the bottom,
  1199.     and the Programmer ones have a green stripe.
  1200.  
  1201.     Note:
  1202.     the Solaris 2 documentation sets are red, blue and silver.
  1203.     Watch in particular for small spiral-bound task-oriented `how-to'
  1204.     booklets in the Solaris 2 documentation.
  1205.  
  1206.     Here are the OpenWindows 3.0 part numbers for SunOs 4:
  1207.  
  1208.     800-6006-10 OpenWindows Version 3 Release Manual
  1209.     800-6029-10 OpenWindows Version 3 Installation and Start-Up Guide
  1210.     800-6231-10 OpenWindows Version 3 DeskSet Reference Guide
  1211.     800-6618-10 OpenWindows Version 3 User's Guide
  1212.     800-6323-10 Desktop Integration Guide [also available in bookstores?]
  1213.     800-6027-10 Programmer's Guide
  1214.     800-6005-10 OpenWindows Version 3 Reference Manual [the man pages]
  1215.     800-6319-10 The NeWS Toolkit 3.0 Reference Manual
  1216.     800-6736-10 NeWS 3.0 Programming Guide
  1217.     800-6055-10 OLIT 3.0 Widget Set Reference Manual
  1218.     800-6198-10 XView 3.0 Reference Manual: Converting SunView Applications
  1219.  
  1220.     800-6854-10 F3 Font Format Specification [order separately]
  1221.  
  1222.     There are also some other sets of documentation, including the TypeScaler
  1223.     documentation from the OpenFonts group, for example.  There doesn't seem
  1224.     to be a complete list anywhere.
  1225.  
  1226.     ??????????? ToolTalk 1.0 Setup and Administration Guide (SunSoft, 1991)
  1227.     800-6093-10 ToolTalk 1.0 Programmer's Guide (SunSoft, 1991)
  1228.     There might be documentation about the Link Manager somewhere, too;
  1229.     I am not sure what happened to the Link Manager, is that part of DOE??
  1230.  
  1231.     AT&T includes several large thorny bushes' worth of paper with OLIT.
  1232.  
  1233.     Sun's AnswerBook CD/ROM contains a lot of the above documentation.
  1234.  
  1235.     Volume 8 of the O'Reilly series is about X Administration, and mentions
  1236.     OpenWindows, although it is primarily aimed at X11R5.  A CD/ROM is
  1237.     included, which contains a working X11R5 distribution.  This book will
  1238.     be of particular use with OpenWindows 3.3 and later, based on X11R5.
  1239.  
  1240.  
  1241. Subject: Getting this File, Revision History, Recent Changes
  1242.  
  1243.     Mail lee@sq.com to ask for it.  Douglas N. Arnold (dna@math.psu.edu)
  1244.     keeps an up-to-date copy on ftp.math.psu.edu (currently 146.186.131.129)
  1245.     in the file ~ftp/pub/FAQ/open-look.
  1246.  
  1247.     An automatically generated HTML verion of this file is available from
  1248.     http://www.join.ad.jp/tech/faq-e/text/
  1249.     courtesy of Takayuki Fujino <fujino@cc.kagu.sut.ac.jp>.
  1250.  
  1251.  
  1252. # @(#) $Id: ol1.faq,v 1.58 97/04/03 23:55:41 lee Exp $
  1253.  
  1254.  
  1255. Acknowledgements:
  1256.     Dale Dougherty <dale@ora.com> (Nov/info about new XView book)
  1257.     Antonio Freixas <tonyf@ims.com> (Nov/Motif patch and Escape tip)
  1258.     Karl Glazebrook <kgb@mail.ast.cam.ac.uk> (Motif copy/paste)
  1259.  
  1260.     And many others...    You get deleted from this list after a while.
  1261.  
  1262. -- 
  1263. Liam Quin                   | lq-text freely available Unix text retrieval
  1264. liamquin at interlog.com    | FAQs: Metafont fonts, OPEN LOOK UI, OpenWindows
  1265.                             | xfonttool (Unix xfontsel in XView)
  1266. +1 416 594 9646 (home)      | the barefoot programmer
  1267.