db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-408) Fix formatting of manuals in PDF output
Date Thu, 07 Dec 2006 20:50:22 GMT
    [ http://issues.apache.org/jira/browse/DERBY-408?page=comments#action_12456597 ] 
            
Kim Haase commented on DERBY-408:
---------------------------------

More detail: the problem of ignoring whitespace between adjacent tags applies to all adjacent
tags in body text, as near as I can make out. Two examples:

the <ph conref="wwdconrefs.dita#prod/productshortname"></ph> <codeph>ij</codeph>
tool

the <ph conref="wwdconrefs.dita#prod/productshortname"></ph> <varname>URL
attribute</varname>

In the monohtml and PDF, these come out as "the Derbyij tool" and "the DerbyURL attribute";
"ij" is in code font and "URL attribute" is in italics, but the spaces are lost.

Also, here is a simpler example of the problem with codeblocks. The following results in preserved
line breaks:

<codeblock>
<b><userinput>java MyProgram</userinput></b>

program output
</codeblock>

But the following, where the spaces are between two tags, does not:

<codeblock>
<b><userinput>java MyProgram</userinput></b>

<systemoutput>program output</systemoutput>
</codeblock>

Interestingly, using <pre> instead of <codeblock> causes the line breaks to be
preserved.

> 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