db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Knut Anders Hatlen (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-6379) Manuals are inconsistent in their use of the <shortdesc> element
Date Tue, 22 Oct 2013 13:58:42 GMT

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

Knut Anders Hatlen commented on DERBY-6379:
-------------------------------------------

I think IBM JCE is mentioned because that particular functionality does not work with the
JCE libraries that come with Oracle's JDK since the public prime specified by the DRDA spec
is too short. More details here: [http://db.apache.org/derby/docs/10.10/adminguide/cadminapps811695.html].
I'm not sure, though, why this is listed as a difference between embedded and network.

+1 to removing 3.0 from the topic title.

I think the "Network Server console" means the standard output destination of the network
server process. That is, when it says a message goes to derby.log and the network server console,
it means that the network server writes the message to derby.log and System.out.

> Manuals are inconsistent in their use of the <shortdesc> element
> ----------------------------------------------------------------
>
>                 Key: DERBY-6379
>                 URL: https://issues.apache.org/jira/browse/DERBY-6379
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.10.1.1
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>
> When topics are organized as subtopics of other topics, our tools generate a list of
the subtopics at the end of the parent topic. If the DITA source of the subtopic begins with
a <shortdesc> element, the contents of the <shortdesc> appear under the subtopic
title in the parent topic. These contents also form the first paragraph of the subtopic. It
does not seem to be possible to suppress the list of subtopics; they appear in the HTML output,
but not in the PDF.
> Generally, the documentation is not consistent in its use of the <shortdesc> element.
> I'll add more detail in a comment.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Mime
View raw message