db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kim Haase <Camilla.Ha...@Sun.COM>
Subject Re: [jira] Commented: (DERBY-753) References from table of contents in the HTML book manuals are invalid
Date Wed, 23 Aug 2006 18:41:59 GMT
I know a number of people, including me, who'll be very happy that you
fixed this, and also DERBY-935 (adding the logo). Thank you for your
wizardry!

Kim

Andrew McIntyre (JIRA) wrote On 08/23/06 06:28,:
>     [ http://issues.apache.org/jira/browse/DERBY-753?page=comments#action_12429956 ]

>             
> Andrew McIntyre commented on DERBY-753:
> ---------------------------------------
> 
> Committed a fix to the trunk with revision 434003. Beware all ye who venture here: the
sea of XSLT is deep and wide and unforgiving.
> 
> The story goes something like this: the generated id's for topic references were not
being retained, and new unrelated generated ids were being created for the same topics as
they were inserted into the final document at a later stage of processing. So, instead of
being identified by their originally generated correct ids, the new incorrect generated id
for the topic was being inserted into the final generated HTML Book. In addition, the internal
page reference was being used instead of the XSLT engine generated id.
> 
> This was too late to make tonight's doc build, but I hope to verify the fix in the next
doc build and close this issue. Any and all review/comments appreciated.
> 
> 
>>References from table of contents in the HTML book manuals are invalid
>>----------------------------------------------------------------------
>>
>>                Key: DERBY-753
>>                URL: http://issues.apache.org/jira/browse/DERBY-753
>>            Project: Derby
>>         Issue Type: Bug
>>         Components: Documentation
>>   Affects Versions: 10.1.1.2, 10.1.2.1
>>        Environment: Tested in several different browsers and on different computers.
>>           Reporter: Kristian Waagan
>>
>>The references from the table of contents are invalid. They do not work because the
wrong anchor/name is used, or that the tags defining the anchors are not included. 
>>Is something going wrong in the documentation build process?
>>To illustrate the point, try this:
>>
>>>http://db.apache.org/derby/docs/dev/ref/ref-single.html#crefsqlj95081
>>
>>The manual is shown, but you are not directed to the 'CREATE statements' chapter.
>>Then try this:
>>
>>>http://db.apache.org/derby/docs/dev/ref/ref-single.html#N1223F
>>
>>This works and direct you to the 'CREATE statements' chapter.
> 
> 


Mime
View raw message