Return-Path: 
 <derby-dev-return-31854-apmail-db-derby-dev-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-derby-dev-archive@www.apache.org
Received: (qmail 11537 invoked from network); 16 Oct 2006 16:26:28 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 16 Oct 2006 16:26:28 -0000
Received: (qmail 19665 invoked by uid 500); 16 Oct 2006 16:26:28 -0000
Delivered-To: apmail-db-derby-dev-archive@db.apache.org
Received: (qmail 19491 invoked by uid 500); 16 Oct 2006 16:26:28 -0000
Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:derby-dev-help@db.apache.org>
List-Unsubscribe: <mailto:derby-dev-unsubscribe@db.apache.org>
List-Post: <mailto:derby-dev@db.apache.org>
List-Id: <derby-dev.db.apache.org>
Reply-To: <derby-dev@db.apache.org>
Delivered-To: mailing list derby-dev@db.apache.org
Received: (qmail 19482 invoked by uid 99); 16 Oct 2006 16:26:27 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 16 Oct 2006 09:26:27 -0700
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received: from [209.237.227.198] (HELO brutus.apache.org) (209.237.227.198)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 16 Oct 2006 09:26:27 -0700
Received: from brutus (localhost [127.0.0.1])
	by brutus.apache.org (Postfix) with ESMTP id 98C2A7142D7
	for <derby-dev@db.apache.org>; Mon, 16 Oct 2006 09:25:37 -0700 (PDT)
Message-ID: <2271153.1161015937623.JavaMail.jira@brutus>
Date: Mon, 16 Oct 2006 09:25:37 -0700 (PDT)
From: "Laura Stewart (JIRA)" <derby-dev@db.apache.org>
To: derby-dev@db.apache.org
Subject: [jira] Commented: (DERBY-408) Fix formatting of manuals in PDF
 output
In-Reply-To: <1144815032.1120080358591.JavaMail.jira@ajax.apache.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

    [ http://issues.apache.org/jira/browse/DERBY-408?page=comments#action_12442633 ] 
            
Laura Stewart commented on DERBY-408:
-------------------------------------

I don't believe that the documentation should use tags like bold <b> to force line breaks. Infact, in most cases there shouldn't be bold tags inside of codeblocks and syntax.  Typically uppercase letters are used for the required SQL and lowercase letters for the variables such as index-name. Sometimes <varname> is used for the variables, which displays the text in italic.  

This sounds like a DITA - to - XSL-FO problem. 

> Fix formatting of manuals in PDF output
> ---------------------------------------
>
>                 Key: DERBY-408
>                 URL: http://issues.apache.org/jira/browse/DERBY-408
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>         Environment: all
>            Reporter: Jeff Levitt
>         Assigned To: Andrew McIntyre
>            Priority: Minor
>             Fix For: 10.3.0.0
>
>         Attachments: derby-408.diff
>
>
> 1.  The syntax boxes in many of the Derby manuals seem to output with extra End-of-line feeds in the PDF's.  Some syntax boxes print one word per line.   For example:
> http://incubator.apache.org/derby/docs/tools/tools-single.html#rtoolsijpropref10135
> This might be a bug with the DITA toolkit, because the DITA source files dont have these End-of-line feeds in them.
> This bug was originally reported in the doc reviews for version 10.1:
> http://issues.apache.org/jira/browse/DERBY-383
> (see Myrna's comments)
> 2.  Based on http://issues.apache.org/jira/browse/DERBY-384 comments to the doc review (see Sunitha's comments), we need to figure out how to et the table numbers to ascend.  Currently, they all output as table 1.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira