Proposal for an additional (sub)section in the porters handbook

[Pav Lucistnik]

Alexander Leidinger píše v po 05. 12. 2005 v 09:40 +0100:
> Adam Weinberger <adamw at FreeBSD.org> wrote:
> > Alexander Leidinger wrote:

> >> Some maintainers prefer to use install-time plists. While the use of 
> >> them is not forbitten, maintainers have to use commit-time plists 
> >> wherever possible.
> >
> > See, as soon as you use "have to", you've negated any purpose of your 
> > addition past political rhetoric. The entire thing could be shortened
> 
> Ah! Pav, did you referenced to this as being "political" as well? I thought
> you talked about the "benefits"-list. Ok, I will change this.

Possibly.

I have an experience that every extra sentence equals to a percentage of
readers not reading the text at all. Thus, I prefer to keep the texts in
Porter's Handbook down to the minimum, while saying everything
important.

Think law book. You don't justify the rules in the law book. You just
say this will be done, this can be done, this is prohibited.

> > down to, "Please use static plists when possible, as it enables users 
> > to grep(1) through available plists to discover, for example, which 
> > port installs a certain file."

Yes, this would be enough.

I really think you should keep using "static" and "dynamic" in the
"ambiguous" way, and perhaps define them in the text with a sentence or
two each, to clear any confusion.  With your new terms, you're risking a
confusion of all the longtimers.

> I will post a new version later.

Great.

-- 
Pav Lucistnik <pav at oook.cz>
              <pav at FreeBSD.org>

Geography is only physics slowed down, with a few trees stuck on it...
  -- Terry Pratchett
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: Toto je =?iso-8859-2?Q?digit=E1ln=EC?=
	=?ISO-8859-1?Q?_podepsan=E1?= =?iso-8859-2?Q?_=E8=E1st?=
	=?ISO-8859-1?Q?_zpr=E1vy?=
Url : http://lists.freebsd.org/pipermail/freebsd-ports/attachments/20051205/799e76a7/attachment.bin