Date: Thu, 26 Apr 2001 11:20:21 +0900 From: Makoto MATSUSHITA <matusita@jp.FreeBSD.org> To: bmah@FreeBSD.ORG Cc: freebsd-current@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: [RFC] RELNOTESng for 5-CURRENT Message-ID: <20010426112021X.matusita@jp.FreeBSD.org> In-Reply-To: <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com> References: <Pine.BSF.4.21.0104250050530.10183-100000@takhus.dyn.mind.net> <20010425211805N.matusita@jp.FreeBSD.org> <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010426112021X.matusita>