I've seen almost everywhere that layman's directory is /usr/portage/local/layman Actually it's /usr/local/portage/layman (which makes more sense), as we can see in the conf file /etc/layman/layman.cfg Documentation quote : --------------------- Code Listing 2.1: Installing layman emerge layman echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf Note: Layman will create "/usr/portage/local/layman/make.conf" once you add your first overlay. But if you do not plan to install an overlay immediately you should ensure that this file actually exists and contains the empty variable "PORTDIR_OVERLAY". Otherwise portage will complain. You can run "echo PORTDIR_OVERLAY=\"\" > /usr/portage/local/layman/make.conf" in order to have the file created correctly. ---------- layman.cfg part : #----------------------------------------------------------- # Defines the directory where overlays should be installed storage : /usr/local/portage/layman Reproducible: Always Steps to Reproduce: Irrelevant Actual Results: See description Expected Results: Documentation updated
Not our problem; reassigning to the overlays project.
stable version of layman still uses /usr/portage/local and our documentation is about stable tree. But it's better to keep this bug open not to forgive to update documentation. CC'ing layman maintainer. Gunnar please touch (or better fix :)) this bug as layman with this change goes to stable.
Will only change once >=layman-1.2.0 becomes stable. See #246775.
I've just been fighting with this one. The current document at http://www.gentoo.org/proj/en/overlays/userguide.xml refers to both paths, in different places. I'm using keyword "x86", but I only saw the reference to the new path so I was adding new style "source /usr/local/portage/layman/make.conf". Finally, I found a clue in /etc/layman/layman.cfg... Stabilisation of 1.2 will help, but the docs will need checking for old style paths!
well, doc says --- (for layman 1.1) # echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf (for layman 1.2 and up) # echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf --- so it is clear which to use, isn't it?
I think you mean FIXED. Looks like you made the change to userguide.xml yourself, on 2009-02-01... maybe as a result of this bug?. Credit where it's due, and thanks for sorting out the userguide.
Can we please re-open this bug? The issue is up again! Today I emerged the now-stabilized =app-portage/layman-1.2.3 on amd64, and while all the defaults have changed to /usr/local/portage/layman, the documentation still refers to /usr/portage/local/layman. In order to show this, just run the following command: $ grep /usr/portage/local `equery files layman | grep html | tail -n1` which outputs on my box: <code class="filename">/usr/portage/local/layman</code>. layman <code class="filename">/usr/portage/local/layman/make.conf</code>" >> <code class="filename">/usr/portage/local/layman/cache.xml</code> </p><p>source /usr/portage/local/layman/make.conf</p><p><code class="filename"> But that's not all - the man page also refers to /usr/portage/local/layman.
BTW, was there a special reason why the path default has been changed at all? As I understand it, it has been argumented in the past that /usr/portage/local/portage was a better place than /usr/local/portage/layman, because when /usr/portage was shared on the network, the layman overlays would be shared with it automatically. /usr/local on the other hand typically contains data only local to the current machine, and is not intended to be shared between different machines (according to the FHS). I was happy with /usr/portage/local and would really like to know why that default has been changed.
Guenther, as I see now documentation states: ===================================================================== Code Listing 2.2: Telling Portage about layman-fetched repositories (for layman 1.1) # echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf (for layman 1.2 and up) # echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf ===================================================================== So it looks like the documentation is correct. And I don't know why this path was changed.
Hi Peter, (In reply to comment #9) > Guenther, as I see now documentation states: > [...] > (for layman 1.2 and up) > # echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf > [...] > So it looks like the documentation is correct. And I don't know why this path > was changed. Well it *would* seem... but it seems I have different documentation installed than you do! (Which is strange, unless we have different versions installed. I am referring to layman-1.2.3) The documentation file where *only* /usr/portage/local/layman is mentioned is installed as 88233ce677589313a304268189581b56 */usr/share/doc/layman-1.2.3/html/layman.8.html on my box.
Created attachment 192625 [details] My copy of /usr/share/doc/layman-1.2.3/html/layman.8.html This is the documentation file I got installed by emerging the currently stable layman-1.2.3. Its MD5SUM is 88233ce677589313a304268189581b56 (binary mode). The path /usr/local/portage/layman is mentioned nowhere in this document.
And just for the sake of completeness: $ equery belongs /usr/share/doc/layman-1.2.3/html/layman.8.html [ Searching for file(s) /usr/share/doc/layman-1.2.3/html/layman.8.html in *... ] app-portage/layman-1.2.3 (/usr/share/doc/layman-1.2.3/html/layman.8.html)
Guenther, ah I see now. This bug is about http://www.gentoo.org/proj/en/overlays/userguide.xml#doc_chap2 (take a look on URL field) while you talk about documentation bundled with layman. Could you open new bug for this new issue please? Thank you.
Hi Peter, (In reply to comment #13) > Could you open new bug for this new issue please? Thank you. Sure! Done. Created bug 271457.