Re: Namespace package.xml?

From: Date: Wed, 07 May 2003 18:15:23 +0000
Subject: Re: Namespace package.xml?
References: 1 2 3 4 5  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-16035@lists.php.net to get a copy of this message
Gregs arguments exactly follow my intentions why I added the elements below. In general, all of them are displayed as the package info previous to or after installation in my application. Sandro Greg Beaver wrote:
Alexander Merz wrote:
Sandro Zic wrote:
<!-- URL to Website of package, useful for non-pear packages --> <ext:homepage>http://www.example.com?package=mypackage</ext:homepage>
I use <packageserver></packageserver> for this.
I think Sandro's homepage serves a different purpose. For PEAR packages, the homepage is well-defined based on the package name, this is not the case for most packages.
<license ext:url="http://www.gnu.org/licenses/lgpl.txt" ext:version="2">LGPL</license>
See no sense, if you provide a non standard license, you should include it into the package, so pointing to an URL makes no real sense.
I see sense in this. Not only should the non-standard license be in the package, but it should be possible to specify at least the version of the license, I think the version attribute is necessary, and I see no problem with the url attribute as optional, it could be published at the installation time as in "do you agree to the terms of the license (available at http://blah)"
<ext:copyright>
    <ext:year>2002</ext:year>
    <ext:year>2003</ext:year>
    <ext:holder url="http://www.example.com">Example Company</ext:holder>
</ext:copyright>
I use <vendor>, the year should be visible through the <changelog>-stuff.
Specific copyright notice is useful, and is different from changelog. In some countries copyright is not assumed.
<!-- infos about documentation --> <ext:docs xmlns:dc="http://purl.org/dc/elements/1.1/">
    <ext:doc>
        <!-- information about documentation in DublinCore metadata, http://www.dublincore.org -->
        <dc:title>How To</dc:title>
        <dc:creator>Mr. X</dc:creator>
        <!-- here we provide either an absolut URL or/and one relative to our
        package -->
        <dc:identifier>http://www.example.com/HOWTO</dc:identifier>
        <dc:identifier>HOWTO</dc:identifier>
    </ext:doc>
<ext:doc>
move this to a file and set the file role to 'doc' :-)
This could be useful, again post-install. The packager could say "install successful, documentation <title> is available at <identifier>" and become more user-friendly (this is a good thing) Greg -- phpDocumentor http://www.phpdoc.org


« previous php.pear.dev (#16035) next »