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] Updated: (DERBY-1972) Working With Derby needs some formatting fixes and other minor cleanup
Date Mon, 04 Dec 2006 18:49:25 GMT
     [ http://issues.apache.org/jira/browse/DERBY-1972?page=all ]

Kim Haase updated DERBY-1972:

    Attachment: DERBY-1972-2-dita.zip

I see the problem! I'm attaching the DITA files. 

I tried to observe the Getting Started doc conventions. There are a couple of items that aren't
covered in those conventions: command-line commands (vs. SQL ones) and URL connection attributes.
For these I used codeph, but if you think they should be in italic I can make that change.
I still haven't figured out the principle behind putting so many things in italics.

> Working With Derby needs some formatting fixes and other minor cleanup
> ----------------------------------------------------------------------
>                 Key: DERBY-1972
>                 URL: http://issues.apache.org/jira/browse/DERBY-1972
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions:
>            Reporter: Kim Haase
>         Assigned To: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-1747.diff, DERBY-1972-2-dita.zip, DERBY-1972-2.diff, DERBY-1972-2.zip,
DERBY-1972.zip, DERBY_1972.diff
> The Working With Derby book uses DITA tags in ways that are not always consistent with
the usage in other books and that lead to some problems in the processed output. Some examples
are the use of the <varname> tag in inappropriate places and the use of formatting tags
within <codeblock> tags.
> There are also a few minor punctuation and syntax issues worth fixing.

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


View raw message