From owner-freebsd-current Wed Apr 25 19:20:51 2001 Delivered-To: freebsd-current@freebsd.org Received: from updraft.jp.freebsd.org (updraft.jp.FreeBSD.ORG [210.157.158.42]) by hub.freebsd.org (Postfix) with ESMTP id 4338A37B422; Wed, 25 Apr 2001 19:20:42 -0700 (PDT) (envelope-from matusita@jp.FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) by updraft.jp.freebsd.org (8.11.3+3.4W/8.11.3) with ESMTP/inet id f3Q2Kc889263; Thu, 26 Apr 2001 11:20:39 +0900 (JST) (envelope-from matusita@jp.FreeBSD.org) Cc: freebsd-current@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG In-Reply-To: <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com> References: <20010425211805N.matusita@jp.FreeBSD.org> <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com> X-Face: '*aj"d@ijeQ:/X}]oM5c5Uz{ZZZk90WPt>a^y4$cGQp8:!H\W=hSM;PuNiidkc]/%,;6VGu e+`&APmz|P;F~OL/QK%;P2vU>\j4X.8@i%j6[%DTs_3J,Fff0)*oHg$A.cDm&jc#pD24WK@{,"Ef!0 P\):.2}8jo-BiZ?X&t$V X-User-Agent: Mew/1.94.2 XEmacs/21.5 (alfalfa) X-FaceAnim: (-O_O-)(O_O- )(_O- )(O- )(- -)( -O)( -O_)( -O_O)(-O_O-) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Dispatcher: imput version 20000228(IM140) Lines: 44 From: Makoto MATSUSHITA To: bmah@FreeBSD.ORG Subject: Re: [RFC] RELNOTESng for 5-CURRENT Date: Thu, 26 Apr 2001 11:20:21 +0900 Message-Id: <20010426112021X.matusita@jp.FreeBSD.org> Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Sorry for late reply. bmah> My first reaction is, "is doing doc.1 *that* much of a problem"? When bmah> I was testing, it didn't seem like building this consumed much time or bmah> disk space compared to the rest of the make release process (i.e. bmah> building world and several kernels). A checked-out doc/ is 37 MB. It takes long to fetch all distfiles for docproj ports. Sometimes they are updated. Sometimes they can't fetch. Sometimes text/docproj can't build (we can't build textproc/jade _now_, since PATCHFILES are already outdated, its path is old, and ftp.freesoftware.com is still offline :-) speaking of textproc/jade, it's easy to fix and I've already have a patch but not yet tested). For ordinally make-build/installworld users, how many people understands that they should install textproc/docproj _only_ for making their plaintext relnotes? Most of them don't need SGML->whatever converter for other situations. If installing textproc/docproj is essential for getting all documents in src/, it should not be a port (src/contrib will be their friends); if it's not essential, a port is ok. And in my opinion, relnotes are tightly associated with src/ components just like src/UPDATING. Hmm... Maybe all of my concerns is that "getting relnotes (formatting is not a problem; plaintext will be easy, but I don't argue that the only version is PDF) without having some processing/compilation (installing some ports, type 'make' command, etc)." If generating relnotes are _optional_ (Makefiles don't _enforce_ us to install textproc/docproj for all machines which run "make buildworld" or "make release"), it's ok if somebody's generated version (format is not the matter; plaintext, HTML, PDF, anything) of relnotes are avaliable via ftp, web, or any protocols of the Internet at any time. -- - Makoto `MAR' MATSUSHITA P.S.: I'm totally agree with RENOTESng system. It'll help to improve the project and the quality of document itself. But please keep some rooms for lazy guys (like me) who refuses to change their style :-) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message