Re: Multiple refnames

From: Date: Sun, 28 Dec 2003 14:46:06 +0000
Subject: Re: Multiple refnames
References: 1 2 3  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969357712@lists.php.net to get a copy of this message
Hi Georg!
Since there are not too many strange things I see on the page, what should be fixed exactly?
mysqli-affected-rows.xml: <cut> <refnamediv>
    <refname>mysqli_affected_rows</refname>
    <refname>mysql->affected_rows</refname>
    <refpurpose>Gets the number of affected rows in a previous MySQL operation</refpurpose>
</refnamediv> </cut> a) toc only contains 1st refname b) headline in unction.mysqli-affected-rows.html contains only 1st refname c) 2nd line in mysqli-affected-rows contains both refnames (without blank): mysqli_affected_rows mysqli_affected_rowsmysql->affected_rows -- Gets the number of affected rows in a previous MySQL operation I considered to put both names (procedural and oo) in <refname> but I think web search (http://www.php.net/mysqli_affected_rows) will not work correctly any more.
The web shortcuts are based on filenames and filenames are generated from the refentry id attributes, and not the refnames, so putting both of the usage possibilties into the refname would not affect the websearch. Therefore if you need a quick solution you can put both of the usage possibilties into the refname, and the toc links will include both and the header will be fine. From the XML perspective this is not a good solution though... I would not like to play with the DSSSL / XSLT tools, since Livedocs is up and coming to be useful for the phpdoc work, and I would like to put work into that in the coming months (new years promise :))) Goba

« previous php.doc (#969357712) next »