[mythtv] documentation

[jam]

On Sat, 2009-11-07 at 12:00 +0000, mythtv-dev-request at mythtv.org wrote:
> every now and again i think that i should write a book on myth. after
> all, i spend some much time faffing about with it. another motivation
> is
> that my better half gets terribly fed up as she doesn't understand how
> to use the software.
> 
> so with that said, i was thinking about aggregating the words in the
> documentation, stuff from the wiki, and anything else i can lay my
> hands
> on. i have the various mailing lists archived back into the mists of
> time. but certainly there is useful stuff in -dev going over the last
> 12
> months.
> 
> my proposal would be to take all this and produce a "book" for want of
> a
> better term. it would be released under a compatible licence (not
> investigated what would be best - for some value of best).
> 
> i really, really, really do not like Microsoft. with a passion, you
> might say. having said that, i use ms word for about 4-5 hours a day
> for
> my job of work. for this reason, the current tool that i'm using to
> work
> on the text is word. it can be converted to whatever format is deemed
> acceptable at some point in the future.

I find that there is a gulf between the wiki and TheCurrentRelease.
TheCurrentRelease is what the developers *know*. 

IMHO an introduction (Jarrad Wilson's stuff dates from when myth was
really esoteric and hard to setup) would cover basic setup then the meat
of the work would cover a reference for non trivial users.

EGs /tmp is used for snapshots that are taken by <read the source>
    My slave backend says 'Tuner asleep'. What's that mean ?
    How to enable the cut list in archive? (C) but that is hard to
discover

and a plethora of detail that is not revealed.

That MS is utterly evil does not prevent them from making good software,
so appologise not for using MSWord. Interesting to observe my wife, as a
total neophite, make much better progress with crossover/MSword than
OOffice! 
   
James