[27201] trunk/base/doc/portfile.7

[Weissmann Markus]

On 24 Jul 2007, at 11:35, Ryan Schmidt wrote:

> On Jul 24, 2007, at 04:26, source_changes at macosforge.org wrote:
>
>> Revision: 27201
>>           http://trac.macosforge.org/projects/macports/changeset/ 
>> 27201
>> Author:   mww at macports.org
>> Date:     2007-07-24 02:26:13 -0700 (Tue, 24 Jul 2007)
>>
>> Log Message:
>> -----------
>> add destroot.violate_mtree documentation
>>
>> Modified Paths:
>> --------------
>>     trunk/base/doc/portfile.7
>>
>> Modified: trunk/base/doc/portfile.7
>> ===================================================================
>> --- trunk/base/doc/portfile.7	2007-07-24 09:17:40 UTC (rev 27200)
>> +++ trunk/base/doc/portfile.7	2007-07-24 09:26:13 UTC (rev 27201)
>> @@ -1031,6 +1031,17 @@
>>  .br
>>  .Sy Example:
>>  .Dl destroot.keepdirs ${destroot}${prefix}/var/log/mysql
>> +.It Ic destroot.violate_mtree
>> +Indicates if a port will violate the common directory structure.  
>> Enables or disables tests for violations of mtree (e. g. non- 
>> standard directories in ${prefix})
>
> [snip]
>
> What is an "mtree"? What is "the common directory structure"?
>

This refers to "prefix.mtree" *) from which the common directory  
structure is created by port; perhaps the name was not a good choice,  
so if someone has a better one you're welcome to change it.

The main idea is to immediately detect ports that still (*sigh*) put  
their 'man' and 'info' directories straight into ${prefix}; (though  
there are probably other misbehaviors like this)
Ports that willing want to violate this structure (e. g. apache2) can  
disable the (fatal) tests by adding "destroot.violate_mtree yes" to  
the portfile.


-Markus


*) port 1.5 keeps it here: ${prefix}/etc/macports/prefix.mtree

---
Markus W. Weissmann
http://www.mweissmann.de/