Derby
  1. Derby
  2. DERBY-4696

Remove the outdated content about "frameworks subdirectory" in "getstartderby"

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.6.1.0
    • Fix Version/s: 10.7.1.1
    • Component/s: Documentation
    • Labels:
    • Urgency:
      Normal
    • Issue & fix info:
      Newcomer

      Description

      there is some outdated content about "frameworks subdirectory" in "getstartderby"[1.] for the latest release 10.6.1.0.

      In Page 12 in Chapter "Installing Derby", it says,
      "Extract the downloaded package. The extracted installation contains several subdirectories:
      ......
      The frameworks subdirectory contains older scripts for executing utilities and setting up the environment. These are provided in this release for backward compatibility. These scripts are deprecated in favor of the scripts in the bin directory, and will be removed in a future release."

      However, for the newest release, after extracting the downloaded package, there is not the frameworks subdirectory. As Knut's advice, the document need be changed accordingly.

      1. derby-4696.patch
        0.8 kB
        Yun Lee
      2. derby-4696.stat
        0.0 kB
        Yun Lee

        Issue Links

          Activity

          Hide
          Myrna van Lunteren added a comment -

          Built and verified the new files look ok. Committed the patch with revision 985012. Resolving this issue; updates to latest docs should happen automatically.

          Show
          Myrna van Lunteren added a comment - Built and verified the new files look ok. Committed the patch with revision 985012. Resolving this issue; updates to latest docs should happen automatically.
          Hide
          Yun Lee added a comment -

          The outdated content has been deleted. Please check the patch, thanks!

          Show
          Yun Lee added a comment - The outdated content has been deleted. Please check the patch, thanks!
          Hide
          Yun Lee added a comment -

          Thanks a lot, Knut and Bryan. They are all helpful to me. I will do some study on the docs and provide a patch some days later.

          Show
          Yun Lee added a comment - Thanks a lot, Knut and Bryan. They are all helpful to me. I will do some study on the docs and provide a patch some days later.
          Hide
          Bryan Pendleton added a comment -

          Also, the docs trunk is yet a third location in the repository, separate from both the code trunk
          and the site trunk. You will want to checkout the docs trunk by doing

          svn checkout https://svn.apache.org/repos/asf/db/derby/docs/trunk/

          Show
          Bryan Pendleton added a comment - Also, the docs trunk is yet a third location in the repository, separate from both the code trunk and the site trunk. You will want to checkout the docs trunk by doing svn checkout https://svn.apache.org/repos/asf/db/derby/docs/trunk/
          Hide
          Knut Anders Hatlen added a comment -

          Hi Yun,

          You can find the instructions for building the documentation here: http://db.apache.org/derby/manuals/dita.html
          It might be a little tricky to get it working the first time, so please don't hesitate to ask if you run into trouble.

          Once you have set up the environment, you can build the pdf version of the getting started guide by running "ant pdf.getstart".

          Show
          Knut Anders Hatlen added a comment - Hi Yun, You can find the instructions for building the documentation here: http://db.apache.org/derby/manuals/dita.html It might be a little tricky to get it working the first time, so please don't hesitate to ask if you run into trouble. Once you have set up the environment, you can build the pdf version of the getting started guide by running "ant pdf.getstart".
          Hide
          Yun Lee added a comment -

          Ask for help!

          I'm not familiar with work on document. After checking out the code trunk and site trunk, I haven't found content about "frameworks subdirectory" nor the document titled by "getstartderby". Could anybody show me where to do the change and how to create a new pdf doc in Derby? Thanks a lot!

          Show
          Yun Lee added a comment - Ask for help! I'm not familiar with work on document. After checking out the code trunk and site trunk, I haven't found content about "frameworks subdirectory" nor the document titled by "getstartderby". Could anybody show me where to do the change and how to create a new pdf doc in Derby? Thanks a lot!
          Hide
          Yun Lee added a comment -

          Kunt has pointed out in an email:", the frameworks directory was removed in DERBY-3026, and it was removed from the documentation in DERBY-1662 and DERBY-1709."

          Show
          Yun Lee added a comment - Kunt has pointed out in an email:", the frameworks directory was removed in DERBY-3026 , and it was removed from the documentation in DERBY-1662 and DERBY-1709 ."

            People

            • Assignee:
              Yun Lee
              Reporter:
              Yun Lee
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Due:
                Created:
                Updated:
                Resolved:

                Development