[Sort of RFC] Ports and packages for docs

Marc Fonvieille marc at blackend.org
Mon Dec 1 08:09:24 UTC 2008


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 :)

-- 
Marc



More information about the freebsd-doc mailing list