[Sort of RFC] Ports and packages for docs

[Tom Rhodes]

On Mon, 1 Dec 2008 09:09:17 +0100
Marc Fonvieille <marc at blackend.org> wrote:

> Hello,
> 
> Currently, it's difficult for the average user to update his docs.
> Most of time, the docs are installed during OS install time and are
> never updated.
> Another problem is the fact the doc build requires a lot of diskspace
> and a lot of time on slow architectures/CPUs/etc which is a problem
> during release process.
> 
> To sum up, we're lacking of a simple way to install and update docs
> without any compilation operation.
> I'm working since a while on ports for doc, so here are the first
> packages available for test:
> 
> http://people.freebsd.org/~blackend/pkgs/bn-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/da-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/de-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/el-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/en-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/es-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/fr-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/hu-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/it-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/ja-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/mn-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/nl-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/pl-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/pt-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/ru-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/sr-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/tr-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/zh_cn-freebsd-doc-20081130.tbz
> http://people.freebsd.org/~blackend/pkgs/zh_tw-freebsd-doc-20081130.tbz
> 
> These packages provide html-split version (of course other formats are
> possible, I just want to limit the bandwidth) of the 20081130 docset.
> Another thing to note, the packages install docs in
> /usr/local/share/doc/freebsd
> 
> So just:
> 
> pkg_add -r http://people.freebsd.org/~blackend/pkgs/en-freebsd-doc-20081130.tbz
> 
> and tell me if you like it :)

Actually, this seems like a pretty good idea.  As long as
we can keep it updated for people, I'm sure there are
users out there who would love to have updated documentation
as time goes on.  Thanks!

-- 
Tom Rhodes