From owner-freebsd-doc Fri Nov 19 11:45: 8 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 1BC5B15166; Fri, 19 Nov 1999 11:44:36 -0800 (PST) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA85752; Fri, 19 Nov 1999 19:39:46 GMT (envelope-from nik) Date: Fri, 19 Nov 1999 19:39:46 +0000 From: Nik Clayton To: Jeroen Ruigrok/Asmodai Cc: Nik Clayton , Poul-Henning Kamp , doc@freebsd.org Subject: Re: wishlist item: in schematic form Message-ID: <19991119193946.A85059@catkin.nothing-going-on.org> References: <25692.942762210@critter.freebsd.dk> <19991118081404.C93488@kilt.nothing-going-on.org> <19991118213606.E35248@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19991118213606.E35248@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Thu, Nov 18, 1999 at 09:36:06PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Nov 18, 1999 at 09:36:06PM +0100, Jeroen Ruigrok/Asmodai wrote: > >Also, is the Handbook the best place for this? After reading the comments > >in , I would have thought that queue(3) would be more > >appropriate? > > Nik, > > I am already working on getting this drawn. What would be the best > format to use for it anyways? I myself love to use TGif for schematic > drawings, but I don't know what's the best for the DocBook usage. > > Eivind had the idea that you prefer something like PS for printing and > gif/jp[e]g for webpages. Is this with the 3.1 version of DocBook > doable? AFAIK not. To be honest, I was just thinking we could get away with ASCII art. I definitely think this should be part of queue(3), which rather limits the formatting choices. This is why I thought Poul could send me a GIF, which I can then turn in to an ASCII diagram (it's been ages since I did any, I used to be a dab hand at it in my BBS days). That's not to say that we couldn't have an article about using the queue(3) macros, written in DocBook, with pretty pictures, but I'd like to get the core programmer's documentation sorted first. To answer your question -- I haven't yet tested embedding[1] pictures in our documentation so that it appears in the formatted output. GIF files or similar for the web output will certainly work, and I strongly suspect (but, as I say, haven't tested) that EPS will be the necessary format for PS and PDF. We'll probably need BMP for RTF output too. Testing this is high on my list of priorities. On the 1st of December my current contract ends, at which point I get to do all this 9 to 5, instead of 7.30 to 11, which will make a big difference. N -- If you want to imagine the future, imagine a tennis shoe stamping on a penguin's face forever. --- with apologies to George Orwell To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message