Return-Path: X-Original-To: apmail-db-derby-dev-archive@www.apache.org Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 41D4811864 for ; Wed, 2 Jul 2014 21:13:25 +0000 (UTC) Received: (qmail 88264 invoked by uid 500); 2 Jul 2014 21:13:25 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 88239 invoked by uid 500); 2 Jul 2014 21:13:25 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 88227 invoked by uid 99); 2 Jul 2014 21:13:25 -0000 Received: from arcas.apache.org (HELO arcas.apache.org) (140.211.11.28) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 02 Jul 2014 21:13:25 +0000 Date: Wed, 2 Jul 2014 21:13:25 +0000 (UTC) From: "Kim Haase (JIRA)" To: derby-dev@db.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Updated] (DERBY-6379) Manuals are inconsistent in their use of the element MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/DERBY-6379?page=3Dcom.atlassia= n.jira.plugin.system.issuetabpanels:all-tabpanel ] Kim Haase updated DERBY-6379: ----------------------------- Attachment: DERBY-6379-tools-tooldoc.zip DERBY-6379-tools-tooldoc.stat DERBY-6379-tools-tooldoc.diff Attaching DERBY-6379-tools-tooldoc.diff, DERBY-6379-tools-tooldoc.stat, and= DERBY-6379-tools-tooldoc.zip, with shortdescs and formatting fixes for the= last 16 topics in the Tools Guide (sysinfo through the optional tools). I will commit this patch tomorrow unless I hear otherwise. > Manuals are inconsistent in their use of the 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 > Fix For: 10.11.0.0, 10.10.2.0 > > Attachments: DERBY-6379-adminconcepts.diff, DERBY-6379-adminconce= pts.stat, DERBY-6379-adminreference.diff, DERBY-6379-adminreference.stat, D= ERBY-6379-admintasks.diff, DERBY-6379-admintasks.stat, DERBY-6379-devguide-= branch.diff, DERBY-6379-devguide-branch.diff, DERBY-6379-devguide.diff, DER= BY-6379-devguide.stat, DERBY-6379-ref-attrib.diff, DERBY-6379-ref-attrib.st= at, DERBY-6379-ref-attrib.zip, DERBY-6379-ref-clauses.diff, DERBY-6379-ref-= clauses.stat, DERBY-6379-ref-clauses.zip, DERBY-6379-ref-diag.diff, DERBY-6= 379-ref-diag.stat, DERBY-6379-ref-diag.zip, DERBY-6379-ref-diag.zip, DERBY-= 6379-ref-dtypes.diff, DERBY-6379-ref-dtypes.stat, DERBY-6379-ref-dtypes.zip= , DERBY-6379-ref-exprs.diff, DERBY-6379-ref-exprs.stat, DERBY-6379-ref-expr= s.zip, DERBY-6379-ref-jdbc.diff, DERBY-6379-ref-jdbc.stat, DERBY-6379-ref-j= dbc.zip, DERBY-6379-ref-misc.diff, DERBY-6379-ref-misc.stat, DERBY-6379-ref= -misc.zip, DERBY-6379-ref-pref.diff, DERBY-6379-ref-pref.stat, DERBY-6379-r= ef-pref.zip, DERBY-6379-ref-props.diff, DERBY-6379-ref-props.stat, DERBY-63= 79-ref-props.zip, DERBY-6379-ref-stmts-2.diff, DERBY-6379-ref-stmts-2.stat,= DERBY-6379-ref-stmts-2.zip, DERBY-6379-ref-stmts.diff, DERBY-6379-ref-stmt= s.stat, DERBY-6379-ref-stmts.zip, DERBY-6379-reffuncs.diff, DERBY-6379-reff= uncs.stat, DERBY-6379-refprocs.diff, DERBY-6379-refprocs.stat, DERBY-6379-t= ools-com.diff, DERBY-6379-tools-com.stat, DERBY-6379-tools-com.zip, DERBY-6= 379-tools-props.diff, DERBY-6379-tools-props.stat, DERBY-6379-tools-props.z= ip, DERBY-6379-tools-start.diff, DERBY-6379-tools-start.stat, DERBY-6379-to= ols-start.zip, DERBY-6379-tools-tooldoc.diff, DERBY-6379-tools-tooldoc.stat= , DERBY-6379-tools-tooldoc.zip, DERBY-6379-toolstuning.stat > > > When topics are organized as subtopics of other topics, our tools generat= e a list of the subtopics at the end of the parent topic. If the DITA sourc= e of the subtopic begins with a element, the contents of the appear under the subtopic title in the parent topic. These conten= ts also form the first paragraph of the subtopic. It does not seem to be po= ssible to suppress the list of subtopics; they appear in the HTML output, b= ut not in the PDF. > Generally, the documentation is not consistent in its use of the element. > I'll add more detail in a comment. -- This message was sent by Atlassian JIRA (v6.2#6252)