db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Laura Stewart (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-408) Fix formatting of manuals in PDF output
Date Mon, 16 Oct 2006 16:25:37 GMT
    [ 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

        

Mime
View raw message