db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andrew McIntyre (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-753) References from table of contents in the HTML book manuals are invalid
Date Wed, 23 Aug 2006 10:28:14 GMT
    [ 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.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message