| 1 |
On Fri, 23 Feb 2007 21:31:51 -0600, Ryan Hill <dirtyepic@g.o> |
| 2 |
wrote: |
| 3 |
|
| 4 |
Some additional infos about this DOC_SYMLINKS_DIR feature, since it |
| 5 |
seems the ebuild(5) doc has not been merged: |
| 6 |
|
| 7 |
- the symlinks are not automatically created to any /usr/share/doc/ |
| 8 |
subdir that the ebuild creates, but only to {$PF,$P}/{html,HTML}. |
| 9 |
So, if a package installs something else (/usr/share/doc/$PF/manual |
| 10 |
for instance), it won't be bookmarked by default. |
| 11 |
|
| 12 |
- an ebuild can force bookmarking of an other directory by setting the |
| 13 |
HTMLDOC_DIR variable. With my previous example, setting it to |
| 14 |
"$PF/manual" (ie. the path without its /usr/share/doc prefix) would be |
| 15 |
fine. And, if a package installs several doc dirs (lets |
| 16 |
say /usr/share/doc/$PF/{manual,apidoc,faq}), the best is probably to |
| 17 |
set HTMLDOC_DIR=$PF (since there is only one symlink that can be created |
| 18 |
per package). |
| 19 |
|
| 20 |
And now the open question for PMS people: is this worth being in |
| 21 |
EAPI-0, or is it just a Portage specific trick? |
| 22 |
|
| 23 |
-- |
| 24 |
TGL. |
| 25 |
-- |
| 26 |
gentoo-dev@g.o mailing list |
Archives