Re: install.configure is misleading

From: 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

« previous php.doc (#969352916) next »