From owner-freebsd-doc Mon Aug 23 14:18: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp11.bellglobal.com (smtp11.bellglobal.com [204.101.251.53]) by hub.freebsd.org (Postfix) with ESMTP id 758CB14D6B; Mon, 23 Aug 1999 14:17:58 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from ppp18344.on.bellglobal.com (ppp18416.on.bellglobal.com [206.172.130.96]) by smtp11.bellglobal.com (8.8.5/8.8.5) with ESMTP id RAA28805; Mon, 23 Aug 1999 17:21:19 -0400 (EDT) Received: (from tim@localhost) by ppp18344.on.bellglobal.com (8.9.3/8.9.1) id RAA42498; Mon, 23 Aug 1999 17:20:06 -0400 (EDT) (envelope-from tim) Date: Mon, 23 Aug 1999 17:20:05 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: freebsd-doc@freebsd.org Subject: Re: DocBook formatting style? Message-ID: <19990823172005.C42397@ppp18344.on.bellglobal.com> References: <19990822200737.A65807@ppp18344.on.bellglobal.com> <19990823141611.A1770@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990823141611.A1770@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 23, 1999 at 09:16:11AM -0400 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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