[ 
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
                DERBY-1780-2.stat
                DERBY-1780-2.diff

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 sections:

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: 10.0.2.1, 10.1.2.1, 10.1.3.1
>            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

Reply via email to