Path: bloom-beacon.mit.edu!hookup!swrinde!ihnp4.ucsd.edu!usc!howland.reston.ans.net!europa.eng.gtefsd.com!news.umbc.edu!cs.umd.edu!kong.gsfc.nasa.gov!kong.gsfc.nasa.gov!not-for-mail
From: dealy@kong.gsfc.nasa.gov (Brian Dealy)
Newsgroups: comp.windows.x.motif,news.answers,comp.answers
Subject: Motif FAQ (Part 1 of 5)
Followup-To: poster
Date: 14 Apr 1994 15:20:33 -0400
Organization: NASA/Goddard Space Flight Center
Lines: 1020
Approved: news-answers-request@MIT.Edu
Distribution: inet
Expires: +2 months
Message-ID: <2ok521$5eg@kong.gsfc.nasa.gov>
Reply-To: dealy@kong.gsfc.nasa.gov (Brian Dealy)
NNTP-Posting-Host: kong.gsfc.nasa.gov
Summary: This posting contains a list of Frequently Asked Questions and their answers about Motif.
Keywords: FAQ question answer
Xref: bloom-beacon.mit.edu comp.windows.x.motif:15724 news.answers:18057 comp.answers:4908

Archive-name: motif-faq/part1
Last-modified: APR 04, 1994
Version: 3.6


Motif FAQ

[Last changed: 04 APR 94]

This article contains the answers to some Frequently Asked Questions (FAQ) 
often seen in comp.windows.x.motif. It is posted to help reduce volume in 
this newsgroup and to provide hard-to-find information of general interest.

		Please redistribute this article!

This FAQ is maintained by Brian Dealy <dealy@kong.gsfc.nasa.gov>.  Send
updates and corrections to me at that mail address.  It would help if
the subject line contained the phrase "FAQ".  I will Be making a
HTML version available in the very near (MAY)? future. It will hopefully 
provide a much fuller set of resources including URLs for examples and 
free software. It will require a bit of reorganizing and rewriting, but 
it should be well worth the wait.

History:
From November 89-July 93 the FAQ was maintained by Jan Newmarch
<jan@ise.canberra.edu.au>

This article includes answers to the following questions. Ones marked with
a + indicate questions new to this issue; those with changes of content since
the last issue are marked by *:


 0)* TOPIC: WHAT ARE OTHER RELEVANT NEWSGROUPS?
 1)  TOPIC: FTP ARCHIVES
 2)  Is the FAQ list available for FTP anywhere?
 3)* Is this FAQ accessible via WWW?
 4)  Is this newsgroup accessible via email?
 5)  Is this newsgroup archived?
 6)  Is the mail list motif-talk archived?
 7)  TOPIC: OSF AND MOTIF
 8)  Because of COSE, is Motif now in the public domain?
 9)* What versions of Motif are there?
