[
https://issues.apache.org/jira/browse/DERBY-6050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13564394#comment-13564394
]
Kim Haase commented on DERBY-6050:
----------------------------------
I thought we had a JIRA for the index, but it must have been closed as will not
fix, or it is buried under some other heading. I agree it would be valuable to
be able to produce one. Some areas are, I think, spottily indexed, but it
should be possible to add index terms where they are needed.
It is very mysterious to me that the properties for pre-10.8 docs don't show up
in searches. The indexterm entries are exactly the same for all releases -- for
pageCacheSize, at least.
> 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
