I'm still not really clear on what you're trying to say with the changes
that you made.
I would start with "This extension requires ____" and fill in the blank
(to maintain consistency with the other elements.) Try to answer the
following questions with your explanation:
-- If I already have PHP installed, will this be automatically
available? (If the answer is "It depends," outline a few specific
scenarios.)
-- Do I need to reinstall PHP with specific options to use this
extension?
If you can do that without being too technical ("external libraries" is
the specific phrase that I am concerned with), then I'll stop pestering
you about this. ;) I agree that the other one was misleading; I agree
that yours is better; now we must focus on how to best state the
requirements from a user's perspective.
Erica
> -----Original Message-----
> From: Hartmut Holzgraefe [mailto:[EMAIL PROTECTED]]
> Sent: Tuesday, September 17, 2002 2:56 AM
> To: Erica Douglass
> Cc: [EMAIL PROTECTED]
> Subject: Re: [PHP-DOC] cvs: phpdoc /en language-snippets.ent
>
> Erica Douglass wrote:
> > So are those functions not always available? If so, we should define
> > when they are and when they aren't.
>
> have a look at http://php.net/overload
>
> the text as it is right now is not only misleading,
> it is totaly wrong, the function is *not* available
> in default builds
>
>
> > My main concern is that your addition may be too technical for
anyone
> > but the most advanced PHP users. I'd appreciate it if you could
define
> > this in a less technical manner.
>
> it *is* technical, no need to hide that IMHO
>
> maybe it could be moved down one place so that it
> is below "installation", but OTOH i'd like to know
> if i can meet the requirements before i even bother
> with the installation details
>
> we could maybe add a "These functions (are|aren't) enabled by default"
> entity for those extensions like e.g. session and ctype, but that
> should be named something like &default.extension; and not
> &no.requirements;
>
>
> --
> Six Offene Systeme GmbH http://www.six.de/
> i.A. Hartmut Holzgraefe
> Email: [EMAIL PROTECTED]
> Tel.: +49-711-99091-77
>
>
> --
> PHP Documentation Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
