This is the mail archive of the cygwin mailing list for the Cygwin project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Looking for man pages


On Thu, Jun 28, 2007 at 12:18:11PM -0700, Brian Dessent wrote:
>Bob McConnell wrote:
>
>> I can't find any links to anything other than one sample man page. We
>> already have copies of that spec, although I have never had any cause to
>> read it.
>
>Wha?  The SUSv3 is extremely thorough, consisting of many hundreds of
>man pages:
><http://www.opengroup.org/onlinepubs/009695399/functions/contents.html>.
>
>> What steps are involved to convert those pages?
>
>The problem with lifting man pages from Linux is that those man pages
>document ... Linux.  Not Cygwin.
>
>There are a number of areas where either Cygwin doesn't implement some
>extension that glibc provides, or Cygwin implements something in a
>different way, or Cygwin doesn't support particular options of a given
>API.  Just transplanting these linux-specific docs would utterly confuse
>people because they'd be incorrect.  So what really needs to happen is
>that someone who is familiar with the internals of Cygwin needs to adapt
>the linux documentation so that it reflects the reality of Cygwin, and
>*that* is why it's not been done.  It's not just a matter of format
>conversion or packaging.

I wonder if having slightly inaccurate manpages is better or worse than
having no manpages at all though.  I really don't know which is more
desirable.

cgf

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]