Issue Details (XML | Word | Printable)

Key: DERBY-2489
Type: Improvement Improvement
Status: Closed Closed
Resolution: Fixed
Priority: Major Major
Assignee: Rick Hillegas
Reporter: Rick Hillegas
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
Derby

Document the policy-reloading system procedure.

Created: 26/Mar/07 07:00 PM   Updated: 01/Jul/09 12:34 AM
Return to search
Component/s: Documentation
Affects Version/s: None
Fix Version/s: 10.3.1.4

Time Tracking:
Not Specified

File Attachments:
  Size
Java Archive File Licensed for inclusion in ASF works derby-2489-01-output.jar 2007-03-26 08:50 PM Rick Hillegas 15 kB
File Licensed for inclusion in ASF works derby-2489-01.diff 2007-03-26 08:50 PM Rick Hillegas 7 kB
Java Archive File Licensed for inclusion in ASF works derby-2489-02-output.jar 2007-03-30 04:30 PM Rick Hillegas 10 kB
File Licensed for inclusion in ASF works derby-2489-02.diff 2007-03-30 04:30 PM Rick Hillegas 8 kB
Issue Links:
Incorporates
 

Resolution Date: 10/Apr/07 03:56 PM


 Description  « Hide
Document SYSCS_RELOAD_SECURITY_POLICY, which was introduced by DERBY-2466. This includes teasing apart the documentation of the Template and Basic policies.

 All   Comments   Work Log   Change History   Subversion Commits      Sort Order: Ascending order - Click to sort in descending order
Rick Hillegas added a comment - 26/Mar/07 08:50 PM
Attaching derby-2489-01.diff and a jarball of the corresponding html output, derby-2489-01-output.jar. Touches the following files:

M src/adminguide/tadminnetservbasic.dita
M src/adminguide/tadminnetservcustom.dita

   Teases apart the distinction between the Basic and the Template security policies.

M src/devguide/cdevbabejgjd.dita

    Describes the optional getPolicy() permission.

A src/ref/rrefreloadpolicyproc.dita
M src/ref/refderby.ditamap

   Docments the policy-reloading system procedure



Kim Haase added a comment - 28/Mar/07 05:48 PM
Thanks for this excellent documentation, Rick.

Just a few doc nits:

cdevbabejgjd.html:

You might want to make the link to http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html active by
wrapping it in

<xref format="html" scope="external" xref="http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html">
http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html&lt;/xref>

The scope="external" attribute causes the link to open in a new browser window. I believe that in other files in the Dev Guide there are URLs that are currently wrapped in <synph> like this one, but that is not the preferred tag.

In the last item under "Optional permissions," the correct manual name is "Reference Manual," not "Reference Guide". You might want to use the conrefs citation for this, similar to the one for for Tuning Derby in the previous item.

rrefreloadpolicyproc.html:

I know you can't do an actual cross-reference, but you might want to refer people to the sections in the Admin and Dev guides that discuss this subject.

Rick Hillegas added a comment - 30/Mar/07 04:30 PM
Thanks for the great suggestions, Kim. I have incorporated them in rev 2 of this patch, which I've committed at subversion revision 524158.

Rick Hillegas added a comment - 10/Apr/07 03:56 PM
I believe this documentation is done.