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] Commented: (DERBY-4153) Document that starting with 10.5 network server will attempt to create the trace directory if it does not exist
Date Tue, 24 Nov 2009 15:31:39 GMT

    [ https://issues.apache.org/jira/browse/DERBY-4153?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12781981#action_12781981

Kim Haase commented on DERBY-4153:

Thanks for working on this, Bryan. I think Rick Hillegas knows the most about security policy
files, so you may have to wait till after Thanksgiving for complete info on that.

Here are a few comments (non-technical as usual):

radminconfigdb2jdrdatracedirectory.dita (derby.drda.traceDirectory property):

It seems as if, for these properties, any additional information is provided in the introductory
section -- the Default section is used only for a terse statement of the default. Also, the
new material seems to apply to an explicitly set property rather than to the default value.
So it should be moved, probably to that first section. (Or maybe the Syntax section.)

tadminadv804410.dita (Turning on the trace facility):

I'm glad you noticed that 2 and 3 are alternatives, not sequential steps. It's good to have
that corrected.

You may have noticed that our DITA processor pays no attention to those <info> tags.
It might be a good idea to make both sets into <p> tags to break up the information,
because otherwise they just get munged into one paragraph.

This isn't in the part you are adding, but you may have noticed that there seems to be a missing
space on the second line of the NetworkServerControl syntax, between the > and the [. It
would be great if you could put that in.

Both topics:

We're not very consistent about the proper font for filenames (derbynet.jar) -- particularly
in this book it varies from the <codeph> tag to the <i> tag to the <filepath>
tag (the last is ignored by our DITA processor for the HTML frames version; it only works
in the PDF and HTML book versions). So take your pick ...

Since DIRECTORY and TRACE DIRECTORY in the security policy lines are meant to be replaceables
rather than literals, you might want to follow the customary usage here and put them in lowercase
and italics, and make the second into one word (tracedirectory seems most consistent with
others in this section).

You might want to put a colon at the ends of the permission lines -- from other examples,
this seems to be needed.

You might also add an xref to the topic "Customizing the Network Server's security policy",

> Document that starting with 10.5 network server will attempt to create the trace directory
if it does not exist
> ---------------------------------------------------------------------------------------------------------------
>                 Key: DERBY-4153
>                 URL: https://issues.apache.org/jira/browse/DERBY-4153
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:
>            Reporter: Kathey Marsden
>            Assignee: Bryan Pendleton
>            Priority: Minor
>         Attachments: docs.diff, radminconfigdb2jdrdatracedirectory.html, tadminadv804410.html
> Starting with 10.5, Network server will attempt to create the trace directory (and any
parent directories) if they do not exist.  This will require that the derbynet.jar permit
verification of the existence of the named trace directory and all necessary parent directories.
 For each directory created, the policy will require
> permission java.io.FilePermission "<directory>", "read,write"
> and the trace directory will require
> permission java.io.FilePermission "<trace directory>${/}/-", "write"

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message