Derby
  1. Derby
  2. DERBY-711

The documentation should explain that Derby database files are platform-independent

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.1.2.1
    • Fix Version/s: 10.6.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      Somehow the fact that Derby database files are platform independent slipped making it into the documentation. Here's a relevant post:

      http://mail-archives.apache.org/mod_mbox/db-derby-user/200511.mbox/%3c437BD555.4040503@debrunners.com%3e

      1. cgsintro.html
        4 kB
        Bryan Pendleton
      2. docs.diff
        1 kB
        Bryan Pendleton

        Activity

        Hide
        Bryan Pendleton added a comment -

        Seems like a reasonable place to put this would be
        http://db.apache.org/derby/docs/10.5/getstart/cgsintro.html

        I think we could just add something like:

        The on-disk database format used by Derby is portable and
        platform-independent. Derby databases can be moved from
        machine to machine without needing to modify the data; a
        Derby application can include a pre-built, populated database
        if it needs to, and that database will work in any Derby configuration.

        I think we could make this a paragraph by itself, right before the
        "Before you install Derby" paragraph.

        Show
        Bryan Pendleton added a comment - Seems like a reasonable place to put this would be http://db.apache.org/derby/docs/10.5/getstart/cgsintro.html I think we could just add something like: The on-disk database format used by Derby is portable and platform-independent. Derby databases can be moved from machine to machine without needing to modify the data; a Derby application can include a pre-built, populated database if it needs to, and that database will work in any Derby configuration. I think we could make this a paragraph by itself, right before the "Before you install Derby" paragraph.
        Hide
        Bryan Pendleton added a comment -

        Attached is a proposal to modify the Getting Started guide, and an
        HTML version of the proposed new patch.

        Please let me know what you think.

        Show
        Bryan Pendleton added a comment - Attached is a proposal to modify the Getting Started guide, and an HTML version of the proposed new patch. Please let me know what you think.
        Hide
        Kim Haase added a comment -

        Looks great, Bryan – thanks.

        One suggestion – you could simplify the second sentence (and avoid a dangling participle and passive voice):

        "You can move Derby databases from machine to machine without modifying the data."

        Show
        Kim Haase added a comment - Looks great, Bryan – thanks. One suggestion – you could simplify the second sentence (and avoid a dangling participle and passive voice): "You can move Derby databases from machine to machine without modifying the data."
        Hide
        Bryan Pendleton added a comment -

        Thanks Kim, that reads much better. Updated the patch and committed it to the
        docs trunk as revision 883397.

        Show
        Bryan Pendleton added a comment - Thanks Kim, that reads much better. Updated the patch and committed it to the docs trunk as revision 883397.

          People

          • Assignee:
            Bryan Pendleton
            Reporter:
            Jean T. Anderson
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development