Date: Wed, 06 Oct 1999 11:55:21 -0400 (EDT) From: John Baldwin <jobaldwi@vt.edu> To: Neil Blakey-Milner <nbm@mithrandr.moria.org> Cc: FreeBSD Documentation Project <doc@FreeBSD.ORG>, Narvi <narvi@haldjas.folklore.ee> Subject: Re: Style Challenge! Message-ID: <199910061555.LAA04865@server.baldwin.cx> In-Reply-To: <19991006164309.A33390@mithrandr.moria.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 06-Oct-99 Neil Blakey-Milner wrote: > On Wed 1999-10-06 (16:39), Narvi wrote: >> > (oh, and does it matter about combining whitespace/markup/content >> > changes in the articles at this point, without any translations?) >> >> The translator will really hate any pure formatting style changes. > > There are no translations, to my knowledge, that correspond to the > English articles, as opposed to the books (handbook, faq, &c.). > > I'm wondering if we're going to be pedantic about it at the moment > (considering the sheer magnitude of the changes), or if I'll get > away with it this time on a warning *grin*. Yes, we are going to be pedantic. :) Habits are formed by repetition, let's Keep It Simple (tm) and always follow the same conventions. Whitespace and content changes should always be in seperate commits (unless Nik declares otherwise). > (Basically, I have all the articles done, and I'd like to know > whether the assumptions I've made above are acceptable, and if they > are, about making them the style for such things in the future. > > I especially want to know if getting the style above to DTRT in > Emacs is possible, since I'd rather use a style that's easy to use > in both vim and Emacs.) Look at the list of things Nik did to convert the handbook from LinuxDoc to DocBook. One of the numbered items contains a elisp function that when run in Emacs completely indents and wraps all the text, which takes care of just about everything except for double spaces in between sentences and extra link breaks between adjacent blocks that are at the same level. > Neil > -- > Neil Blakey-Milner > nbm@rucus.ru.ac.za --- John Baldwin <jobaldwi@vt.edu> -- http://www.cslab.vt.edu/~jobaldwi/ PGP Key: http://www.cslab.vt.edu/~jobaldwi/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ 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?199910061555.LAA04865>