X-Spam-Check-By: sourceware.org Date: Thu, 28 Jun 2007 15:32:45 -0400 From: Christopher Faylor 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: <20070628180239 DOT GJ30973 AT calimero DOT vinschen DOT de> <46840973 DOT BD68B5A4 AT dessent DOT net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 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 Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , 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: >. > >> 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/