On Thu, Feb 7, 2013 at 6:54 PM, Philip Olson <phi...@roshambo.org> wrote: > > On Feb 7, 2013, at 5:36 PM, Hannes Magnusson wrote: > >> On Mon, Feb 4, 2013 at 12:34 AM, Philip Olson <phi...@roshambo.org> wrote: >> >>> >>> As for what to do, I recommend: >>> >>> a) We add <methodsynopsis> to all SPL aliases >>> b) Be certain that every "Class synopsis" page is accurate >> >> So this came up the other day when someone filed a bug report about >> not finding php.net/_ . >> This fix was to manually hack it into the search iirc. >> >> I'm pretty sure the real fix to all aliases as methodsynopsis. They >> would then be listed automatically correctly, pointing to their >> parents page, and would be indexed by PhD. > > I'm not sure what you mean. Do you mean adding an XML file > for every alias? For all aliases? Like the permanent ones > (_.xml), deprecated ones (mysql-dbname.xml), and those that > have been removed? Or maybe you mean (d) from the previous > email?
gmp_div is an alias for gmp_div_q. gmp_div has it own .xml file. If we remove that file, and simply add the <methodsynopsis> into gmp-div-q.xml so that file now has two. We can mark it as role="alias" or whatever. >> These random inline notes, and dedicated page for aliases listing >> seems like a total wtf to me. > > > I'm not sure what this means. Which inline notes? And I > do not think a page listing aliases is a WTF but maybe > I am missing the meaning. Do you mean WTF because it's so > outdated? > Some pages like php.net/_ have a note in the <refsect role="notes"> that there are aliases to this function. But thats the only way to find that out. Other pages have are almost blank php.net/ftp_quit with just a quick note that this is an alias. So aliases are totally inconsistent right now. But I think we should add the aliased functions <methodsynopsis> into their actual-function-name.xml file. -Hannes
