status and how to update, build documentation

[Alan Coopersmith]

Jeremy C. Reed wrote:
> A lot of the xorg documentation appears out-of-date, such as
> xc/programs/Xserver/hw/xfree86/doc/sgml/NetBSD.sgml (note about
> perl).
> 
> It appears that a lot of the docs are just regenerated with an updated
> release version but the content not updated.

Yes.  I had to update some really old bits on the README.Solaris and
am sure others need to be revisited as well, but don't think anyone has
organized a concerted effort to do that.


> Instead of working on old formats, is there any consensus to move to a new
> or different format? (Where is this discussed?)

I think there's a consensus to try to move everything to something XML 
based, probably DocBook, but no one has started working on it that I've
seen.   It's a big task, and probably needs to be organized into chunks that
can be split out among a number of volunteers.

-- 
	-Alan Coopersmith-           alan.coopersmith at sun.com
	 Sun Microsystems, Inc. - X Window System Engineering