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-1780) Document all supplied system procedures in the Server and Administration Guide (e.g. class loading utils and import/export)
Date Tue, 24 May 2011 14:03:47 GMT

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

Kim Haase updated DERBY-1780:

    Attachment: DERBY-1780-2.zip

This patch contains Tools Guide changes. Attaching DERBY-1780-2.diff, DERBY-1780-2.stat, and
DERBY-1780-2.zip, with the following changes:

D       src/tools/rtoolsimport57005.dita
M       src/tools/rtools1003161.dita
M       src/tools/ctoolsijtools30948.dita
M       src/tools/ctoolsijtools90477.dita
D       src/tools/ctoolsimport27052.dita
D       src/tools/ctoolsimportnulls.dita
M       src/tools/ctoolsijtools37363.dita
D       src/tools/ctoolsimportlobs.dita
M       src/tools/derbytools.ditamap
M       src/tools/ctools1004764.dita
D       src/tools/ctoolsimportidentitycol.dita
M       src/tools/ctoolspre22460.dita
D       src/tools/ctoolsimportdefaultformat.dita
D       src/tools/rtoolsimport64241.dita
D       src/tools/ctoolsimportjdbc.dita
D       src/tools/rtoolsimport92876.dita
D       src/tools/ctoolsimport12925.dita
D       src/tools/ttoolsimporting.dita
D       src/tools/ttoolsexporting.dita
M       src/tools/ctoolsijtools26429.dita
M       src/tools/ctoolspre23947.dita
D       src/tools/rtoolsimport91458.dita
M       src/tools/ctoolspre11181.dita
D       src/tools/ctoolsimport98264.dita
D       src/tools/rtoolsexportarguements.dita
D       src/tools/ctoolsimport16245.dita
D       src/tools/rtoolsimportcodeset.dita

In addition to removing the import and export topic files, I did some cleanup in the introductory

Removed jar and import/export tools from "Purpose of this document" (ctoolspre11181.dita)
Fixed formatting of "Audience" (ctoolspre22460.dita)
Removed import/export reference from "How this guide is organized" (ctoolspre23947.dita)
Reworded "What are the Derby tools and utilities?" somewhat (ctoolsijtools26429.dita)
Removed jar and import/export tools from "Overview" (ctoolsijtools30948.dita)
Removed info on jar and import/export tools from "Environment setup and the Derby tools" (ctoolsijtools37363.dita)
Stopped referring to derbyrun.jar as new in "Classpath" (rtools1003161.dita)
Removed unneeded ids and link within topic from "About locales" (ctools1004764.dita)
Changed really, really old date in "Formatting display of locale-sensitive data" (ctoolsijtools90477.dita)

What additional changes are needed?

In addition, three topics in the Tools Guide source files that deal with the import/export
utilities are not currently used in the manual:

ctoolsimport12925.dita, "Bulk import and export"
rtoolsimport57005.dita, "Bulk-Import"
rtoolsimport92876.dita, "Exporting bulk data"

They appear to contain information covered in other topics. I removed them and did not transfer
them to the Admin Guide.

> Document all supplied system procedures in the Server and Administration Guide (e.g.
class loading utils and import/export)
> ---------------------------------------------------------------------------------------------------------------------------
>                 Key: DERBY-1780
>                 URL: https://issues.apache.org/jira/browse/DERBY-1780
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:,,
>            Reporter: Stan Bradbury
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-1780-1.diff, DERBY-1780-1.stat, DERBY-1780-1.zip, DERBY-1780-2.diff,
DERBY-1780-2.stat, DERBY-1780-2.zip
>  Most of the utilities cataloged in SYSCS_UTIL are used to setup/initialize a Derby system
and are invoked using an existing connection using the 'CALL' command,  Such topics are best
covered in the the Server and Administration Guide. Currently the procedures install_jarfiles,
replace_jarfiles, remove_jarfiles, SYSCS_IMPORT_TABLE / DATA and SYSCS_EXPORT_TABLE / QUERY
are documented in the Tools and Utilities Guide.  
> I recommend reserving the Tools and Utilities Guide for routines that have a standalone
interface (e.g. an existing connection is not required to invoke the routine), currently that
is IJ, sysinfo and dblook.

This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

View raw message