10)* Where can I get Motif?
11)  Is there a list of Motif bugs?
12)  Where can I get public domain Motif source?
13)* Are the Motif examples publically available?
14)* Has anyone done a public domain Motif lookalike?
15)  Does anyone from OSF pay attention to our questions/suggestions?
16)  Does OSF have an application compliance validation service?
17)  What is the motif-talk mailing list?
18)  What MIT patches do I use, and when do I use fix-osf?
19)  How does Motif work with X11R5?
20)* How can I find which version of Motif I have?
21)  TOPIC: LITERATURE
22)* What books should I read or do I need to program using Motif?
23)  TOPIC: MWM
24)  What is the difference between Motif and mwm?
25)  Does anyone have an alternative set of  3-D  defaults  for  a  monochrome
screen?
26)  How can I modify the Motif window manager decorations?
27)  How can I turn off the Motif window manager  functions  from  the  system
menu?
28)  How can tell I if the user has selected the "Close" item  on  the  system
menu attached to the top-level shell?
29)  Is there an mwm virtual desktop manager?
30)  Why does mwm 1.2 crash on startup?
31)  TOPIC: MOTIF GENERATORS
32)  What prototyping tools are there to generate Motif code?
33)  TOPIC: TEXT WIDGET
34)  What is the difference between a XmTextField widget and a single
35)  Why does  pressing  <return> in a text widget do nothing?
36)  When I add text to a scrolling text widget how can I get the new text  to
show?
37)  Does the text widget support 16 bit character fonts?
38)  How can I stop the text widget from echoing characters typed?
39)  How can I replace characters typed with say a `*'?
40)  How can I best add a large piece of text to a scrolled text widget?
41)  How can I highlight text in the Text widget?
42)  How can I select all of the text in a widget programmatically?
43)  How can I change colours of text in the Text widget?
44)  How can I change the font of text in the Text widget?
45)  Is there an emacs binding for the text widget?
46)  How can I use a file as the text source for a Text widget?
47)  How can put Text in overstrike mode instead of insert?
48)  How can I make the Delete key do a backspace?
49)  TOPIC: LIST WIDGET
50)  Should I create an XmList widget as a child of automatic  
     XmScrolledWindow or use the XmCreateScrolledList() convenience function?
51)  How do I best put a new set of items into a list?
52)  Can I have strings with different fonts in a list?
53)  Can I get a bitmap to show in a list item like I can in a Label?
54)  Can I have items with different colours in a list?
55)  Can I grey out an item in a list?
56)  Can I have multi-line items in a list?
57)  How can I tell the position of selected items in a list?
58)  TOPIC: FILE SELECTION BOX WIDGET
59)  What is libPW.a and do I need it?
60)  What are these compile errors: Undefined symbol _regcmp and _regex?
61)  What's wrong with the Motif 1.0 File Selection Box?
62)  TOPIC: FORM WIDGET
63)  Why don't labels in a Form resize when the label is changed?
64)  How can I center a widget in a form?
65)  How do I line up two columns of widgets of different types?
66)  TOPIC: PUSHBUTTON WIDGET
67)  Why can't I use accelerators on buttons not in a menu?
68)  TOPIC: LABEL WIDGET
69)  How can I align the text in a label (button, etc) widget?
70)  Why doesn't label alignment work in a RowColumn?
71)  How can I set a multiline label?
72)  How can I have a vertical label?
73)  How can I have a Pixmap in a Label?
74)  TOPIC: DRAWING AREA WIDGET
75)  How can I send an expose event to a Drawing Area widget?
76)  How can I know when a DrawingArea has been resized?
77)  TOPIC: MENUS
78)  What can I put inside a menu bar?
79)  Can I have a cascade button without a submenu in a pulldown menu?
80)  Should I have a cascade button without a submenu in a pulldown menu?
81)  What is the best way to create popup menus?
82)  How do popup menus work?
83)  Should I use translation tables or actions for popup menus?
84)  What are the known bugs in popup menus?
85)  Can I have multiple popup menus on the same widget?
86)  TOPIC: INPUT FOCUS
87)  How can I specify the widget that should have the keyboard focus  when  my
     application starts up?
88)  How can I direct the keyboard input to a particular widget?
89)  How can I have a modal dialog which has to be answered before the  
     application can continue?
90)  TOPIC: MEMORY AND SPEED
91)  When can I free data structures passed to or retrieved from Motif?
92)  Why does my application grow in size?
93)  Why does my application take a long time to start up?
94)  My application is running too slowly. How can I speed it up?
95)  Why is my application so huge?
96)  TOPIC: XMSTRING
97)  How can I get the Ascii text out of an XmString?
98)  When can XmStrings used as resources be freed?
99)  Why doesn't XmStringGetNextSegment() work properly?
100)  Why does using XmStringDraw cause a Bad Font error?
101)  TOPIC: DIALOGS
102)  How do I stop my dialog disappearing when I press the help button?
103)  How do I make my own dialog?
104)  How come the title bars for my dialogs now have  "_popup"  or  
      "<-popup" concatenated onto the widget name?
105)  How can I force a dialog window to display?
106)  How can I control placement of a popup widget?
107)  TOPIC: LANGUAGE BINDINGS
108)* Is there a C++ binding for Motif?
109)  How can I have a C++ member function in a callback?
110)  Is there a Common Lisp binding for Motif?
111)* Is there an Ada binding for Motif?
112)  Is there a Poplog binding for Motif?
113)  TOPIC: SPECIFIC PLATFORMS
114)  Is it easy to build Motif for a Sun?
115)  How do I build Motif 1.2.2 on Solaris 2.1 with Sun C?
116)  What compile errors/warnings might I get in both Sun 3 and Sun 4?
117)  On a Sun 3, what are the mwm startup error messages about?
118)  Are there problems making shared libraries on a Sun?
119)  The OpenWindows server hangs when I popup a menu with Button 3.
120)  Has anyone made shared libraries on an IBM RS/6000?
121)  What is the error  "Unaligned access in XmString" under Ultrix?
122)  TOPIC: KEYSYMS
123)  What is causing the messages "unknown keysym osfDown..."?
124)  What happens if I can't install Motif Keysyms?
125)  Why has OSF introduced Keysyms into Motif 1.1?
126)  TOPIC: ICONS
127)  How can I keep track of changes to iconic/normal window state?
128)  How can I check if my application has come up iconic?
129)  How can I start my application in iconic state?
130)  How can an application iconify itself?
131)  How can an application de-iconify itself?
132)  TOPIC: MISCELLANEOUS
133)+ How do I controll the repeat rate on a SUN keyboard ??
134)  How can I identify the children of a manager widget?
135)  How do I tell if a scrolled window's scrollbars are visible?
136)  How can I programatically scroll a XmScrolledWindow in XmAUTOMATIC mode?
137)  What functions can an application use to change the size or position  
      of a widget?
138)  What widgets should I use to get the look of push buttons, but
139)+ How do I obtain the size of a unmanaged shell widget?
140)  Can  I  use  XtAddTimeOut(),  XtAddWorkProc(),  and  XtAddInput()  
      with XtAppMainLoop()?
141)  Why does XtGetValues() XmNx and XmNwidth return extremely large values.
142)  Can I specify callback functions in resource files?
143)  How do I specify a search path for ".uid" files?
144)  XtGetValues() on XmNx and XmNy of my top level shell  don't  return  
      the correct root window coordinates.  How do I compute these?
145)  Can I use XmGetPixmap() with widgets that have non-default visual types?
146)  How can I determine the item selected in a option menu or a RadioBox?
147)  What is the matter with Frame in Motif 1.2?
148)  What is IMUG and how do I join it?
149)  What is the X Professional Organization
150)  How do I set the title of a top level window?
151)  Can I use editres with Motif?
152)  How can I put decorations on transient windows using olwm?
153)  Why does an augment translation appear to act as replace for some 
      widgets?
154)  How do you "grey" out a widget so that it cannot be activated?
155)  Why doesn't the Help callback work on some widgets?
156)  Where can I get a Table widget?
157)  Has anyone done a bar graph widget?
158)  Does anyone know of a source code of a graph widget
159)+ Is there a help system available, such as in Windows 3?
160)  Can I specify a widget in a resource file?
161)  Why are only some of my translations are being installed?
162)  Where can I get the PanHandler code?
163)  What are these passive grab warnings?
164)  How do I have more buttons than three in a box?
165)  How do I create a "busy working cursor"?
166)  Can I use the hourglass that mwm uses?
167)  What order should the libraries be linked in?
168)  How do I use xmkmf for Motif clients?
169)  How do I make context sensitive help?
170)  How do I debug a modal interaction?
171)+ How can I disable Drag and Drop in my Motif 1.2 client ?
172)  Where can I get info on the Motif drag and drop protocol?
173)  TOPIC: ACKNOWLEDGEMENTS













If you have suggestions or corrections for any of these answers or any 
additional information, please send them directly to dealy@kong.gsfc.nasa.gov;
the information will be included in the next revision (or possibly the one 
after that; thanks for the many suggestions which haven't been incorporated 
yet).  The answers in this iteration are acknowledged to be partial.

This posting is intended to be distributed at approximately the beginning of 
each month.

The information contained herein has been gathered from a variety of sources. In
many cases attribution has been lost; if you would like to claim responsibility
for a particular item, please let us know. 

Conventions used below: telephone numbers tend to be Bell-system unless 
otherwise noted; prices on items are not included.
copyright 1993 b.dealy







-----------------------------------------------------------------------------
Subject:  0)* TOPIC: WHAT ARE OTHER RELEVANT NEWSGROUPS?

[Last modified: Feb 93]

Answer: This newsgroup is comp.windows.x.motif.

The nearest related group is comp.windows.x.  It also maintains an FAQ, which
deals in all sorts of X, Xlib and Xt questions. Look there for answers to
questions such as "How do I get a screendump of my application?", "where do I
get X11R4,X11R5, X11R6", etc.  Other groups which may have relevant
information are comp.windows.x.pex, comp.windows.x.apps,
comp.windows.x.intrinsics, comp.windows.news, comp.windows.misc and
comp.windows.open-look.  The intrinsics and open-look groups also have an FAQ.

The newsgroup news.answers contains *lots* of FAQs (including this one).  Look
there for lots of info on everything.

-----------------------------------------------------------------------------
Subject:  1)  TOPIC: FTP ARCHIVES

-----------------------------------------------------------------------------
Subject:  2)  Is the FAQ list available for FTP anywhere?

[Last modified: Dec 93]

Answer: A number of FAQ's (including this one) are available for anonymous ftp
at rtfm.mit.edu, under the directory pub/usenet.  (Motif is under
pub/usenet/comp.windows.x.motif and also under
pub/usenet/comp/windows/x/motif) There is also a mail server called mail-
server@rtfm.mit.edu.  To retrieve a file send mail to the server with a
subject or body similar to

        send usenet/comp.windows.x.motif/Motif_FAQ_(Part_1_of_5).Z

This service is looked after by Jonathan Kamens (jik@rtfm.mit.edu).

It has also been placed in contrib/Motif-FAQ at
ftp://ftp.x.org/contrib/Motif-FAQ

This files are also accessible from WAIS (Wide Area Information System) under
UC-Motif-FAQ, allowing keyword-based searches of the FAQ.  ---------
--------------------------------------------------------------------
Subject:  3)+ Is this FAQ accessible via WWW?

[Last modified: Dec 93]

Answer: A simple version of the FAQ has been htmlized on news.answers But a
more in-depth restructuring is under way and should be available soon at a web
server near you.

-----------------------------------------------------------------------------
Subject:  4)  Is this newsgroup accessible via email?

[Last modified: April 93]

Answer: An email link is maintained by Brian Dealy.  To join, send mail to
motif-request@lobo.gsfc.nasa.gov.

-----------------------------------------------------------------------------
Subject:  5)  Is this newsgroup archived?

[Last modified: November 1992]

Answer: The newsgroup files from August 1991 are available from
csc.canberra.edu.au (137.92.1.1) by anonymous ftp.  They are in the directory
/pub/motif/comp.windows.x.motif.

These files are also accessible from WAIS (Wide Area Information System) under
comp.windows.x.motif, allowing keyword-based searches of the newsgroup
articles (this time on machine services.canberra.edu.au (137.92.1.12)).

-----------------------------------------------------------------------------
Subject:  6)  Is the mail list motif-talk archived?

Answer: If you have purchased support from OSF then you have access to their
archive server for motif-talk.

-----------------------------------------------------------------------------
Subject:  7)  TOPIC: OSF AND MOTIF

-----------------------------------------------------------------------------
Subject:  8)  Because of COSE, is Motif now in the public domain?

Answer: The *specification* for Motif is no longer controlled by OSF, but by
X/Open.  This does not affect the *implementation*. The implementation is
still in the hands of OSF, and will not be released into the public domain.
So no, the OSF source code will still only be available to those who buy a
source code license from OSF.

The specification does not include UIL or obsolete features (ie 1.0 bugs in
design), but these will continue to be supported by the OSF code.

-----------------------------------------------------------------------------
Subject:  9)* What versions of Motif are there?
[Last modified: March 93]

Answer: Motif 1.0 is based on the R3 toolkit.  There are patch releases to
1.0: 1.0.1, 1.0.A, 1.0.2 and 1.0.3, 1.0.4, 1.0.5. 1.0.A was a fairly major
patch, as it involved a complete re-engineering of UIL and Mrm.  Almost
everyone who has 1.0.x has either 1.0.A or 1.0.3.

Motif 1.1 is based on the R4 toolkit.  The intial version was Motif 1.1.0.
Motif 1.1.1 has been released as a patch to licensees with Full Support or
Technical Update service.  Motif 1.1.2 is a patch release which contains the
necessary changes to fix over 80 bugs reported against Motif. It is available
to support contract holders (including both full support and update service).
The 1.1.3 release fixed a further 150 bugs and was available from August 1991
to support contract holders (including both full support and update service).
1.1.4 offers X11R5 support, but is not an X11R5 product.  1.1.5 was released
in June 92 to licensees who hold a Motif Full Support or Update Support
contract

Motif 1.2.0 was released in April 1992 and is based on the X11R5 toolkit.  It
offers increased compatibility with international standards,  PC-style
behavior and binary compatibility with OSF/Motif 1.1 applications.  New
features include drag-and-drop, tear- off menus, toolkit enhancements and new
documentation.  toolkit.  The code is totally ANSI C.  OSF distributes a 10
pages sheet entitled "OSF/Motif R1.1 to R1.2: detailed overview of changes",
which is available from OSF Motif direct channels.  (617-621-7300 or email
direct@osf.org)

Motif 1.2.1 was released September 92.  Due to an optimisation from 1.2.0 to
1.2.1 object code compiled under 1.2.1 (that is, using 1.2.1 header files)
will not link with 1.2.0 libraries (and, very probably, clients that use
shared libraries and are linked against 1.2.1 won't startup against 1.2).

Motif 1.2.2 was released March 93.  This release contains over 250 bug fixes,
improved text, drag-and-drop features and has less than one reported defect
per 1000 lines of code.

from dbrooks@osf.org Motif 1.2.3 was released on September 13, 1993.  The
defect density is measured at < 0.8 known reports per thousand lines.  In this
release, we have paid particular attention to memory leaks, and have improved
drag-and-drop performance greatly.


-----------------------------------------------------------------------------
Subject: 10)* Where can I get Motif?

[Last modified: APR 94]

Answer:
    Various hardware vendors produce developer's toolkits of binaries, header
files, and documentation; check your hardware vendor, particularly if that
vendor is an OSF member. Systems known to be shipping now: HP (sans UIL),
Apollo (sans UIL), SCO, ICS, Mips (RISCwindows=X11R3 + full Motif), IBM, Data
General for AViioNs (includes UIL), Bull (?), Concurrent Computer Corporation
5000, 6000, 8000 series machines, Convex, Sequent.

    In addition, independent binary vendors produce Motif toolkits .

[An FAQ is for "personal opinions" on these toolkits.  I don't think it is
appropriate to give such opinions through this particular posting, so I
haven't included any.]

Integrated Computer Solutions, Inc. (ICS) 201 Broadway, Cambridge, MA  02139
USA info@ics.com   617/621-0060

ICS provides binary distributions of Motif for Sun platforms.  Other platforms
are available as well, call or send mail for current info.  ICS also provides
in-depth programming support for Motif and additional tools such as Builder
Xcessory, a Motif interface builder, and the Widget Databook, a source for
third party, commercially available and supported widgets, class libraries,
and subsystems.

Quest (408-496-1900) sells kits for Suns, as well;

IXI (+44 223 236 555) offers kits for Sun3         (SunOS 3.5 or later, and
Sun4         (SunOS 4.0.1 or later).         (Solaris 2.1 or later ( both
SPARC  and Intel ))         ( both M1.1.5 and Motif 1.2.2 for SPARC, Motif
1.2.2 for Intel ).

Sun Microsystems is now shipping a version of Motif also.

NSL (+33 (1) 43 36 77 50; requests@nsl.fr) offers kits for the Sun 3 and Sun
4.


In Australia, Information Technology Consultants Pty Ltd has Motif 1.1.2 for
Sun Sparc 4.1 ( phone on (02) 360 6999, fax on (02) 360 6695 or e-mail to
motif@itcsyd.itc.oz.au)

SILOGIC (+33 61.57.95.95), 78 chemin des Sept Deniers - 31200 TOULOUSE FRANCE
sells Motif 1.1 and 1.2 on Sun4 machines. They also provide customers with
Motif maintenance and support, and do consulting on the X window System at
large, including software development.

METRO LINK INC., has Motif 1.2.3 and Motif 1.2.2 Runtime and Development
packages available for a variety of operating systems.  All versions ship with
shared library version of libXm.  Linux version includes free O'Reilly volume
and FTP shipping option.  Send mail to:

Motif 1.2.3 (available Dec. 1, 1993)
    Linux 0.99, Solaris 2.x (SPARC), SunOS 4.1.x      --->  $199.00
    Solaris 2.1 (x86)                                 --->  $299.00

Motif 1.2.2
    Linux 0.99, Solaris 2.x (SPARC), SunOS 4.1.x      --->  $199.00
    QNX, SVR3, SVR4.[012], SCO, UnixWare, SINIX,
    LynxOS, Venix, ISC, NCR SVR4 MP                   --->  Under $299.00

Metro Link Incorporated.  2213 W. McNab Rd. Pompano Beach,  Florida  33069
Voice: +1.305.970.7353x412  Fax: +1.305.970.7351  Email: ken@metrolink.com




BIM (Fax : +32(2)759.47.95) offer Motif 1.1 for Sun-3, Sun-4, Sun-386i.
Includes shared libraries.

Metrolink Inc. (+1-305-566-9586, sales@metrolink.com; in Europe contact ADNT,
(33 1) 3956 5333) ships an implementation of X11R4 and Motif 1.1 for several
386 systems.

    An OSF/Motif source license must be obtained from OSF before source can be
obtained from the Open Software Foundation. Call the Direct Channel Desk at
OSF at 617-621-7300 or email direct@osf.org for ordering information.

Bluestone offers Motif for $99.  Bluestone's  MWM is the compiled version of
OSF/ Motif for Sun/SPARC. It is plain vanilla Motif based on X11 and Xt
Intrinsics.  There is no license manager.  Platforms: Sun/OS 4.1+ and Solaris
V2.1,2.2. Contact: Bluestone @609-727-4600

In addition to the full Motif source, "option C" allows you to purchase source
for the window manager mwm to run on X terminals.


-----------------------------------------------------------------------------
Subject: 11)  Is there a list of Motif bugs?

Answer: With each patch release of Motif shipped, there is a list of known
bugs provided.  The filename on the tape is "./OPENBUGS".  There is also a
list of all the issues closed/resolved in that patch.  That is found as part
of the "./README-1.1.n" (where n is the patch number) file.

These are the only OSF published lists.

No-one else seems to publish a list.


-----------------------------------------------------------------------------
Subject: 12)  Where can I get public domain Motif source?

Answer: You cannot.  Motif source is not publically available.


-----------------------------------------------------------------------------
Subject: 13)* Are the Motif examples publically available?

[Last modified: DEC 93]

Answer: OSF has produced a list of which of the example programs can be
distributed. Call OSF Direct for a copy of it.  Most of the example programs
have been freed from distribution limitations so should be available.

In addition to these, many programs on export.lcs.mit.edu in the contrib
directory use Motif.  Source code posted to comp.sources.x often uses Motif.

The examples from Dan Heller's book are on export in
/contrib/OReilly/motif/examples.tar.Z.  The examples from Thomas Berlages's
book are on export in /contrib/berlage.motif.tar.Z The examples from Donald L.
McMinds's book are on export in /contrib/mastering.motif.tar.Z The examples
from Jan Newmarch's book are export in /contrib/newmarch.tar.Z The examples
from Jerry Smith's book are on export in contrib/smith.motif.tar.Z

Also from a list maintained by: qizeng@acsu.buffalo.edu (Qi Y. Zeng) FTP sites
for X/MOTIF source codes:

         ftp.uu.net
                published/brain.motif.tar.Z

         ftp.x.org
                contrib/young.C++.tar.Z

         ftp.x.org
                contrib/pwmxmpl.tar.Z

         ftp.x.org
                contrib/newmarch.tar.Z

         ora.com
                pub/examples/xresource

         skye.aiai.ed.ac.uk(192.41.104.6)
                pub/wxwin/wxwin150.tar.Z (UNIX)
                pub/wxwin/wxwin150.zip (PC)

-----------------------------------------------------------------------------
Subject: 14)* Has anyone done a public domain Motif lookalike?

[Last modified: March 93]

Answer: Not yet.  The specification is available (AES), and the validation
suite can be bought, but no-one has taken up the challenge.  There are some
commercial lookalikes (Looking Glass and Neuron Data), but no workalikes.

Applications that follow the Style Guide might be certified Motif-compliant
through the checklist process, even though they're not using OSF/Motif
binaries.

Tcl/Tk is available for ftp from allspice.berkeley.edu, and although
implemented without Xt, has a "strict Motif" mode.

Strom Sytems (18666 Redmond Way o-2118, Redmond, WA 98052-6725) have a Simple
Toolkit for X-Windows (sic) that appears to follow the Style Guide even though
it doesn't quite look like Motif.

MOOLIT is a USL product that can be runtime switched between the Sun Open Look
and Motif appearance.  It is based on  OLIT 4i.

Interviews is a C++ based product with appearance similar to Motif.  A ftp-
able version is on interviews.stanford.edu.  A commercial version is available
as InterViews Plus.


-----------------------------------------------------------------------------
Subject: 15)  Does anyone from OSF pay attention to our questions/suggestions?

Answer: Yes, and they quite often post answers too. But they may not respond
to *your* problem because they have other things to do as well.  This
newsgroup is not run by OSF, and has no formal connection with OSF.  OSF is a
member-driven company.  The membership (and anyone can be a member) provides
the primary input for future development of Motif.

-----------------------------------------------------------------------------
Subject: 16)  Does OSF have an application compliance validation service?

Answer: They have a checklist and a certification process which you can
request from them.  Ask for the Level One Certification Checklist.  The
process is one of self-certification.  It tests only the appearance and
behavior of the application against Motif style.  The product will also be put
in the OSF reference listing.  There's a one-time fee of $250.  According to
the master license agreement, you can't use any OSF identifying mark unless
you have done a certification.


-----------------------------------------------------------------------------
Subject: 17)  What is the motif-talk mailing list?

Answer: The motif-talk mailing list is only for those who have purchased a
Motif source code license. You can be placed on this list by emailing to
motif-talk-request@osf.org, citing your Company name and source license
number.



-----------------------------------------------------------------------------
Subject: 18)  What MIT patches do I use, and when do I use fix-osf?

Answer: The Motif 1.1.0 tape contains MIT patches 1-14. Apply these and any
others you can get.  If your MIT patch level only goes up to fix-16, you also
need to apply fix-osf.  Fix-osf was an emergency patch for a problem that
existed when the Motif 1.1 tape was cut, The MIT fix-17 completely superseded
osf-fix, so if you have applied fix-17 do not apply fix-osf.  The 1.1.1 tape
contains MIT fixes 15-18, as well as an OSF-developed fix that deals with a
subtle bug in the Selection mechanism of the Intrinsics.  Most people will
have fix-15 to 18 by now; if you don't have them:

        Back out fix-osf if you have applied it
        Apply fix-15 to 18
        Apply fix-osf-1.1.1

The Selection fix was submitted to MIT, who came up with a different fix.  It
will not be made into an R4 fix but should be in R5. The MIT fix was posted to
motif-talk.


-----------------------------------------------------------------------------
Subject: 19)  How does Motif work with X11R5?

Answer: Motif 1.1.X is only intended to be built with X11R4.  Motif 1.2.X is
for X11R5.  however, Motif 1.1.4 has been set to also work with X11R5.

For Motif 1.1.1, 1.1.2 and 1.1.3 you will need to compile Xlib and Xt with a
MOTIFBC flag set to YES (page 8, section 3.3 of the R5 release notes), or
you'll also have a link problem (LowerCase) and a fatal run time problem
(XContext manager).  If your applications come up with "Unknown keysym name:
osfActivate" errors, check the variable ProjectRoot. The name
/$PROJECTROOT/lib/XKeysymDB will have been wired into your Xlib.

In Motif 1.1.0, XtCallCallback uses NULL as the first argument instead of a
widget ID. This was ok under R4, but must be changed in the source for R5. It
was changed by OSF from Motif 1.1.1 onward.

Mrm won't work at all (can't link since it uses an X private variable that has
disappeared in R5).  Thre is an MIT patch that may fix this??  [I confess
ignorance of Mrm and UIL].

-----------------------------------------------------------------------------
Subject: 20)* How can I find which version of Motif I have?

[Last modified: October 93]

Answer: The macro XmVERSION gives you the version number.  The macro
XmREVISION gives you the major revision number.  The macro XmVersion combines
these e.g. a value of 1002 is Motif 1.2.

To find the minor revision number is not easy.  From Motif 1.1.3 onwards, try
this:

   'strings `which mwm` | grep OSF'.

to get the full version number e.g. 1.1.3.

In Motif 1.2, the macro XmUPDATE_LEVEL was added to give the minor revision
number.

+ ( above also known as the patch level).  + In addition there was a macro
string added,  XmVERSION_STRING which has all + the above info in a char
string.

+ grepping through a strings of libXm.a for OSF can also sometime give +
something useful.

Version X11R6 is due out in spring of 1994 (april 15?)

thanks to hops@x.co.uk Mike Hopkirk

-----------------------------------------------------------------------------
Subject: 21)  TOPIC: LITERATURE

-----------------------------------------------------------------------------
Subject: 22)* What books should I read or do I need to program using Motif?

[Last modified: April 93]

Answer: Ken Lee of the DEC Western Software Laboratory (klee@wsl.dec.com)
regularly posts to comp.windows.x and ba.windows.x a list of reference books
and articles on X and X programming.  In FAQ comp.windows.x an extract of his
list appears. Specifically for Motif programming, though:

OSF/Motif Programmers Guide, Prentice-Hall ISBN 13-640525-8 (Motif 1.0), ISBN
0-13-640681-5 (Motif 1.1), ISBN 0-13-643107-0 (Motif 1.2) (NB: This makes use
of the demo programs that you get with a Motif source license.  The programs
are not included and may or may not be available on your system.)

OSF/Motif Programmers Reference Manual, Prentice-Hall ISBN 13-640517-17 (Motif
1.0),
 ISBN 0-13-640616-5 (Motif 1.1), ISBN 0-13-643115-1 (Motif 1.2) You will need
this for the system calls.

OSF/Motif Style Guide, Prentice-Hall 13-640491-X (Motif 1.0), ISBN 0-13-
640673-4 (Motif 1.1), ISBN 13-643123-2 (Motif 1.2) You will need this to get
some idea of how to write programs with the correct `look and feel'.

