Re: User manual cleanup

[Corinna Vinschen <corinna-cygwin at cygwin dot com>]

On Dec 11 10:54, Warren Young wrote:
> On Dec 11, 2014, at 3:03 AM, Corinna Vinschen <corinna-cygwin@cygwin.com> wrote:
> 
> > On Dec 10 16:34, Warren Young wrote:
> >> I kind of thought Iâd been kicked off that project, after leaving the
> >> autodep stuff hanging. :)
> > 
> > I'd never have kicked you out.  Contrary to that, I was disappointed
> > that you apparently quickly lost interested in working on the docs.
> 
> I rarely read the docs â shocking, I know â so I donât get annoyed by
> their state.

<feign>
That's terrible!  Unbelievable!  How dare you!
</feign>

> So, when you find a section of the docs that sucks, and you canât be
> bothered to fix it at the moment, ping me.

That's a nice offer, thank you!

> > <screen>
> >     "SYSTEM" S-1-5-18                    <=> uid/gid: 18
> >     "Users"  S-1-5-32-545                <=> uid/gid: 545
> > </screen>
> 
> I think you might want <informaltable> here:
> 
>  http://docbook.org/tdg/en/html/informaltable.html

Thank you, I'll play around with this and see how it turns out.

> If the results donât look good to you, it probably only requires some
> CSS to fix it.

I'm not overly familiar with this stuff, so I might have to take on your
above offer :}

> Thatâs a common trap with DocBook: trying something and not liking the
> initial rendered result, and dismissing it right there without trying
> to customize it first.

I tried with the others, but whatever I tried was apparently wrong and
mostly had no effect at all...


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Maintainer                 cygwin AT cygwin DOT com
Red Hat

Attachment: pgpJ6NXL8wpnR.pgp
Description: PGP signature