Hi Bill,
Thank you for this response. I have trimmed most of the previous discussion, as
your suggested wording of the note addresses most of the questions that the
discussion raised.
Some further responses inline:
>> From this comment, it appears that they are available whenever the
>> command is available. Is that correct? [The answer determines whether
>> I edit or delete the existing text in the man pages.]
>
>
> That's the intent, but there are unfortunate limitations because we
> weren't able to completely change the implementation to remove the
> restrictions that existed with editions.
What effect do those limitations have on options whose availabilty used to be
determined by the edition? Is the availability of these options determined by
how a domain is configured? Or are they available whenever the command is
available? (Apologies for labouring this point, but there's quite a bit of
legacy text in the man pages that needs to be either deleted or modified.)
[quoted text deleted]
>
> This command is available only in domains that are configured
> to support clusters, such as domains created using the "cluster"
> or "enterprise" profiles.
With very minor changes to accommodate the needs of Sun editorial style, I'll
use this wording.
> But see above about the risk of depending on the name.
Our tools make this risk very small. I can define an SGML text entity for each
name and then refer to those entities in the man pages. If the name of a profile
were to change, changing the name in all the man pages would be a 1-line change
in 1 file.
Thanks again.
--
Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
http://blogs.sun.com/techscribe/