ID: 41427 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Assigned +Status: Feedback Bug Type: Documentation problem Operating System: irrelevant PHP Version: Irrelevant Assigned To: bjori New Comment:
This is how the chunking rules are. It was originally a bug in Docbook-DSSSL that got fixed when we switched to Docbook-XSL. The first <sect1>/<section> is a "section information" element which is not supposed to be added to the TOC, just like index.php doesn't create a link to itself in the TOC. Furthermore, its totally inconsistent with the rest of the TOCs. When you are browsing php.net/in_array, do you expect the "Array introduction" to be the top most link in the TOC? Wrapping that first <simpara /> inside a <sect1/> will create a new chunk, control-structures.if.php, out of the "if" page and therefore add it to the TOC. With that said. Shouldn't we fix our sources rather than adding crazy workarounds to otherwise clean and relatively-dirty-workaround-free PhD? -Hannes Previous Comments: ------------------------------------------------------------------------ [2007-08-24 05:10:28] [EMAIL PROTECTED] I nominate the new build system (PhD) to perform this task so... assigning to bjori :) This bug tackles two issues: 1) Generate the separate page, for example create: http://php.net/manual/en/control-structures.if.php 2) Link to it within the navigation pane, as explained here by others. We could instead simply link to the root page but I (like tularis) prefer having the separate page created so that it'll be a permanent link whereas the root page content may change. So yes, we'll have duplicate information in these cases but that's fine. ------------------------------------------------------------------------ [2007-05-18 11:27:21] [EMAIL PROTECTED] Yes. The use different XSL files. Just mentioning that the there is at least one of them that is correct. ------------------------------------------------------------------------ [2007-05-18 11:09:24] [EMAIL PROTECTED] Hm, to be clear: I am talking about the online manual ;-) ------------------------------------------------------------------------ [2007-05-18 10:32:12] [EMAIL PROTECTED] The "if" page IS in the index in the Extended CHM manual. ------------------------------------------------------------------------ [2007-05-18 09:16:32] [EMAIL PROTECTED] It's all gotten from splitting the same file on <sect1>'s. It seems like the first (if in this case) is appended to the original TOC-page while only the remainders are split off. IMO it should be split off too. Unfortunately, I don't know enough of the phpdoc internal build process to know how to do this... I'll have a look at it later, but maybe one of the build-masters have any ideas on this? ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/41427 -- Edit this bug report at http://bugs.php.net/?id=41427&edit=1