You should read at least one of the the non-OSF books on Motif:

Sebern, Mark "Building OSF/Motif Applications: A Practical Introduction". The
ISBN is 0-13-122409-3. Prentice-Hall.

The book uses a large, realistic Motif application (a program to make slides
for presentations) to demonstrate the use of Motif features. Both UIL and
toolkit calls are discussed, though UIL is featured, both in the examples and
in a reference chapter.

Young, Doug. "The X Window System: Applications and Programming with Xt (Motif
Version)," Prentice Hall, 1989 (ISBN 0-13-497074-8). The excellent tutorial "X
Window Systems Programming and Applications with Xt," (ISBN 0-13-972167-3)
updated for Motif.

Marshall Brain at brain@adm.csc.ncsu.edu posted a set of simple and useful
Motif tutorials.

Berlage, Thomas Berlage, OSF/Motif: Concepts and Programming, Addison-Wesley,
UK, 1991. ISBN 0-201-55792-4.

Johnson, Eric F. and Kevin Reichard, Power Programming Motif, MIS: Press,
Portland, OR, 1991. ISBN 1-55828-059-6. Book with disk, ISBN 1-55828-061-8.

Ferguson, Paula M, The Motif Reference Manual, Volume 6B of the O'Reilly
series on X.  This is the new volume of a two volume set on Motif programming.
ISBN 1-56592-038-4 (Motif 1.2)  (Volume 6A is expected to ship soon)

