Bug 37536 - Documentation refers to invalid contrib/examples/mit/Xaw
Summary: Documentation refers to invalid contrib/examples/mit/Xaw
Status: RESOLVED FIXED
Alias: None
Product: xorg
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 7.6 (2010.12)
Hardware: x86-64 (AMD64) Linux (All)
: medium minor
Assignee: Alan Coopersmith
QA Contact: Xorg Project Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-05-24 04:17 UTC by Christopher Yeleighton
Modified: 2011-10-15 15:58 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

Description Christopher Yeleighton 2011-05-24 04:17:10 UTC
The sample code for Athena Widget Set is supposed to be found in contrib/examples/mit/Xaw but they are neither installed nor distributed with libXaw.tar.bz2.
Comment 1 Alan Coopersmith 2011-05-24 08:28:55 UTC
Whatever these examples may have once been, they seem to be long lost
now - I can't find them in http://ftp.x.org/contrib/ which is what
contrib normally refers to.   Will update the Xaw documentation to 
remove the references.
Comment 2 Alan Coopersmith 2011-05-27 20:38:08 UTC
It looks like these were last in the actual X distribution in X11R4 in 1989,
were in the X11R5 contrib release in 1991, then dropped for X11R6 in 1994.
(Have we mentioned yet how very out of date libXaw is?)

You can find them in http://www.x.org/releases/X11R5/contrib-1.tar.Z

Fixed the docs to reflect this:

commit 7d01dd4176b8ae1664218da8e197ef49d1efd05a
Author: Alan Coopersmith <alan.coopersmith@oracle.com>
Date:   Fri May 27 20:35:28 2011 -0700

    Bug 37536: Documentation refers to invalid contrib/examples/mit/Xaw
    
    https://bugs.freedesktop.org/show_bug.cgi?id=37536
    
    Update text to point to the latest distributed copy I found, in the
    X11R5 contrib archives.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>

diff --git a/specs/CH2.xml b/specs/CH2.xml
index 08f0ff5..6e30a35 100644
--- a/specs/CH2.xml
+++ b/specs/CH2.xml
@@ -1880,11 +1880,12 @@ can be used, as in the first approach, for easier code m
 The best way to understand how to use any programming library is by
 trying some simple examples.  A collection of example programs that
 introduces each of the widgets in that Athena widget set, as well as many
-important toolkit programming concepts, is available in the X11R6
+important toolkit programming concepts, is available in the X11R5 contrib
 release as distributed by the X Consortium.  It can be found in the
-distribution directory <function>contrib/examples/mit/Xaw</function>, but see y
-site administrator for the exact location of these files on your system.
-See the README file from that directory for a guide to the examples.
+directory <filename>contrib/examples/mit/Xaw</filename> in the archive
+at <ulink url="http://www.x.org/releases/X11R5/contrib-1.tar.Z" />
+See the <filename>README</filename> file from that directory for a guide
+to the examples.
 </para>
 </sect2>
 </sect1>
Comment 3 Christopher Yeleighton 2011-05-28 00:16:37 UTC
(In reply to comment #2)

> +directory <filename>contrib/examples/mit/Xaw</filename> in the archive

it is actually <filename>contrib/examples/Xaw</filename>
Comment 4 Alan Coopersmith 2011-05-28 09:03:52 UTC
Oops - fixed:
http://cgit.freedesktop.org/xorg/lib/libXaw/commit/?id=f5823ff8ed5bd280e7858116c3cec5d97184b175

Thanks for double-checking my update.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.