Date: Mon, 20 May 2002 11:57:26 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Poul-Henning Kamp <phk@critter.freebsd.dk> Cc: reg@FreeBSD.org, grog@FreeBSD.org, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/doc/psd/02.implement Makefile Message-ID: <20020520115726.4ff27260.trhodes@FreeBSD.org> In-Reply-To: <13483.1021886327@critter.freebsd.dk> References: <20020520105506.A74325@shale.csir.co.za> <13483.1021886327@critter.freebsd.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 20 May 2002 11:18:47 +0200
Poul-Henning Kamp <phk@critter.freebsd.dk> wrote:
> In message <20020520105506.A74325@shale.csir.co.za>, Jeremy Lea
> writes:
>
> [re: share/doc]
>
> >Since these documents are (1) mostly out of date, and (2) never
> >change, should we be building them with the world at all. Would it
> >not be better to convert what is still relevant too docbook and add
> >it to the doc tree? Or, if we want to keep them for historical
> >interest, convert them all.
>
> I think share/doc is one of our best kept secrets, few people
> seem to realize the documents are there until you actually point
> it out for them. Now, just because it is a secret doesn't mean
> that the various documents necessarily has high value, they vary
> from hysterically historical to valuable current documentation.
>
> Some years back, I had a vain hope that the BSD tradition of putting
> (Free)BSD in the tree would continue, but as far as I can tell, my
> malloc, bufbio and jail papers are the only ones added since 4.4 was
> checked in.
>
> I think this is a pity, I would love if there were some place were
> we could put up a reference library, but obviously troff isn't the
> language of choice anymore so share/doc disqualifies itself under
> the "make world" doctrine.
>
> So failing the role of project library, I think these documents
> would be better off if we asked the doc project to please adopt
> them and hinted (nudge, nudge, wink, wink!) that they could form
> the start of a collection of project related papers.
hmmmm. If I can find the time, perhaps I will take a review of
this effort. I do agree that is not a bad idea to create a
``collection''
Perhaps this week I'll grab everything out of src/share/doc and
start playing with it ;)
--
Tom (Darklogik) Rhodes
www.FreeBSD.org -The Power To Serve
www.Pittgoth.com -Pittgoth Discussion Portal
trhodes@{Pittgoth.com, FreeBSD.org}
PGP key by www:
http://www.pittgoth.com/~darklogik/darklogik.key
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020520115726.4ff27260.trhodes>