Kim Haase created DERBY-6050:
--------------------------------
Summary: 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
Priority: Trivial
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
