Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 27 Aug 1999 01:30:21 -0400
From:      Tim Vanderhoek <vanderh@ecf.utoronto.ca>
To:        Nik Clayton <nik@freebsd.org>
Cc:        Motoyuki Konno <motoyuki@snipe.rim.or.jp>, freebsd-doc@freebsd.org
Subject:   Re: DocBook formatting style?
Message-ID:  <19990827013021.B47771@ppp18415.on.bellglobal.com>
In-Reply-To: <19990826111447.C66300@kilt.nothing-going-on.org>; from Nik Clayton on Thu, Aug 26, 1999 at 11:14:47AM %2B0100
References:  <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> <19990823172005.C42397@ppp18344.on.bellglobal.com> <19990824172812.L65430@kilt.nothing-going-on.org> <199908250049.JAA00382@rei.snipe.rim.or.jp> <19990825115510.A96398@kilt.nothing-going-on.org> <19990825194348.G18970@ppp18415.on.bellglobal.com> <19990826111447.C66300@kilt.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Aug 26, 1999 at 11:14:47AM +0100, Nik Clayton wrote:
> 
>   2.  It reads oddly.  It might just be my brain, but I can't read the

Yes, although I expect that my brain, at least, will adapt.  My brain
does that, sometimes.  :)


>   3.  I'm not convinced it actually makes things markedly easier for the 
>       translators, when compared to our current scheme of commiting content
>       changes and white space changes in separate commits.

I was updating the badly neglected top half of ports/chapter.sgml when
I realized that I was slowly losing complete track of changes.
Editing 80+ character lines is just too hard.  It's far easier to add
an arbitrary line break, like when editing mdoc files.


> But, these aren't objections, just notes.  I don't see any reason why we
> can't try it out on some of your documentation for a few months, and, if 

Heh.  I don't think I produce enough documentation to qualify as a
"test trial".  :)


> Have I understood your proposal properly?

I may sometimes make more aggressive use of linebreaks than in your
examples, but yes.


-- 
This is my .signature which gets appended to the end of my messages.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990827013021.B47771>