admin@glassfish.java.net

Update comments on list, get and dotted-names man pages

From: Dixie Pine <Dixie.Pine_at_Sun.COM>
Date: Mon, 14 Sep 2009 13:21:24 -0700

On 09/11/09 21:08, Bill Shannon wrote:
> Dixie Pine wrote on 9/11/09 11:48 AM:
>
>> Greetings,
>>
>> I've attached pdfs of the FINAL list-get-set man pages, and also the
>> dotted-names concepts page, since they go together. The material in
>> dotted-names is essentially all new, much of it integrated from Kedar's
>> material in the v2 list-get-set man pages. Procedures from this v2
>> material were moved to the Admin Guide.
>>
>> Bill provided a review.
>>
>> Please let me know if anything else needs to change.
>>
>
> In get.1...
>
> The short option should be "-m", not "--m", and it's missing from the
> synopsis.
>
I fixed the -m short option. However, it seems short options are not
usually included in the synopsis, just the long version. The only one I
see in any synopsis statement is [--secure|-s]. I don't know why this
is. I've queried Paul about it.
> Example 2 talks about LOW or HIGH being values for enabled attributes,
> but the actual value in the example if "ON".
>
should be HIGH. fixed
> In Example 3, "values the jvm" -> "values of the jvm".
>
fixed
> The vertical spacing before the EXAMPLE titles should be greater than
> the vertical spacing after the EXAMPLE titles.
>
The spacing does look odd. It's something the publishing SW does. All
the examples are written the same way but they don't look that way in
PDF. Lovely in html and text.
>
> In list.1...
>
> "-m", as above.
>
done
> Under Description, the examples probably should *not* have "--monitor".
>
removed
>
> In dotted-names.5...
>
> "known dot" -> "known as dot"
>
fixed