Documentation patches

[Joe Marcus Clarke]

On 12/24/10 9:52 AM, Chris Rees wrote:
> On 23 December 2010 18:07, Jason Helfman <jhelfman at e-e.com> wrote:
>> On Thu, Dec 23, 2010 at 06:07:13PM +0000, Chris Rees thus spake:
>>>
>>> On 23 December 2010 17:28, Jason Helfman <jhelfman at e-e.com> wrote:
>>>>
>>>> On Thu, Dec 23, 2010 at 03:44:49PM +0000, Chris Rees thus spake:
>>>>>>
>>>>>> The README in HEAD is the master doc.  From there, I port content (not
>>>>>> necessarily formatting) to README.html.  If you provide diffs to the
>>>>>> README, I'll see they are incorporated into README.html.
>>>>>>
>>>>>> That said, if you wanted to automate this by converting the
>>>>>> documentation to SGML or XML that would be great!
>>>>>>
>>>>>> Joe
>>>>>>
>>>>>
>>>>> That was my original idea, I'll work on that for you.
>>>>
>>>> Original meaning move it to SGML?
>>>>
>>>
>>> Yeah; I figure that programmers' time could be better spent than
>>> hand-merging the HTML doc and ASCII doc.
>>>
>>> I'm sure they don't enjoy it!
>>>
>>> I won't make it too complicated; it's only a fairly short document,
>>> but I've stolen the FreeBSD Handbook DTDs to make it look like that;
>>> the README already does.
>>>
>>> Chris
>>>
>>
>> You beat me to it :)
>> I've done my fair share of sgml documentation, and even wrote an article.
>> When I saw that, I was going to jump all over it.
>>
>> Have fun.
>>
>> -jgh
>>
> 
> Well, I've got this so far:
> 
> http://www.bayofrum.net/~chris/tinderbox-doc/index.html
> 
> I'm having to take a break now because... well it's that time of year again.
> 
> If anyone wants to have a look at the sources they can get it
> anonymously from me at
> :pserver:anonymous at amnesiac.bayofrum.net:/exports/cvsroot
> tinderbox-doc (no anonymous password)

Looks like we have a permissions problem:

cvs checkout: failed to create lock directory for
`/exports/cvsroot/CVSROOT' (/exports/cvsroot/CVSROOT/#cvs.history.lock):
Permission denied
cvs checkout: failed to obtain history lock in repository `/exports/cvsroot'
cvs checkout: failed to create lock directory for
`/exports/cvsroot/tinderbox-doc'
(/exports/cvsroot/tinderbox-doc/#cvs.lock): Permission denied
cvs checkout: failed to obtain dir lock in repository
`/exports/cvsroot/tinderbox-doc'
cvs [checkout aborted]: read lock failed - giving up

> 
> Not sure if you want to make a module on marcuscom for it yet...

I was going to add it to the tinderweb module once I get the source.

Joe

-- 
PGP Key : http://www.marcuscom.com/pgp.asc