delorie.com/archives/browse.cgi   search  
Mail Archives: cygwin/2007/06/28/15:33:35

X-Spam-Check-By: sourceware.org
Date: Thu, 28 Jun 2007 15:32:45 -0400
From: Christopher Faylor <cgf-use-the-mailinglist-please AT cygwin DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Looking for man pages
Message-ID: <20070628193245.GA2310@ednor>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <FF8482A96323694490C194BABEAC24A0011F1C40 AT Email DOT cbord DOT com> <20070628180239 DOT GJ30973 AT calimero DOT vinschen DOT de> <FF8482A96323694490C194BABEAC24A0011F1DFF AT Email DOT cbord DOT com> <46840973 DOT BD68B5A4 AT dessent DOT net>
MIME-Version: 1.0
In-Reply-To: <46840973.BD68B5A4@dessent.net>
User-Agent: Mutt/1.5.15 (2007-04-06)
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

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/

- Raw text -


  webmaster     delorie software   privacy  
  Copyright © 2019   by DJ Delorie     Updated Jul 2019