/hg/icedtea-web: Add man page for PolicyEditor

[Andrew Azores]

On 03/11/2014 05:03 AM, Jiri Vanek wrote:
> Is small fix possible?
>
> diff -r f58e426ca958 netx/policyeditor.1
> --- a/netx/policyeditor.1    Mon Mar 10 16:30:44 2014 -0400
> +++ b/netx/policyeditor.1    Tue Mar 11 10:01:14 2014 +0100
> @@ -14,7 +14,7 @@
>  policy_file
>  .SH DESCRIPTION
>  .B policyeditor
> -is a command line program to view and edit applet security policy 
> settings
> +is a GUI application with small command line support to view and edit 
> applet security policy settings
>  used by the icedtea-web implementation of
>  .B javaws
>  and the browser plugin. It is intended as a simpler, easier to use, 
> and more
>
> I think the "command line program" is a bit misleading...
>
> J.

D'oh :) wow. Thanks for catching that. Feel free to push.

> On 03/10/2014 09:30 PM, aazores at icedtea.classpath.org wrote:
>> changeset f58e426ca958 in /hg/icedtea-web
>> details: 
>> http://icedtea.classpath.org/hg/icedtea-web?cmd=changeset;node=f58e426ca958
>> author: Andrew Azores<aazores at redhat.com>
>> date: Mon Mar 10 16:30:44 2014 -0400
>>
>>     Add man page for PolicyEditor
>>
>>     * Makefile.am: (install-data-local, uninstall-local): added 
>> policyeditor.1
>>     man page
>>     * netx/policyeditor.1: new man page for PolicyEditor
>>
>>
>> diffstat:
>>
>>   Makefile.am         |   3 ++
>>   netx/policyeditor.1 |  69 
>> +++++++++++++++++++++++++++++++++++++++++++++++++++++
>>   2 files changed, 72 insertions(+), 0 deletions(-)
>>
>> diffs (93 lines):
>>
>> diff -r bd7ce0fce548 -r f58e426ca958 Makefile.am
>> --- a/Makefile.am    Mon Mar 10 15:44:51 2014 -0400
>> +++ b/Makefile.am    Mon Mar 10 16:30:44 2014 -0400
>> @@ -257,6 +257,7 @@
>>       ${mkinstalldirs} -d $(DESTDIR)$(mandir)/man1
>>       ${INSTALL_DATA} $(NETX_SRCDIR)/javaws.1 $(DESTDIR)$(mandir)/man1
>>       ${INSTALL_DATA} $(NETX_SRCDIR)/itweb-settings.1 
>> $(DESTDIR)$(mandir)/man1
>> +    ${INSTALL_DATA} $(NETX_SRCDIR)/policyeditor.1 
>> $(DESTDIR)$(mandir)/man1
>>   if ENABLE_DOCS
>>       ${mkinstalldirs} $(DESTDIR)$(htmldir)
>>       (cd ${abs_top_builddir}/docs/netx; \
>> @@ -278,6 +279,8 @@
>>       rm -f $(DESTDIR)$(datadir)/$(PACKAGE_NAME)/plugin.jar
>>       rm -f $(DESTDIR)$(datadir)/$(PACKAGE_NAME)/netx.jar
>>       rm -f $(DESTDIR)$(mandir)/man1/javaws.1
>> +    rm -f $(DESTDIR)$(mandir)/man1/itweb-settings.1
>> +    rm -f $(DESTDIR)$(mandir)/man1/policyeditor.1
>>       rm -f $(DESTDIR)$(bindir)/$(javaws)
>>       rm -f $(DESTDIR)$(bindir)/$(itweb_settings)
>>       rm -f $(DESTDIR)$(bindir)/$(policyeditor)
>> diff -r bd7ce0fce548 -r f58e426ca958 netx/policyeditor.1
>> --- /dev/null    Thu Jan 01 00:00:00 1970 +0000
>> +++ b/netx/policyeditor.1    Mon Mar 10 16:30:44 2014 -0400
>> @@ -0,0 +1,69 @@
>> +.TH policyeditor 1 "10 Mar 2014"
>> +
>> +.SH NAME
>> +
>> +policyeditor - view and modify security policy settings for
>> +.B javaws
>> +and the browser plugin
>> +
>> +.SH SYNOPSIS
>> +
>> +.B policyeditor
>> +.br
>> +.B policyeditor [-file]
>> +policy_file
>> +.SH DESCRIPTION
>> +.B policyeditor
>> +is a command line program to view and edit applet security policy 
>> settings
>> +used by the icedtea-web implementation of
>> +.B javaws
>> +and the browser plugin. It is intended as a simpler, easier to use, 
>> and more
>> +accessible alternative to the standard JDK Policy Tool. 
>> Administrators and
>> +power users who need fine grained control over policy files should 
>> probably
>> +use Policy Tool instead of PolicyEditor.
>> +
>> +If executed without any arguments, no file is opened, and saving the 
>> file will
>> +result in a prompt on where to save it. Otherwise, if a file path is 
>> given as
>> +a command line argument, then that file path will be opened and 
>> parsed as a
>> +policy file.
>> +
>> +
>> +.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.
>> +
>> +.SH EXAMPLES
>> +
>> +.TP
>> +policyeditor
>> +Show the GUI editor
>> +
>> +.TP
>> +policyeditor -file $HOME/.config/icedtea-web/security/java.policy
>> +Opens the default user-level policy file location
>> +
>> +
>> +.SH FILES
>> +
>> +$HOME/.config/icedtea-web/security/java.policy the default 
>> user-level policy file location
>> +
>> +.SH BUGS
>> +
>> +There aren't any known bugs. If you come across one, please file it at
>> +    http://icedtea.classpath.org/bugzilla/
>> +
>> +.SH AUTHOR
>> +
>> +Written and maintained by the IcedTea contributors.
>> +
>> +.SH SEE ALSO
>> +
>> +.BR policytool (1),
>> +.BR javaws (1),
>> +.BR java (1)
>> +.br
>> +http://icedtea.classpath.org/wiki/IcedTea-Web
>

Thanks,

-- 
Andrew A