From owner-freebsd-doc Sat Jul 31 14: 9:38 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id A42B214C23 for ; Sat, 31 Jul 1999 14:08:58 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id VAA70488; Sat, 31 Jul 1999 21:59:45 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id SAA02727; Sat, 31 Jul 1999 18:40:32 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Sat, 31 Jul 1999 18:40:32 +0100 From: Nik Clayton To: John Baldwin Cc: Nik Clayton , freebsd-doc@FreeBSD.ORG, Ken Marx Subject: Re: groff & truetype fonts Message-ID: <19990731184032.B1713@kilt.nothing-going-on.org> References: <19990730105933.C46018@kilt.nothing-going-on.org> <199907302017.QAA08679@smtp4.erols.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199907302017.QAA08679@smtp4.erols.com>; from John Baldwin on Fri, Jul 30, 1999 at 04:17:39PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Jul 30, 1999 at 04:17:39PM -0400, John Baldwin wrote: > On 30-Jul-99 Nik Clayton wrote: > > On Tue, Jul 06, 1999 at 01:27:31PM -0700, Ken Marx wrote: > >> I recently had to convert truetype fonts for use with groff. > >> I thought this might be a useful addition to Dave Bodenstab's > >> *excellent* primer (http://www.pt.freebsd.org/tutorials/fonts/fonts.html). > > > > > > > > Just so you know -- this is still in my list of things to deal with. I > > haven't ignored it. > > > > In the mean time, if anyone else feels up to the challenge of doing the > > SGML conversion, please step forward. > > > > Cheers, > > Just point at me the stuff to convert. The tutorials are in DocBook, correct? Rather than re-post Ken's documentation, if you search the -doc mailing list for a message from kmarx@bigshed.com with the subject groff & truetype fonts you'll find his original, 280+ line message which included the new text. Yes, the existing fonts tutorial is in doc/en/tutorials/fonts/fonts.docb, marked up in DocBook. This is a pain, because there are a number of things which need to happen to that file to bring it in line with the evolving standards for the FDP. For example, it should really be an
rather than a , the indentation is wrong, it doesn't use the &man.foo.n; entities, and so on. However, trying to fix all these in one commit makes things difficult for the translators. The best bet is probably to merge in Ken's text without making any formatting changes to the file, or introducing new entity references and so on. This at least gets the text in to the tree. We can then sort out the stylistic and structure issues later. Thanks for volunteering to do this -- as ever, if you've got questions about markup choices as you're doing the conversion, don't hesitate to get in touch. Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message