Date: Mon, 23 Aug 1999 17:20:05 -0400 From: Tim Vanderhoek <vanderh@ecf.utoronto.ca> To: Nik Clayton <nik@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990823172005.C42397@ppp18344.on.bellglobal.com> In-Reply-To: <19990823141611.A1770@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 09:16:11AM -0400 References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Aug 23, 1999 at 09:16:11AM -0400, Nik Clayton wrote: > > Can you put this forward to -doc, and see what other English contributors, > and the translation teams, have to say about it. Ok. Hello? Fellow -doc readers? Please read the following quoted paragraph. (Thanks). Comments welcome. >> Would you [encourage|discourage] me from writing new hunks of >> documentation that use DocBook with a formatting style such that each >> new sentence begins on a new line? The idea here is that this would >> make future diffs clearer and easier to read. This would directly >> make synchronization of translations easier. Nik snipped the part where I wrote: >> Of course, I don't plan to gratuitously change any existing docs, and >> I generally wouldn't do this unless the new hunk is of significant >> size (say at least a paragraph). The original context indicating that this is really just something I want to do for my own writing, and not any type of new policy that I'm suggesting, was also lost. I hereby re-establish the context. [As per standard procedure, a dearth of comments will be interpreted as approval... :-] [Nik's comment] > I can see how it makes the translations easier. I can also see how it > makes editing the content after it's been written more complicated (no more > M-q to refill the paragraph -- aargh). Tim doesn't use emacs. Tim tried emacs, simply because Tim felt that if Nik wanted people to use emacs to edit the handbook, Tim should try emacs. Tim gagged and threw-up. Tim doesn't see a problem, here. :) -- 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?19990823172005.C42397>