I've got my hands full at present, but I would consider it going
forward.
Lloyd
On Aug 10, 2009, at 11:28 AM, kedar wrote:
> Sure, do you want to do it? Please work with Paul if you have cycles.
>
> Lloyd Chambers wrote:
>> Why not have a CLI specification which spells out the best practices?
>> AMX does so for reasons like that (and more):
>> https://glassfish.dev.java.net/nonav/v3/admin/planning/V3Changes/V3_AMX_SPI.html
>> Lloyd
>> On Aug 7, 2009, at 3:59 PM, Kedar Mhaswade wrote:
>>> Like I said, I applaud the efforts. Maybe we should put this in
>>> pluggability guide that discusses something like -- How to extend
>>> GlassFish administration commands.
>>>
>>> BTW, those suggestions should be enhanced to provide more verbs
>>> where
>>> we standardize on certain English language verbs, especially those
>>> that describe "composite" tasks, of which configure-ldap-for-admin
>>> is an
>>> example.
>>>
>>> Maybe we should do a tool to warn the module developers about
>>> potential violations of the conventions?
>>>
>>> I guess the ship has sailed for already released commands, but maybe
>>> for commands not in Prelude and in FCS should keep this in mind.
>>>
>>> -Kedar
>>>
>>> Paul Davies wrote:
>>>> Hi Kedar,
>>>> As these commands are being developed under the auspices of the
>>>> GlassFish project, would it not be possible to contact the module
>>>> owners, who must be known to us, to suggest that the command
>>>> names be consistent?
>>>> I realize that we do not have control over arbitrary 3rd-party
>>>> modules, but we do provide guidelines <http://docs.sun.com/doc/820-7727/ghrpm
>>>> > to ensure consistency. In the interest of setting a good
>>>> example to contributors to the GlassFish project and owners of
>>>> arbitrary 3rd-party modules, should we try to follow our own
>>>> conventions?
>>>> Regards,
>>>> -Paul
>>>> On 08/07/09 15:21, Kedar Mhaswade wrote:
>>>>> I appreciate your efforts, but in a modular server, that's going
>>>>> to
>>>>> result -- the inconsistency in command names because we don't have
>>>>> control over how modules write/name their commands.
>>>>>
>>>>> Yes, but we should do the best practices for naming.
>>>>>
>>>>> Paul Davies wrote:
>>>>>> Hi,
>>>>>>
>>>>>> While looking at the new asadmin commands in build 58, I
>>>>>> noticed a couple of commands the names of which appear not to
>>>>>> follow the established conventions for asadmin command names:
>>>>>>
>>>>>> * jruby-container-config
>>>>>> * setup-ldap-for-admin
>>>>>
>>>>>>
>>>>>> I was wondering if, for the sake of consistency and ease of
>>>>>> use, the names these commands should be change. If so, I would
>>>>>> suggest the following names:
>>>>>>
>>>>>> * configure-jruby-container
>>>>>> * configure-ldap-for-admin
>>>>>
>>>>> I wrote this new command which I am going to document
>>>>> extensively and yes,
>>>>> I can rename it per your suggestion. As my commit log says, this
>>>>> command
>>>>> is still experimental, very close to being inducted in the hall
>>>>> of fame ;)
>>>>>
>>>>> Thanks.
>>>>>
>>>>> -Kedar
>>>>>
>>>>>>
>>>>>> Regards,
>>>>>>
>>>>>> --
>>>>>> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
>>>>>> http://blogs.sun.com/techscribe/
>>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>>>>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>>>>
>>>> --
>>>> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
>>>> http://blogs.sun.com/techscribe/
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>>
>> Lloyd Chambers
>> lloyd.chambers_at_sun.com
>> GlassFish Team
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>
Lloyd Chambers
lloyd.chambers_at_sun.com
GlassFish Team