Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 27 Aug 1999 15:22:44 +0200
From:      Neil Blakey-Milner <nbm@mithrandr.moria.org>
To:        hoek@FreeBSD.ORG
Cc:        Nik Clayton <nik@FreeBSD.ORG>, Motoyuki Konno <motoyuki@snipe.rim.or.jp>, freebsd-doc@FreeBSD.ORG
Subject:   Re: DocBook formatting style?
Message-ID:  <19990827152244.A7271@mithrandr.moria.org>
In-Reply-To: <19990827013021.B47771@ppp18415.on.bellglobal.com>; from Tim Vanderhoek on Fri, Aug 27, 1999 at 01:30:21AM -0400
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> <19990827013021.B47771@ppp18415.on.bellglobal.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Fri 1999-08-27 (01:30), Tim Vanderhoek wrote:
> 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.

I imagine adding a line break won't hinder translations (at least in my
tiny experience in translation), but just don't go about using par or
your favourite five-finger-emacs-function that re-paragraphs the whole
thing.

Let me qualify this, since it doesn't quite sound like I want it to.

If you're editing a line, and you're typing at or approaching 80
characters, adding a line break in your own change shouldn't be a
problem.

Introducing a line break because changes you've instituted earlier in
the line cause original text to move forward over 80 characters should
be avoided, as this gives the impression some work was done on that
text.  

In no case should you then merge the new line you've created with the
line after it.

Your next commit is to do whatever whitespace changes you need to.

At least that's my take at it.

Neil
-- 
Neil Blakey-Milner
nbm@rucus.ru.ac.za


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?19990827152244.A7271>