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-6473) Manuals are inconsistent in subsubprotocol information
Date Wed, 12 Feb 2014 21:18:19 GMT

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

Kim Haase updated DERBY-6473:
-----------------------------

    Attachment: DERBY-6473.zip
                DERBY-6473.stat
                DERBY-6473.diff

Attaching DERBY-6473.diff, DERBY-6473.stat, and DERBY-6473.zip, with the following changes:

M       src/ref/rrefjdbc27433.dita
M       src/ref/rrefjdbc37352.dita
M       src/devguide/cdevdvlp17453.dita
M       src/devguide/cdevdvlp34964.dita
M       src/devguide/rdevdvlp22102.dita
M       src/devguide/cdevdvlp51654.dita

I moved the reference information from the Developer's Guide to the Reference Manual (consolidating
the info between the two topics) and modified a number of cross-references elsewhere.

> Manuals are inconsistent in subsubprotocol information
> ------------------------------------------------------
>
>                 Key: DERBY-6473
>                 URL: https://issues.apache.org/jira/browse/DERBY-6473
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-6473.diff, DERBY-6473.stat, DERBY-6473.zip
>
>
> Four subsubprotocols are listed in http://db.apache.org/derby/docs/10.10/devguide/cdevdvlp17453.html
(Derby JDBC database connection URL), but only three in http://db.apache.org/derby/docs/10.10/ref/rrefjdbc37352.html
(Syntax of database connection URLs for applications with embedded databases), which was apparently
not updated when we documented in-memory databases. The Reference Manual should be corrected.
> Since reference information really belongs in the Reference Manual and duplicate information
is hard to maintain, it would probably be a good idea to correct the syntax information in
the reference manual topic, remove it from the Developer's Guide topic, and point Developer's
Guide readers to the Reference Manual. I'll plan on doing this unless I hear otherwise.



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)

Mime
View raw message