Description: ------------ If I want to use 'MY' license, perhaps I must not use '--license' option and write that licese per script file. So I made a patch against License.php: http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php.patch?rev=14166&format=raw and modified License.php is: http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php?rev=14166 The license files will be located in PEAR_INSTALL_DIR/data/PHP_DocBlockGenerator/: http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/data/PHP_DocBlockGenerator?rev=14166 In a license file, the 1st line is 'full_name', the 2nd is 'url' and 'text' is follwing.

I understand why you have done this as it does not really make sense to have such information hard coded, but at present I'm not convinced it's exactly the best way of doing this. Thanks for your input, I will have a think.

Since "XML" is a recognised standard with pear (ie: package2.xml), it may be better to use XML files instead of text files. The benefit of XML over text is that it's a recognised standard, rather than adhoc. I'm now considering how they should be formatted and whether they should be all in one file or separate files...

The issue at the moment is discovering a suitable XML format. I've been doing some searching to see if I can find any examples of existing formats, eg: "Licensed under the Apache License, Version 2.0" filetype:xml inurl:apache or "Redistributions in binary form must reproduce the above copyright notice" filetype:xml inurl:bsd But nothing conclusive showed up there. I went on to search for: inurl:license filetype:xml This was a bit more interesting... http://repository.jboss.org/licenses/license-info.xml http://repository.jboss.org/licenses/ I concluded that the best solution appears to be a combination of plain text files for the actual licenses, then an xml file to index them. I also came across this: http://licenses.opendefinition.org/ Which could provide the url and title details, meaning there is no need for an XML index file.

Interestingly PHP_Beautifier has a licenses directory: https://github.com/clbustos/PHP_Beautifier/tree/master/licenses They are included in the packages2.xml: https://github.com/clbustos/PHP_Beautifier/blob/master/package2.xml And appears to be used as follows: Beautifier\Filter\Pear.filter.php: $sDataPath = PHP_Beautifier_Common::normalizeDir($oConfig->get('data_dir')) . 'PHP_Beautifier/licenses/' . $sLicense . '.txt'; However, PHP_Beautifier does not include a URL or full name, so that will still need to be handled in some kind of simple index file (xml, json, txt or ini). For now, I may keep the index php based and get the license files right first.

This bug has been fixed in SVN. If this was a documentation problem, the fix will appear on pear.php.net by the end of next Sunday (CET). If this was a problem with the pear.php.net website, the change should be live shortly. Otherwise, the fix will appear in the package's next release. Thank you for the report and for helping us make PEAR better.