Alan Coopersmith wrote:
> Garrett D'Amore wrote:
>
>> When the --man output really is a manual page, I still object. It
>> doesn't matter what you call it -- the problem is that we have two
>> copies of the same information, the on-line manual page and the bits in
>> the binary.
>>
>
> Will your opinion text also recommend to the PAC that they delete all
> the admin guides, user guides, and all other docs other than the man
> pages from the Solaris documentation and docs.sun.com because they are
> multiple copies of the same information?
>
No, because of two reasons:
1) the "man pages" are sourced by the same process and originate
from the same text
2) those bits are not delivered to the end-users on the media
Of course, if you want to add some text to the potential opinion (which
may or may not be a minority opinion), feel free to send me draft text
after the vote.
- Garrett
> This is the cost of having human users - it's often more usable to provide
> the same information in multiple ways, and the cost is that we need to
> remember to update all of them when modifying the software.
>
>
