Doc directory (was: [28480] trunk/dports/archivers/p7zip)
On 2007-09-01 07:28:25 -0700, source_changes@macosforge.org wrote:
* Changed doc directory to ${name}-${version}.
I don't know if there has been a discussion about this, but is there any reason to include the version, given the fact that two different versions cannot be activated at the same time? I find this a bit annoying as including the version makes the pathnames change after an upgrade, so that one can no longer say: "see /opt/local/share/doc/p7zip/README" or make a symlink to it. -- Vincent Lefèvre <vincent@vinc17.org> - Web: <http://www.vinc17.org/> 100% accessible validated (X)HTML - Blog: <http://www.vinc17.org/blog/> Work: CR INRIA - computer arithmetic / Arenaire project (LIP, ENS-Lyon)
Le 3 sept. 07 à 15:25, Vincent Lefevre a écrit :
On 2007-09-01 07:28:25 -0700, source_changes@macosforge.org wrote:
* Changed doc directory to ${name}-${version}.
I don't know if there has been a discussion about this, but is there any reason to include the version, given the fact that two different versions cannot be activated at the same time?
I find this a bit annoying as including the version makes the pathnames change after an upgrade, so that one can no longer say: "see /opt/local/share/doc/p7zip/README" or make a symlink to it.
-- Vincent Lefèvre <vincent@vinc17.org> - Web: <http://www.vinc17.org/> 100% accessible validated (X)HTML - Blog: <http://www.vinc17.org/ blog/> Work: CR INRIA - computer arithmetic / Arenaire project (LIP, ENS- Lyon)
Recent autotools-based package doc directories default to ${name}-$ {version} (see libogg and libvorbis). Also, I love to have maximum informations about my installed packages in the documentation directory and version _is_ an important information. Last, you do can have multiple versions of the same package, see automake and all, including version in docdir for only a few packages seems quite awkward and inconsistent to me. You cannot do a symlink, but you can always do `see /opt/local/share/ doc/p7zip*/README`. -- Anthony Ramine, the infamous MacPorts Trac slave. nox@macports.org
On 2007-09-03 15:57:47 +0200, N_Ox wrote:
Recent autotools-based package doc directories default to ${name}-${version} (see libogg and libvorbis).
But why did they do such a change? Note that this is a setting that comes from these particular packages, not from the autotools: libogg-1.1.3/doc/Makefile.am contains: docdir = $(datadir)/doc/$(PACKAGE)-$(VERSION) AFAIK, this is not standard, as the default autoconf sets the default to DATAROOTDIR/doc/$(PACKAGE). Unless this has changed recently...
Also, I love to have maximum informations about my installed packages in the documentation directory and version _is_ an important information.
This can be done in some other way, though (e.g. a VERSION file in the doc directory, or the NEWS file...).
Last, you do can have multiple versions of the same package, see automake
OK, but packages like automake are different: version information is included everywhere, including in the binary, and only the major version (e.g. 1.10, not 1.10.x).
and all, including version in docdir for only a few packages seems quite awkward and inconsistent to me.
Because for automake, there is a reason, and this is not even the version, but the package name. For instance, concerning automake17, you have ${prefix}/share/doc/automake17, not ${prefix}/share/doc/automake17-1.7.9. Ditto for DocBook: you have different incompatible versions, but it makes sense to have them installed at the same time. For consistency, it would be better to stick with the autotools standard. -- Vincent Lefèvre <vincent@vinc17.org> - Web: <http://www.vinc17.org/> 100% accessible validated (X)HTML - Blog: <http://www.vinc17.org/blog/> Work: CR INRIA - computer arithmetic / Arenaire project (LIP, ENS-Lyon)
participants (2)
-
N_Ox
-
Vincent Lefevre