/hg/icedtea-web: Updated policyeditor documentation

[aazores at icedtea.classpath.org]

changeset 78f6e65ed7b3 in /hg/icedtea-web
details: http://icedtea.classpath.org/hg/icedtea-web?cmd=changeset;node=78f6e65ed7b3
author: Andrew Azores <aazores at redhat.com>
date: Wed Mar 12 09:35:48 2014 -0400

	Updated policyeditor documentation

	* netx/net/sourceforge/jnlp/resources/Messages.properties:
	(PECodebaseFlag) new message for policyeditor -help
	* netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java:
	(HELP_MESSAGE) added -codebase flag
	* netx/policyeditor.1: updated -file and added -codebase and -help


diffstat:

 ChangeLog                                                         |   8 +++
 netx/net/sourceforge/jnlp/resources/Messages.properties           |   1 +
 netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java |   3 +-
 netx/policyeditor.1                                               |  24 ++++++++-
 4 files changed, 31 insertions(+), 5 deletions(-)

diffs (80 lines):

diff -r db8627ef75f2 -r 78f6e65ed7b3 ChangeLog
--- a/ChangeLog	Tue Mar 11 13:59:10 2014 -0400
+++ b/ChangeLog	Wed Mar 12 09:35:48 2014 -0400
@@ -1,3 +1,11 @@
+2014-03-12  Andrew Azores  <aazores at redhat.com>
+
+	* netx/net/sourceforge/jnlp/resources/Messages.properties:
+	(PECodebaseFlag) new message for policyeditor -help
+	* netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java:
+	(HELP_MESSAGE) added -codebase flag
+	* netx/policyeditor.1: updated -file and added -codebase and -help
+
 2014-03-11  Andrew Azores  <aazores at redhat.com>
 
 	* netx/net/sourceforge/jnlp/security/policyeditor/PermissionTarget.java:
diff -r db8627ef75f2 -r 78f6e65ed7b3 netx/net/sourceforge/jnlp/resources/Messages.properties
--- a/netx/net/sourceforge/jnlp/resources/Messages.properties	Tue Mar 11 13:59:10 2014 -0400
+++ b/netx/net/sourceforge/jnlp/resources/Messages.properties	Wed Mar 12 09:35:48 2014 -0400
@@ -464,6 +464,7 @@
 PEUsage=policyeditor [-file policyfile]
 PEHelpFlag=Print this message and exit
 PEFileFlag=Specify a policyfile path to open
+PECodebaseFlag=Specify (a) codebase URL(s) to add and/or focus in the editor
 PETitle=Policy Editor
 PEReadProps=Read system properties
 PEReadPropsDetail=Allow applets to read system properties such as your username and home directory location
diff -r db8627ef75f2 -r 78f6e65ed7b3 netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java
--- a/netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java	Tue Mar 11 13:59:10 2014 -0400
+++ b/netx/net/sourceforge/jnlp/security/policyeditor/PolicyEditor.java	Wed Mar 12 09:35:48 2014 -0400
@@ -144,7 +144,8 @@
 
     private static final String HELP_MESSAGE = "Usage:\t" + R("PEUsage") + "\n\n"
             + "  " + HELP_FLAG + "\t\t\t" + R("PEHelpFlag") + "\n"
-            + "  " + FILE_FLAG + "\t\t\t" + R("PEFileFlag") + "\n";
+            + "  " + FILE_FLAG + "\t\t\t" + R("PEFileFlag") + "\n"
+            + "  " + CODEBASE_FLAG + "\t\t" + R("PECodebaseFlag") + "\n";
 
     private static final String AUTOGENERATED_NOTICE = "/* DO NOT MODIFY! AUTO-GENERATED */";
 
diff -r db8627ef75f2 -r 78f6e65ed7b3 netx/policyeditor.1
--- a/netx/policyeditor.1	Tue Mar 11 13:59:10 2014 -0400
+++ b/netx/policyeditor.1	Wed Mar 12 09:35:48 2014 -0400
@@ -12,6 +12,8 @@
 .br
 .B policyeditor [-file]
 policy_file
+.B [-codebase]
+url
 .SH DESCRIPTION
 .B policyeditor
 is a GUI application with small command line support to view and edit applet security policy settings
@@ -31,10 +33,24 @@
 .SH OPTIONS
 
 .TP
--file
-Specifies a policy file path to open. If this is not given as an argument, the
-first argument given is interpreted as a file path to open anyway. This switch
-exists mostly for compatibility with Policy Tool.
+-help
+Prints a short help text and exits.
+
+.TP
+-file policy_file
+Specifies a policy file path to open. If exactly one argument is given, and it
+is not this flag, it is interpreted as a file path to open, as if this flag
+was given first. This flag exists mostly for compatibility with Policy Tool,
+but is also needed when opening a policy file and also using the -codebase flag.
+
+.TP
+-codebase url
+Specifies an applet codebase URL. If the specified codebase already exists in
+the policy file (if any), then it will be selected when the editor opens. If
+it is a new codebase then it will be added and selected. Multiple URLs may also
+be given with a single -codebase flag by separating them with spaces. In this
+case, the last codebase given will be selected, and all will be added. If this
+flag is given more than once, only the first is used.
 
 .SH EXAMPLES