[ 
http://issues.apache.org/jira/browse/DERBY-1968?page=comments#action_12443054 ] 
            
Kim Haase commented on DERBY-1968:
----------------------------------

This is in the file rtoolsijproprefdatasource.dita.

I notice that the codeblock that contains the long line looks strange. I think 
the text is supposed to be on three different lines, but in the DITA source it 
is not.

<codeblock><b>ij.dataSource=<i>dataSourcename</i></b> 
<b>ij.dataSource.databaseName=<i>databasename</i></b> 
<b>[ij.dataSource.createDatabase=create]</b></codeblock>

This is another case of DERBY-408, where the untagged white space in a 
codeblock is ignored. However, the source at some point lost the line breaks 
too. I believe the output is meant to look like this (I won't try to reproduce 
the italics), with the brackets indicating that the last property is optional:

ij.dataSource=dataSourcename
ij.dataSource.databaseName=databasename
[ij.dataSource.createDatabase=create]

For an explanation of the example, would it be enough to say the following?

The following example creates a database named sample using an 
EmbeddedDataSource.

Or do you think more is needed? Thanks for any feedback.

> Derby tools guide: Long line in documentation of ij.dataSource
> --------------------------------------------------------------
>
>                 Key: DERBY-1968
>                 URL: http://issues.apache.org/jira/browse/DERBY-1968
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.2.1.6, 10.3.0.0
>         Environment: PDF files
>            Reporter: Øystein Grøvlen
>         Assigned To: Kim Haase
>            Priority: Trivial
>
> In the definition of ij.dataSource in the Tools Guide, a line is wider than 
> the page.  (Page 16 in 10.2 documentation)

-- 
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


Reply via email to