db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (Updated) (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (DERBY-5640) Use <desc> element for table summary
Date Wed, 21 Mar 2012 20:16:43 GMT

     [ https://issues.apache.org/jira/browse/DERBY-5640?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Kim Haase updated DERBY-5640:
-----------------------------

    Attachment: DERBY-5640-2.zip
                DERBY-5640-2.stat
                DERBY-5640-2.diff

Attaching DERBY-5640-2.diff, DERBY-5640-2.stat, and DERBY-5640-2.zip, with the remaining changes
to the Getting Started manual, and an additional change to the build setup to prevent the
table descriptions from appearing in the PDF output:

M       src/getstart/tgssetupverify.dita
M       src/getstart/twwdactivity1.dita
M       src/getstart/twwdactivity3_Setup.dita
M       src/getstart/rgslib46043.dita
M       src/getstart/twwdactivity2.dita
M       src/getstart/tgsrunningsysinfo.dita
M       src/getstart/rgsdocs18277.dita
M       src/getstart/tgsrunningij.dita
M       src/getstart/rgsdocs10012.dita
M       src/getstart/twwdactivity1_Setup.dita
M       src/getstart/rgsderbyrunjarsyntax.dita
M       src/getstart/twwdactivity4.dita
M       src/getstart/tgsrunningdblook.dita
M       build.xml
A       lib/dita2fo-elems.xsl

The change to the dita2fo-elems.xsl file means that no desc element appears in the PDF output.
Although it is possible to put desc elements in a few locations other than tables, the Derby
documentation does not use them anywhere else. 

Another minor change is that the existing version of the dita2fo-elems.xsl file is all on
one line for some reason; this version has newlines for readability.

The zip file contains only a small sample, not the output for every file with tables.

I will check this in in a couple of days unless I hear otherwise. 
                
> Use <desc> element for table summary
> ------------------------------------
>
>                 Key: DERBY-5640
>                 URL: https://issues.apache.org/jira/browse/DERBY-5640
>             Project: Derby
>          Issue Type: Sub-task
>          Components: Documentation
>    Affects Versions: 10.8.2.2, 10.9.0.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>             Fix For: 10.8.2.2
>
>         Attachments: DERBY-5640-2.diff, DERBY-5640-2.stat, DERBY-5640-2.zip, DERBY-5640.diff,
DERBY-5640.stat, DERBY-5640.zip
>
>
> Currently we provide table summaries by putting the table caption in the summary. However,
the <desc> element should be used for this purpose.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message