There appears to be virtually no documentation on the sandbox. Now there seems to be not only sandbox feature, but also a usersandbox, too. And there is an entire ebuild for the sandbox, but no man page! There should be a section added to the portage documentation to explain how all these things work and it should also explain why infamous ACCESS VIOLATIONS occurs and why it can't seem to be fixed. (Poor documentation makes Gentoo look bad.) Reproducible: Always Steps to Reproduce: 1. 2. 3.
i dont really the point other than a short description in make.conf in the FEATURES section about sandbox and usersandbox
(In reply to comment #0) > There appears to be virtually no documentation on the sandbox. Now there seems to be not only sandbox feature, but also a usersandbox, too. And there is an entire ebuild for the sandbox, but no man page! The make.conf manpage and make.conf.example have brief explanations. The sandbox package has a sandboxshell manpage. > There should be a section added to the portage documentation to explain how all these things work and it should also explain why infamous ACCESS VIOLATIONS occurs and why it can't seem to be fixed. IMO there's no point in explaining such things to users. They should simply file a bug and leave it to the ebuild devs. > (Poor documentation makes Gentoo look bad.) Please feel free to create documentation patches and attach them to this bug. :)
I have said it in the past, and will say it again - I suck at docs. Anyhow, I think a manpage will be nifty, so if anybody will be willing to do that, ping me.
Addin docs-team to CC in case they are interested in this or have anything to add. Feel free to unCC yourself if that's not the case.
*** This bug has been marked as a duplicate of bug 137610 ***
oops, wrong bug
(In reply to comment #4) > Addin docs-team to CC in case they are interested in this or have anything to > add. Feel free to unCC yourself if that's not the case. > Interesting, could be very interesting. However, that's more the sort of "interesting" that would need to be placed in 1) the developer handbook maintained by devrel and 2) the devmanual maintained by QA. Working with the sandbox is clearly a development feature, not an end-user feature. I don't feel that we should throw it in with the existing user-oriented Portage Handbook for the same reason why I was discouraged by various Portage folks from mentioning things like AUTOCLEAN -- best not to mention it (in that handbook) so that users don't mess up their systems. That being said, I, personally, am interested in helping out (gotta do something to occupy myself ;) ). I can edit and guideXMLify the online documentation for you if needed; just get in touch with me. :) Un-CCing the GDP for now.
No activity whatsoever, so unCCing myself.
We already have some stuff on here: http://devmanual.gentoo.org/general-concepts/sandbox/ And links from there on how to deal with some sandbox issues. Is there anything specific we are looking for that would help people? I'm willing to write it, but I just don't know what people want :) Patches make the process go much faster btw.
We already have some documentation in devmanual about sandbox. I don't know what people want added, so I'm considering this fixed.