Re: [PHP-DOC] Configure options in the docs... From: Lars Torben Wilson (torben <email protected>)
Date: 09/11/00

Ron Chmara writes:
> >--for instance, to keep people
> > from freaking out when they see that --with-ftp doesn't work in PHP 4
> > (it's become --enable-ftp, btw).
>
> There's more than one or two of these. :-(

Oohhh yeah...;)

> > Another thing I found was that including this list in the installation
> > page itself makes the page ridiculously long, so I split it out into a
> > different sect1.
>
> We should consider moving the specific text/options already listed
> listed *off* of the orginal page, and instead give pertinant examples
> of usual syntax. Right now that page tends to indicate that "here's the
> options available", rather than "here's some examples of the syntax,
> go this other page for a full listing of the options available".

I moved off all of the non-database related ones--I think the database
ones should be removed too. Pointers to the appropriate options should
be given instead--as it is, that page is something of a readability
mess.
 
> > Since putting these changes together involves some largish changes to
> Another suggestion: Put this after the Unix page, not after the Windows
> page.(?!?)

Yeah...:)
 
> Suggestion you'll probably *hate*, because it would involve undoing some
> of your work (I'd be willing to do it, if you'd rather not):

Oh, I don't mind. I should have said that this is pretty preliminary
(otherwise I would've probably committed it anyway). It's this kind of
comment I'm looking for:

> Group this first by PHP version (maybe one page per set), then by the kind
> of function. If I wanted to get the Graphics stuff, Postgres, and Oracle
> (but no mysql), adding ftp, PDF, mail stuff, and LDAP, I'd be scrolling all over
> this page trying to find stuff in "with" and "without" and guessing at
> the keywords I'd have to use: tiff, ttf, t1lib, png, jpeg,
> freetype-4bit-antialias-hack, zlib (all this for graphics).

This makes perfect sense. And is another reason I think we need to
just take the generated list now, and take care of it by hand from now
on. This isn't something a little script would be capable of doing,
without adding tags of some kind to the configure option help texts
(hmm...say...)

But yeah, at the moment I've just got them alphabetically. Not the
best setup at all.
 
> And, on a completely outlandish "woudn't it be nice if" note, a form
> based page where people could checkmark boxes to _build_ their configuration
> strings would be, well, wonderful. :-) On Another Day.
>
> -Bop

Actually, that should be pretty easy. Probably could have a link to it
from the manual, or something.

I'll make some changes and commit either later tonight or tomorrow. 

-- 
+----------------------------------------------------------------+
|Torben Wilson <torben <email protected>>                     Netmill iTech|
|http://www.coastnet.com/~torben            http://www.netmill.fi|
|Ph: 1 250 383-9735                             torben <email protected>|
+----------------------------------------------------------------+