Barkakati, Nabajyoti, X Window System Programming, SAMS. ISBN 0-672-22750-9.
This contains a section on Motif.

Smith, Jerry, Designing X Clients with Xt/Motif, ISBN 1-55860-255-0 Morgan
Kaufmann Publishers This adopts a higher-level approach to many of the objects
that commonly occur in Motif but are not in the Motif API.


Newmarch, Jan, The X Window System and Motif - A Fast Track Approach.
Addison-Wesley, ISBN 0-201-53931-4.

You will also need books and references on Xt such as:

Asente, Paul J., and Swick, Ralph R., "X Window System Toolkit, The Complete
Programmer's Guide and Specification", Digital Press, 1990.  The bible on Xt.
A treasury of information, excellent and invaluable.  Distributed by Digital
Press, ISBN 1-55558-051-3, order number EY-E757E-DP; and by Prentice- Hall,
ISBN 0-13-972191-6.

Nye, Adrian, and Tim O'Reilly, "X Toolkit Programming Manual, Volume 4,"
O'Reilly and Associates, 1989. The folks at O'Reilly give their comprehensive
treatment to programming with the MIT Intrinsics; R4 versions are now
available, as is a Motif 1.1 version (Volume 4M).

Dan Heller's version of the Motif Programming Manual is still a widely used
and useful book. It is being replaced by Volume 6a and 6b but is a very useful
resource. Volume 6, Oreilly and Associates, Motif Edition.

