Paul Davies wrote on 06/30/09 13:31:
> Hi,
>
>> Kedar has documented most of this here:
>> https://glassfish.dev.java.net/nonav/v3/admin/planning/j109/admin-cli.html
>>
>>
>> I don't think all of this is going to get implemented for v3, but it
>> gives you an idea of the direction we're headed.
>>
> I have been working from this document to determine the effect of these
> changes on the documentation. Will Kedar or somebody else be updating
> this document to indicate what will be implemented for v3 and what will
> not?
That's a good question. :-) I would suggest asking Abhijit how
he wants to handle this.
But, let's take this one step at a time...
The changes to the way options are handled as described in section 2.1
are just about done. (I haven't switched it to be the default yet,
but will as soon as some testing is done.)
Can you work on determining the effect of this change on the documentation?
I know this will have significant effect on the man pages and similar docs,
and it would be good if we could update all the examples accordingly.
(Fortunately, since the old way still works, it's not a disaster if some
things don't get updated.)
I'm hoping we can use this change to simplify the documentation of each
command by avoiding repeating the common asadmin options when describing
each command. Instead, the main asadmin command should describe the
common options and then each command need only describe the command-specific
options.
Let me know if this doesn't make sense.
Thanks!