From owner-freebsd-doc Thu Jan 13 3:15:22 2000 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 235181553C; Thu, 13 Jan 2000 03:15:14 -0800 (PST) (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 BAA60766; Thu, 13 Jan 2000 01:32:52 GMT (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 AAA12482; Thu, 13 Jan 2000 00:39:48 GMT (envelope-from nik@catkin.nothing-going-on.org) Date: Thu, 13 Jan 2000 00:39:48 +0000 From: Nik Clayton To: admin Cc: Nik Clayton , freebsd-doc@freebsd.org Subject: Re: destination html files Message-ID: <20000113003947.D8876@kilt.nothing-going-on.org> References: <20000102194131.B37040@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: ; from admin on Mon, Jan 03, 2000 at 09:53:51AM +0000 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jan 03, 2000 at 09:53:51AM +0000, admin wrote: > > > Now that's not right, is it? The html file is in the book.sgml directory > > > whereas the image is in the chapter directory. > > > ... > > The "all" target would be responsible for symlinking these images in to the > > top level directory. > > Does that mean directly on the top level, or top_level+directory+image? It > would have to be the later, considering the doc-primer documentation > mentioned an advantage of having the images in their respective > directories would allow to use same image names without causing any > conflict. I am also all for it, but I'm not sure if your solution can deal > with that. Excellent point, and one that had completely skipped my mind. This actually makes things easier, as we need to retain the directory structure when things are installed. There are two ways to do this that spring to mind at the moment. The first is to keep all the information in the top level Makefile, as it currently is. Have that Makefile contain an IMAGES variable, and make sure the contents of this variable includes the names of the directories; IMAGES= hw/foo.gif contrib/bar.gif and so on. The .sgml files will reference the images with the paths in them. This is fine, because the HTML files are all put in the top level directory anyway. The install target can use some magic with the dirname command on each entry in the IMAGES variable, to ensure that installation directories exist. Approach number two is to put a Makefile in each of the subdirectories. The top level Makefile can then contain a SUBDIR entry for each of these subdirectories, and we can recurse down in to them calling an 'install' target in each one. I don't like this second approach much, as it smacks of making the problem overcomplicated. Does that make sense? In the next week or so I plan on importing Matt Dillon's recent DaemonNews article in to the articles/ tree (I've already spoken to Matt and the DN people about this). This will involve images, so can act as a test bed for image handling in the doc/ tree. 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