Glenn Fowler wrote:
> On Sun, 26 Jul 2009 16:00:57 -0700 Garrett D'Amore wrote:
>
>> Roland Mainz wrote:
>>
>>> Alan Coopersmith wrote:
>>>
>>>
>>>> I'm sponsoring this fast-track request on behalf of the
>>>> ksh93-integration and busybox projects. The timeout is
>>>> set for Friday, July 31, 2009.
>>>>
>>>>
>>> [snip]
>>>
>>> Just to clarify (since both points have IMHO been either ignored or
>>> misinterpreted several times):
>>> 1. We do _not_ intent to remove or discontinue normal documentation,
>>> including manual pages (in fact I've been a long-term advocate of
>>> getting Solaris moved to DocBook/XML-based manual pages (including
>>> _shipping_ them as part of the installation instead of the nroff
>>> versions (that's why I even worked on a /usr/bin/man replacement
>>> codebase))).
>>>
>
>
>> I heard you. However, the upstream sources have *not* agreed with this
>> approach.
>>
>
> you want upstream to agree to an approach that even solaris hasn't settled on
> yet?
>
Well that much is true (we've not settled yet) -- the decision *would*
have been good to have (either way), which is why I derailed it... I
felt that such a decision deserved explicit consideration rather than
coming in as an implementation detail.
That said... I received the following text in an e-mail message from you
(also delivered to the list):
in almost all other cases the optget() usage string *is* the man
page src,
and we have no intention of ever maintaining separate .1 man pages,
save the traditional exceptions for the long ones like sh(1)
if there are concerns about maintaining separate optget() usage strings
and .1 text files for ast commands on solaris, then I recommend
generating the man page from the --nroff output;
So while the question of a separate XML file wasn't specifically raised
and answered, I had taken the above text to indicate that you
(collectively as the ksh93 upstream) were also rejecting other schemes
to move this kind of documentation out of the cooked binary.
I'm sorry if I've misunderstood either you or Roland on this, or if I've
misapplied what you said.
- Garrett
