Re: install.configure is misleading

From: Date: Sun, 27 Apr 2003 21:37:40 +0000
Subject: Re: install.configure is misleading
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969352917@lists.php.net to get a copy of this message
> > 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. Okay, sounds good, let's rename it as Miscellaneous and make it clear where configure directives are located (per extension or per section). I'll also remove the few remaining duplicates. Looks like a little leftover from before the big install split. > > 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. Yeah, this should be fine, let's do it this way. Good idea :) > > 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. Will do. > > 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... Regarding those references to &alias;, I guess it was assumed &alias; linked to the alias appendix... But I don't think such a link is needed in these places. Anyway, make test is now error free! ;) Regards, Philip

« previous php.doc (#969352917) next »