You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2007/12/13 16:20:43 UTC
[jira] Created: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Developer's Guide has duplicate information on database connections
-------------------------------------------------------------------
Key: DERBY-3274
URL: https://issues.apache.org/jira/browse/DERBY-3274
Project: Derby
Issue Type: Bug
Affects Versions: 10.3.1.4
Reporter: Kim Haase
The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
Specifically:
For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
The following sections can then be removed:
http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Dyre Tjeldvoll (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12552458 ]
Dyre Tjeldvoll commented on DERBY-3274:
---------------------------------------
Patch looks good, +1. I plan to commit it shortly.
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Resolved: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-3274.
------------------------------
Resolution: Fixed
Fix Version/s: 10.4.0.0
Thanks very much, Dyre!
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Fix For: 10.4.0.0
>
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Dyre Tjeldvoll (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dyre Tjeldvoll updated DERBY-3274:
----------------------------------
Derby Info: (was: [Patch Available])
Committed revision 605549.
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kathey Marsden (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kathey Marsden updated DERBY-3274:
----------------------------------
Component/s: Documentation
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3274:
-----------------------------
Derby Info: [Patch Available]
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Closed: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase closed DERBY-3274.
----------------------------
Should have closed this months ago.
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Fix For: 10.4.0.0
>
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Assigned: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase reassigned DERBY-3274:
--------------------------------
Assignee: Kim Haase
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551570 ]
Kim Haase commented on DERBY-3274:
----------------------------------
One more change needs to be made:
http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") has a crossreference to http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") for "more information". In fact it is cdevdvlp91854.html itself that has most of this information -- not rdevdvlp38881.html or the file to which its information was moved. So the cross-reference should be cut.
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3274) Developer's Guide has duplicate
information on database connections
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3274?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3274:
-----------------------------
Attachment: DERBY-3274.stat
DERBY-3274.zip
DERBY-3274.diff
Attaching DERBY-3274.diff, DERBY-3274.zip, and DERBY-3274.stat, containing modifications and deletions of the following files:
M src/devguide/cdevdvlp91854.dita
D src/devguide/cdevdvlp40170.dita
D src/devguide/tdevdvlp38381.dita
M src/devguide/derbydev.ditamap
D src/devguide/rdevdvlp38881.dita
M src/devguide/cdevdvlp17453.dita
M src/devguide/cdevdvlp40653.dita
M src/devguide/cdevspecial29620.dita
M src/devguide/cdevdvlp39409.dita
D src/devguide/cdevdvlp10252.dita
D src/devguide/cdevdvlp25174.dita
> Developer's Guide has duplicate information on database connections
> -------------------------------------------------------------------
>
> Key: DERBY-3274
> URL: https://issues.apache.org/jira/browse/DERBY-3274
> Project: Derby
> Issue Type: Bug
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3274.diff, DERBY-3274.stat, DERBY-3274.zip
>
>
> The Developer's Guide contains some duplicated information about database connections and related topics. One glaring example is the short top-level section "Embedded Derby basics", which comes after a longer section of the same title under "JDBC applications and Derby basics". The information in the short section that doesn't duplicate information elsewhere needs to be included in appropriate places in the long section (and elsewhere as appropriate). The topics for the short section should then be removed.
> Specifically:
> For the two introductory topics, the two sentences from http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics") should replace the sentence in http://db.apache.org/derby/docs/dev/devguide/cdevdvlp39409.html (same title), since they offer more substance.
> The first sentence of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver"), "The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.", should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> Most of http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html, "Derby JDBC database connection URL". Also, this text should cross-reference the sections http://db.apache.org/derby/docs/dev/devguide/cdevdvlp91854.html ("Accessing databases from the classpath") and http://db.apache.org/derby/docs/dev/devguide/cdevdvlp24155.html ("Accessing databases from a jar or zip file"). In http://db.apache.org/derby/docs/dev/devguide/cdevdvlp17453.html itself, the sentence "For more information about what you can specify with the Derby connection URL, see "Examples"." is incorrect. I believe this should be a cross-reference to the section http://db.apache.org/derby/docs/dev/devguide/rdevdvlp22102.html ("Database connection examples"). Also, the sentence "For detailed reference about attributes and values, as well as syntax of the database connection URL, see the "Derby Database Connection URL Syntax" in the Derby Reference Manual." refers, I believe, to the wrong section. That particular topic contains only a couple of sentences and refers back to the Developer's Guide. I think the sentence should say instead, "For detailed reference about attributes and values, see "Setting attributes for the database connection URL" in the Derby Reference Manual." (The syntax is actually covered more fully in the Developer's Guide than in the Reference Manual.)
> The last paragraph of http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection") should be moved to http://db.apache.org/derby/docs/dev/devguide/cdevspecial29620.html, "Database-side JDBC procedures and nested connections". (This topic also has a couple of minor typographical issues that can be fixed at the same time.)
> The example of the use of the jdbc.drivers system property should be moved from http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database") to http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40653.html, "Derby JDBC driver".
> The following sections can then be removed:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25174.html ("Derby embedded basics")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp40170.html ("Embedded Derby JDBC driver")
> http://db.apache.org/derby/docs/dev/devguide/rdevdvlp38881.html ("Embedded Derby JDBC database connection URL")
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp10252.html ("Getting a nested connection")
> http://db.apache.org/derby/docs/dev/devguide/tdevdvlp38381.html ("Starting Derby as an embedded database")
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.