1 |
On 2012.01.03 17:51, Sven Vermeulen wrote: |
2 |
> Hi guys, |
3 |
> |
4 |
> There's a small discussion going on on gentoo-doc [1] about |
5 |
> documenting (or |
6 |
> not documenting) advanced portage features in the Gentoo handbook. |
7 |
> The |
8 |
> suggestion currently is to have it as an added chapter in "Working |
9 |
> with |
10 |
> Portage" of which you can find a preview on [2] (don't mind the |
11 |
> numbering). |
12 |
> |
13 |
> [1] http://archives.gentoo.org/gentoo-doc/ |
14 |
> msg_f3c1439def8cd1df8b0f57fdbb7e6462.xml |
15 |
> [2] http://dev.gentoo.org/~swift/docs/previews/hb-portage- |
16 |
> advanced.xml |
17 |
> |
18 |
> The discussion however is if it is okay to document these things |
19 |
> there |
20 |
> or |
21 |
> not. |
22 |
[snip] |
23 |
> Thoughts? Suggestions? |
24 |
> |
25 |
> Wkr, |
26 |
> Sven Vermeulen |
27 |
> |
28 |
> |
29 |
|
30 |
Team, |
31 |
|
32 |
The Gentoo Handbook is about getting the base system installed. |
33 |
As such features such as per package CFLAGS have no place there. They |
34 |
are not within the scope of installing the base system. |
35 |
|
36 |
We already have separate guides for Xorg, Gnome, KDE, ALSA, binary blob |
37 |
video drivers and so on. |
38 |
|
39 |
I agree these portage features should be documented but probably in a |
40 |
'bleeding edge' guide. |
41 |
|
42 |
Our users will tinker and break things just because they can anyway. At |
43 |
least don't give them the means to make them difficult to help in the |
44 |
introductory Gentoo text. |
45 |
|
46 |
-- |
47 |
Regards, |
48 |
|
49 |
Roy Bamford |
50 |
(Neddyseagoon) a member of |
51 |
elections |
52 |
gentoo-ops |
53 |
forum-mods |
54 |
trustees |