[28760] trunk/dports/devel/libtool/Portfile

[Ryan Schmidt]

On Sep 8, 2007, at 23:39, N_Ox wrote:

> Le 8 sept. 07 à 22:04, Ryan Schmidt a écrit :
>
>> On Sep 8, 2007, at 08:58, source_changes at macosforge.org wrote:
>>
>>> Revision: 28760
>>>           http://trac.macosforge.org/projects/macports/changeset/ 
>>> 28760
>>> Author:   nox at macports.org
>>> Date:     2007-09-08 06:58:45 -0700 (Sat, 08 Sep 2007)
>>>
>>> Log Message:
>>> -----------
>>> libtool:
>>>  * Added standard doc install.
>>
>> Please don't forget to increment the port revision when you make a  
>> change that causes the port to install different files. I've been  
>> fixing this on the ones you've just committed.
>
> From what I've understood until now, documentation files is not  
> relevant enough to increase revision number.
> Nevertheless, it would not hurt that much to increase it and i have  
> never done it because i thought that was the current policy, thanks  
> again for noticing me it's not.

I feel that if the complement of files that gets installed by port is  
different, the revision number needs to be increased (unless the  
version increases, and then the revision needs to be deleted or  
dropped to 0). I think that's pretty simple and easy to remember, so  
that's what I recommend. We should document this in the guide. If  
anybody objects to this policy, let's please discuss it now.

The goal is for everybody who installs a port to get the same  
software. It's confusing if some people who install libtool-1.5.24_0  
get one thing and other people who install libtool-1.5.24_0 get  
something different.

Perhaps documentation files are minor. Perhaps not. Either way, I  
think we want people who are submitting bugs, for example, to be able  
to do so unambiguously against a particular port version and  
revision. What if the bug is about the documentation? What if someone  
has libtool-1.5.24_0 installed and notices that there is no  
documentation, and submits a bug "libtool-1.5.24_0 should install  
documentation"? It seems natural to respond "I updated the port to  
install the documentation, and 'port outdated' will soon show it, and  
you can then update to it." It seems weird to say "I updated the port  
to install the documentation, but I'm not incrementing the revision,  
so the only way to obtain the documentation is to either know that I  
did this and force an upgrade, or hope that libtool will be updated  
to a new version soon so that you get the documentation then."

It also simplifies answering questions. "Do I have the libtool  
documentation?" It's nice to be able to answer "Do you have 1.5.24_1  
or later? Then yes. Otherwise no." It's not so nice to have to answer  
"Do you have 1.5.24_1 or later? Then yes. Do you have 1.5.22_0 or  
earlier? Then no. Do you have 1.5.24_0? Ok, when did you install it?  
If before September 8, then no. If after, then yes."