Documentation terminology change

[Randall Wood]

On 7 Aug 2007, at 10:45, markd at macports.org wrote:

> I'm trying to clarify conceptually what MacPorts is and how it  
> works in
> the new guide.  In the old guide the term "initialization phase" is  
> used
> for what I think we may commonly refer to this as the "global  
> section" of
> a portfile.
>
> http://geeklair.net/macports_guide/ch04.html#id927488
>
> I don't like the term "initialization phase" because it seems
> counterintuitive for many keywords such as "maintainer",  
> "description",
> etc.  I prefer to call those "global" keywords, thereby disguishing
> between the global port/Portfile stuff and port/Portfile installation
> phases.  Seen that way the global part is not termed an  
> installation phase
> at all and I like the separation conceptually.  I think this is  
> more clear
> and more or less clearly explains the murky relationship between a  
> port
> and a Portfile.  To see how I have explained it, see the brief  
> intro in
> section "Portfile Introduction" in 4.1 of the new guide.
> http://geeklair.net/macports_guide/
>
> Does anyone see any problem with this characterization?

Seems good to me.

Randall Wood
rhwood at mac.com
http://shyramblings.blogspot.com

"The rules are simple: The ball is round. The game lasts 90 minutes.  
All the
rest is just philosophy."