Re: install.configure is misleading
| From: | Gabor Hojtsy | Date: | Sun, 27 Apr 2003 20:37:16 +0000 |
| Subject: | Re: install.configure is misleading | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969352916@lists.php.net to get a copy of this message | ||
> > > philip Sun Apr 27 15:32:41 2003 EDT
> > >
> > > Modified files:
> > > /phpdoc/en/chapters install.configure.databases.xml
> > > Log:
> > > Adding a mysql entry (not sure why it wasn't here)
> >
> > It should have been moved to mysql doc part isn't it?
>
> This install.configure thing is a little confusing and
> misleading. The title reads:
>
> Complete list of configure options
>
> Yet it certainly isn't complete. There are some options
> listed here that are listed elsewhere, and some that are
> not. Shouldn't this list be autogenerated off the other
> docs?
Yes, the title is completely misleading. For now, I think 'Misc. configure
options' title would be a somewhat working solution. BTW we cannot
autogenerate the configure options in categories, only in alphabetical order
maybe. And then it should be an appending anyway.
> If so I guess we'd have to rewrite every
> configure.xml as to label which <para>'s are actual
> configure options...
Isn't adding id=""s to the paras enough? Then the faq would perfectly find the
right link endpoint.
> This topic is sorta on the TODO but as of right now it
> seems like a #1 phpdoc priority to me. If someone can
> setup how to do it, I can do the dirty work (make
> appropriate changes to all the configure.xml's).
Go on. ;) I think adding id=""s will be enough.
> P.s. The reason I added it is because a faq was referring
> to it. I now see this wasn't a very good solution
> and will revert and modify the faq instead. Was
> just trying to make 'make test' error free! :)
This was generated to missing-ids.xml for a very long time now, I have seen it
before, but have not cared to fix it ;) I am happy you are on this...
Goba