Re: [gentoo-dev] Let portage symlink latest version of installed docs
Simon Stelling wrote: Graham Murray wrote: Fabian Neumann <[EMAIL PROTECTED]> writes: What I'd like portage do to is to create a symlink to the latest version of a package's documentation. Just omitting the version number would of course not work as slotted packages may have multiple versions of docs installed. The first format coming to my mind would be: What would be even nicer would be if it could create and maintain an html index, for example at /usr/share/doc/index.html, to all package html documentation in a similar way to that which gnu info maintains the top level index to all info documentation on the system. This would be a very cool feature. Not for portage though. Portage is a package manager, and a package manager has nothing to do with generating indexes of HTML files. Yes this is why we created phase hooks :) Portage shouldn't symlink docs, but adding scripts to do so should be relatively simple ;) -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Let portage symlink latest version of installed docs
Graham Murray wrote: > What would be even nicer would be if it could create and maintain an > html index, for example at /usr/share/doc/index.html, to all package > html documentation in a similar way to that which gnu info maintains > the top level index to all info documentation on the system. You can always access that directory through a webserver that is capable of index generation. Cheers, -jkt -- cd /local/pub && more beer > /dev/mouth signature.asc Description: OpenPGP digital signature
Re: [gentoo-dev] Let portage symlink latest version of installed docs
Graham Murray wrote: Fabian Neumann <[EMAIL PROTECTED]> writes: What I'd like portage do to is to create a symlink to the latest version of a package's documentation. Just omitting the version number would of course not work as slotted packages may have multiple versions of docs installed. The first format coming to my mind would be: What would be even nicer would be if it could create and maintain an html index, for example at /usr/share/doc/index.html, to all package html documentation in a similar way to that which gnu info maintains the top level index to all info documentation on the system. This would be a very cool feature. Not for portage though. Portage is a package manager, and a package manager has nothing to do with generating indexes of HTML files. -- Kind Regards, Simon Stelling Gentoo/AMD64 Developer -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Let portage symlink latest version of installed docs
I dislike the idea to create lots of symlinks for that reason. But I'm having a bug¹ open at mozilla.org with the goal to create rss feeds from the documentation. Carsten [¹] https://bugzilla.mozilla.org/show_bug.cgi?id=332095 pgpBhuQuKgGb2.pgp Description: PGP signature
Re: [gentoo-dev] Let portage symlink latest version of installed docs
Have you submitted a bugzilla as a request or suggestion - that's the best way to get it acted on . On Saturday April 8 2006 11:48, Fabian Neumann wrote: > Hi Gentoo devs, > > The Problem: I'd like to have bookmarks for my most used documentation > in my browser. E.g., for the Python documentation this would be > file:///usr/share/doc/python-docs-2.4.2/html/index.html. But as the > version number is included in the path, I have to update the bookmark > every time portage installs a new version of Python. > > What I'd like portage do to is to create a symlink to the latest version > of a package's documentation. Just omitting the version number would of > course not work as slotted packages may have multiple versions of docs > installed. The first format coming to my mind would be: > > /usr/share/doc/python-docs-latest -> /usr/share/doc/python-docs-2.4.2 > > If that's impossible because of some Linux standards (I'm really not > familiar with POSIX, LSB, File System Hierarchy or stuff like this) we > could use a special directory for this, maybe /usr/share/doc/.latest or > /usr/share/portage/latest-docs or something similar -- you get the point. > > We could of course make this optional with a USE flag. In face we have > already the symlink flag that does basically the task for the kernel > versions. I don't know if it'd be clever to use it or if we should > consider introducing "symlink-docs" for this. > > I hope this informal proposal initializes a discussion and I would be > very happy to see it in some standardized way in future *-doc-ebuilds. > > Thanks, > Fabian. -- Brett I. Holcomb -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Let portage symlink latest version of installed docs
On Sat, 08 Apr 2006 17:48:12 +0200, Fabian Neumann <[EMAIL PROTECTED]> wrote: > I'd like to have bookmarks for my most used documentation in my > browser. Yup, me too. See bug #67130. The feature is optional (you have to set DOC_SYMLINKS_DIR in make.conf). Symlinks are autocreated when there is an "html" subdir in the package doc dir. If an ebuild wants to force creation of a symlink to another target, it can set the $HTMLDOC_DIR variable. By default, the symlink name is simply the package name. A suffix is added if the package is a non-zero $SLOT. And again, ebuilds can force this name to something else, by setting $DOC_SYMLINK_NAME. -- TGL. -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Let portage symlink latest version of installed docs
Fabian Neumann <[EMAIL PROTECTED]> writes: > What I'd like portage do to is to create a symlink to the latest version > of a package's documentation. Just omitting the version number would of > course not work as slotted packages may have multiple versions of docs > installed. The first format coming to my mind would be: What would be even nicer would be if it could create and maintain an html index, for example at /usr/share/doc/index.html, to all package html documentation in a similar way to that which gnu info maintains the top level index to all info documentation on the system. -- gentoo-dev@gentoo.org mailing list
[gentoo-dev] Let portage symlink latest version of installed docs
Hi Gentoo devs, The Problem: I'd like to have bookmarks for my most used documentation in my browser. E.g., for the Python documentation this would be file:///usr/share/doc/python-docs-2.4.2/html/index.html. But as the version number is included in the path, I have to update the bookmark every time portage installs a new version of Python. What I'd like portage do to is to create a symlink to the latest version of a package's documentation. Just omitting the version number would of course not work as slotted packages may have multiple versions of docs installed. The first format coming to my mind would be: /usr/share/doc/python-docs-latest -> /usr/share/doc/python-docs-2.4.2 If that's impossible because of some Linux standards (I'm really not familiar with POSIX, LSB, File System Hierarchy or stuff like this) we could use a special directory for this, maybe /usr/share/doc/.latest or /usr/share/portage/latest-docs or something similar -- you get the point. We could of course make this optional with a USE flag. In face we have already the symlink flag that does basically the task for the kernel versions. I don't know if it'd be clever to use it or if we should consider introducing "symlink-docs" for this. I hope this informal proposal initializes a discussion and I would be very happy to see it in some standardized way in future *-doc-ebuilds. Thanks, Fabian. -- gentoo-dev@gentoo.org mailing list