From owner-freebsd-doc Thu Aug 26 18:48: 9 1999 Delivered-To: freebsd-doc@freebsd.org Received: from dfw-ix7.ix.netcom.com (dfw-ix7.ix.netcom.com [206.214.98.7]) by hub.freebsd.org (Postfix) with ESMTP id 75F5F15434; Thu, 26 Aug 1999 18:47:58 -0700 (PDT) (envelope-from asami@stampede.cs.berkeley.edu) Received: (from smap@localhost) by dfw-ix7.ix.netcom.com (8.8.4/8.8.4) id UAA16310; Thu, 26 Aug 1999 20:47:48 -0500 (CDT) Received: from sji-ca5-176.ix.netcom.com(209.109.234.176) by dfw-ix7.ix.netcom.com via smap (V1.3) id rma016293; Thu Aug 26 20:47:22 1999 Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id SAA28006; Thu, 26 Aug 1999 18:46:39 -0700 (PDT) To: "Jordan K. Hubbard" Cc: Nik Clayton , jack , current@freebsd.org, doc@freebsd.org Subject: Re: Docs blows up make release References: <16783.935616425@localhost> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 26 Aug 1999 18:46:38 -0700 In-Reply-To: "Jordan K. Hubbard"'s message of "Wed, 25 Aug 1999 14:27:05 -0700" Message-ID: Lines: 45 X-Mailer: Gnus v5.7/Emacs 20.4 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: "Jordan K. Hubbard" * > This makes the ports tree have a dependency on the doc tree. I don't think * > this dependency should be there. It's bad enough that the src/ tree * > depends on doc/ (and the reason I want the documentation available as * > packages is to remove this dependency), having ports depend on the doc tree * > as well just means that when things go out of sync in doc for a while I get * > both you and Satoshi complaining at me, instead of just you :-) * * Erm, I think the ports tree is pretty darn loose about "dependencies" * since they're easily updated. Consider, for example, the fact that * some ports are dependent on the organization of binary tarballs over * at Netscape, or depend on WordPerfect's linux distribution RPM. Those * are some pretty heavy deps, and depending on something in our own doc * tree is certainly no worse. :) Yes. It shouldn't be hard to keep them synced, just like all the other ports that require the src tree to be around. Another advantage of having them in the ports tree is the build checking done at regular intervals. All the japanese/handbook stuff that's going on right now, these are the problems of the textproc/docbook* ports (missing files from PLIST, missing dependencies). People installing these from packages will see the exact same problem when they try to build the handbook (with or without the japanese/handbook port). * > Putting the package building rules in the doc/ Makefiles also (and this * > is just my personal opinion) makes it easier for people to see how the * > documentation packages are built. The ports Makefile structure is a * > marvel, but it contains a lot of code that's not necessary for building * > documentation packages (the "automagically add man pages to the PLIST * > i" code, for example) that makes it more difficult for the interested * > learner to browse and understand what's going on. * * Now this is a point which is more germin. So, you figure on making a * similar sort of "package" target under doc? I guess it really doesn't * matter where these things live, as long as it's still automated.. The chief concern I have is that this might result in yet another place you (Jordan) have to pick up stuff from before the release. Having these as ports will at least put them on the normal distribution channel along with all the other packages. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message