db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Rick Hillegas (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-6050) Make all topics visible in ToCs
Date Mon, 28 Jan 2013 16:05:15 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13564365#comment-13564365
] 

Rick Hillegas commented on DERBY-6050:
--------------------------------------

Hi Kathey,

I think it would be a great idea to open a JIRA on the topic of reviving the global index.
Even if DITA can't do the job, we might be able to write our own tool to walk the source files
and build an index. I believe that indexable terms are still tagged in the source. Thanks.
                
> Make all topics visible in ToCs
> -------------------------------
>
>                 Key: DERBY-6050
>                 URL: https://issues.apache.org/jira/browse/DERBY-6050
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.10.0.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Trivial
>             Fix For: 10.10.0.0
>
>         Attachments: DERBY-6050-2.diff, DERBY-6050.diff, toc.html, toc.html
>
>
> Every topic in our documentation set appears in the table of contents for its manual,
except for four syntax-related topics in the Reference Manual:
> - column-definition, generated-column-spec, and generation-clause, all under the CREATE
TABLE statement
> - ReferencingClause, under the CREATE TRIGGER statement
> All of these have the following attribute setting in the map file:
> toc="no"
> I'd like to remove this setting for the following reasons:
> - The documentation for all other syntax clauses can be found in the ToC.
> - Except for ReferencingClause, all are linked to from other topics in addition to their
parent topic.
> - I have often been puzzled that I can get to those topics by clicking links but not
by locating them in the ToC. (I may spend more time navigating the Reference Manual than most
people do, of course.)
> Unless someone can provide a reason why these topics in particular should be hidden,
I'll file a patch soon and commit it in a day or two. 
> Although this situation has existed since 10.1, I don't plan to backport the fix, since
it's a very minor issue.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message