[Open-graphics] Documentation on the video controller

[Dieter]

> > (1) Provide with the docs a README.latex that explains LaTeX, what
> > packages people should use for various platforms, instructions, etc.,
> > and lists the (current) location of the PDFs.
> 
> I'm somewhat against this. It's an effort to write such a document
> correctly and we need to keep it up to date.

There is probably an existing document somewhere that explains LaTeX,
and OGP could provide a URL.  Why reinvent the wheel?

> And as i said, it's
> like assuming that people who want to compile a program do not
> have a c compiler installed.

C is extremely common.  Most Unix systems come with at least one C compiler.
LaTeX is nowhere near as common as C.  More like Haskell or APL.

> In the unix world, latex is standard

man -k latex
latex: nothing appropriate

The Unix documentation system is the roff family.

LaTeX is an alternative documentation system, it is well down the list
and losing ground.

> and can be easily installed.

Maybe, maybe-not, but why should an end-user need to?  Some machine can
automagically create a few common formats, that most people already have
viewers for, like html/pdf/info/whatever and install them on some web server.

I am not suggesting that there is anything wrong with LaTeX, or that it
shouldn't be used.  I'm just suggesting that there is no need to burden
end-users with learning about LaTeX, hunting down LaTeX software, getting
it to compile, and installing it, etc. when it would be easy to provide them
with more common formats.