Flanagan, David, ed.,  "X Toolkit Reference Manual, Volume 5," O'Reilly and
Associates, 1992a, Third Edition. A professional reference manual for the MIT
X11R4 and X11R5 Xt.

Books and reference manuals on Xlib may also be useful.

If you want to learn about UIL, look in the Motif Programmers's Guide.  This
seems to be the only information.


-----------------------------------------------------------------------------
Subject: 23)  TOPIC: MWM

-----------------------------------------------------------------------------
Subject: 24)  What is the difference between Motif and mwm?

Answer: mwm is a window manager. Motif itself is made up of four parts: a
User-Interface Guideline, an API toolkit of `C' routines which helps in the
building of applications which conform to the Guideline, the window manager
mwm, and a language UIL which is designed to ease user interface development.
In general mwm will run an application built with any X-windows API, and in
general an application built using the Motif toolkit will run under any window
manager.


-----------------------------------------------------------------------------
Subject: 25)  Does anyone have an alternative set of 3-D defaults for a
monochrome screen?

Answer: This is obviously a matter of taste. Some alternatives suggested
include

!Benjamin Schreiber, bs@osf.osf.org, bs@cs.brandeis.edu
Mwm*foreground:                 black           ! Actually, when a window is
Mwm*background:                 white           ! deactivated, the background
Mwm*backgroundPixmap:           50_foreground   ! becomes white, insted of
Mwm*topShadowPixmap:            white           ! 50% foreground (grey)

Mwm*activeForeground:           black
Mwm*activeBackground:           white
Mwm*activeBackgroundPixmap:     50_foreground
Mwm*activeTopShadowPixmap:      white

Mwm*menu*backgroundPixmap:      background
Mwm*menu*topShadowPixmap:       50_foreground

Mwm*title*foreground:                   black
Mwm*title*background:                   white
Mwm*title*backgroundPixmap:             white
Mwm*title*topShadowPixmap:              50_foreground
Mwm*title*activeForeground:             white
Mwm*title*activeBackground:             black
Mwm*title*activeBackgroundPixmap:       black
Mwm*title*activeBottomShadowPixmap:     50_foreground

Mwm*feedback*backgroundPixmap:          white

or

! From: tsang@isi.com (Kam C. Tsang)
Mwm*background:                      White
Mwm*activeBackground:                White
Mwm*activeBackgroundPixmap:          25_foreground
Mwm*foreground:                      Black
Mwm*activeForeground:                Black
Mwm*menu*background:                 white
Mwm*menu*foreground:                 black
xterm*Foreground:                    black
xterm*Background:                    white


or

! From: ucsd.edu!usc!snorkelwacker!paperboy!yee  (Michael K. Yee)
Mwm*cleanText:                          True

Mwm*activeBackground:           white
Mwm*activeForeground:           black
Mwm*background:                 white
Mwm*foreground:                 black

Mwm*client*activeBackgroundPixmap:      50_foreground
Mwm*client*activeTopShadowPixmap:       foreground
Mwm*client*activeBottomShadowPixmap:    background

!Mwm*client*background:                 white
!Mwm*client*foreground:                 black
Mwm*client*backgroundPixmap:            75_foreground
Mwm*client*topShadowPixmap:             foreground
Mwm*client*bottomShadowPixmap:          background

!Mwm*feedback*background:               white
!Mwm*feedback*foreground:               black
Mwm*feedback*backgroundPixmap:          50_foreground
!Mwm*feedback*topShadowPixmap:          25_foreground
!Mwm*feedback*bottomShadowPixmap:       background

!Mwm*menu*background:                   white
!Mwm*menu*foreground:                   black
Mwm*menu*backgroundPixmap:              foreground
!Mwm*menu*topShadowPixmap:              foreground
!Mwm*menu*bottomShadowPixmap:           background

!Mwm*icon*background:                   white
!Mwm*icon*foreground:                   black
Mwm*icon*activeBackgroundPixmap:        50_foreground
Mwm*icon*activeBottomShadowPixmap:      foreground
Mwm*icon*backgroundPixmap:              75_foreground



-----------------------------------------------------------------------------
Subject: 26)  How can I modify the Motif window manager decorations?

Answer: In resource files, use the window manager's client resource (which is
the application) and the resource clientDecoration:

Mwm*XClock.clientDecoration:   none

turns off all clock decorations.  See the mwm(1) entry for other
possibilities.

Programmatically, set the VendorShell resource XmNmwmDecorations to
appropriate values: MWM_DECOR_NONE (or a bitwise or of values).

-----------------------------------------------------------------------------
Subject: 27)  How can I turn off the Motif window manager functions from the
system menu?
[Last modified: October 92]

Answer: The user of an application can control functions in the system menu
for an application using the mwm resource clientFunctions:

        mwm.application_name.clientFunctions: -resize -close

Note that mwm will have to be restarted after putting this in their resource
database.


Answer: The writer of an application can only remove items.  Be warned that
your users will probably gnash their teeth, swear furiously at your product
and stop using it if they discover that you have done this.  (Especially if
you have removed the Close button, your application has hung and it has taken
up all of memory and swap so it can't be killed.) Much better is to catch the
action gracefully as in the next question.

        #include <Xm/MwmUtil.h>

        XtVaGetValues(shell, XmNmwmFunctions, &int_val, NULL);
        int_val &= ~(MWM_FUNC_CLOSE | MWM_FUNC_ALL);
        XtVaSetValues(shell, XmNmwmFunctions, int_val, NULL);



-----------------------------------------------------------------------------
Subject: 28)  How can tell I if the user has selected the "Close" item on the
system menu attached to the top-level shell?  I need to do some clean up
before exiting.

[Last modified: May 93]

Answer:          This works with R4 Intrinsics

        #include <Xm/Protocols.h>

        void FinalCleanupCB(w, client_data, call_data)
        Widget   w;
        caddr_t  client_data, call_data;
        {
                /* tidy up stuff here */
                ...
                /* exit if you want to */
                exit (0);
        }

        main()
        {
                Atom wm_delete_window;

                ...
                XtRealizeWidget(toplevel);
                ...
                wm_delete_window =
                        XmInternAtom(XtDisplay(toplevel),
                                "WM_DELETE_WINDOW", False);
                XmAddWMProtocolCallback(toplevel, wm_delete_window,
                        FinalCleanupCB, NULL);
                XtMainLoop();
        }

This will still kill the application.  To turn this behaviour off so that the
application is not killed, set the shell resource XmNdeleteResponse to
XmDO_NOTHING.  This means that users cannot kill your application via the
system menu, and may be a bad thing.

If you are running R3, Bob Hays (bobhays@spss.com) has suggested this:
"Trapping on the delete window atom does not work as I cannot force my action
routine to the top of the action list for the activity desired, so the window
manager kills my window anyway BEFORE I can do anything about it.  And, to
make matters worse, the window manager (Motif in this case) tacks its atoms
and handlers onto the window at some unknown point down the line after the
creation of the shell widget as far as I can tell.  So....

I have a procedure as an action routine for ClientMessage.  Then, if I get a
property change event on the window manager protocols, I then tack on
WM_SAVE_YOURSELF.  If I get this request, I clean up (it seems to happen on
WM_DELETE_WINDOW, BTW, if you remove WM_DELETE_WINDOW from the WM protocols
atom) and exit.  Works great and is less filling overall:-)."


-----------------------------------------------------------------------------
Subject: 29)  Is there an mwm virtual desktop manager?

Answer: Peter E. Wagner (pew@cs.brown.edu): Imagine that your "desktop"
extends beyond the view provided by your monitor.  A virtual window manager
gives you access to the space beyond your viewport (i.e. your screen) by
allowing you to move the viewport to other areas of the extended desktop.

The first one is Solbourne's swm, which spawned vtwm/tvtwm/olvwm.

David B. Lewis created one.  suresh@unipalm.co.uk has further developed it
into the UniPalm product DOORS, which is only available as a source code
extension to the MOTIF window manager.  The price of the source and unlimited
right to distribute binaries is 10,000 pounds Sterling.  Alternately, source
and right to use within one company is 2,000 pounds Sterling.  Contact Peter
Dawe

Unipalm Limited                         Voice: +44 (0) 223 420002
216 The Science Park                    Fax:   +44 (0) 223 426868
CAMBRIDGE
CB4 4WA



An enhancement request for such an object has been filed with OSF.

-----------------------------------------------------------------------------
Subject: 30)  Why does mwm 1.2 crash on startup?

[Last modified: March 93]

Answer: From David Brooks: The commonest cause of early mwm demise is as
follows:

- You, or someone, built Xlib in the default way using the Xsi
  internationalization functions.

- Your Xlib wasn't installed completely (or at all).

- Early on, mwm calls the function XmbTextListToTextProperty, which calls
  _XConvertMBToCT, which looks for the Xsi locale database, finds it
  missing, ignores this fact and tries to dereference zero.

The workaround is to find the database *somewhere*, and point the environment
variable XNLSPATH at it.  For example, in my personal X source tree:

        setenv XNLSPATH /home/X11r5src/mit/lib/nls/Xsi


-----------------------------------------------------------------------------
END OF PART ONE
-- 
..........................