Date: Fri, 19 Nov 1999 19:39:46 +0000 From: Nik Clayton <nik@freebsd.org> To: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> Cc: Nik Clayton <nik@freebsd.org>, Poul-Henning Kamp <phk@freebsd.org>, doc@freebsd.org Subject: Re: wishlist item: <sys/queue.h> in schematic form Message-ID: <19991119193946.A85059@catkin.nothing-going-on.org> In-Reply-To: <19991118213606.E35248@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Thu, Nov 18, 1999 at 09:36:06PM %2B0100 References: <25692.942762210@critter.freebsd.dk> <19991118081404.C93488@kilt.nothing-going-on.org> <19991118213606.E35248@daemon.ninth-circle.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <sys/queue.h>, 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19991119193946.A85059>