After looking at this, I think two "intro" pages would be best. Here is my RFC for intro.3:
INTRO(3) Cygwin INTRO(3) NAME intro - Introduction to the Cygwin API DESCRIPTION Cygwin is a UNIX environment, developed by Red Hat, for Windows. It consists of two parts: A DLL (cygwin1.dll) which acts as a UNIX emulation layer providing substantial UNIX API functionality. This page describes the API provided by the DLL. A collection of tools, ported from UNIX, which provide UNIX/Linux look and feel. This environment is described in the intro(1) man page. AVAILABILITY Cygwin is developed by volunteers collaborating over the Internet. It is distributed through the website http://www.cygwin.com. The website has extensive documen- tation, inlcuding FAQ, User's Guide, and API Reference. It should be considered the authoritative source of informa- tion. The source code, relased under the GNU General Pub- lic Licence, Version 2, is also availalbe from the website or one of the mirrors. COMPATIBILITY Cygwin policy is to attempt to adhere to POSIX/SUSv2 (Portable Operating System Interface for UNIX / The Single UNIX Specification, Version 2) where possible. Where these standards are ambiguous, Cygwin tries to mimic Linux. SUSv2 is available online at: http://www.opengroup.org/onlinepubs/007908799/ For compatibility information about specific functions, see the API Reference at: http://cygwin.com/cygwin-api/cygwin-api.html Cygwin is in many ways hindered by the underlying differ- ences between UNIX and Win32 (for example, a case-insensi- tive file system), so complete compatibility will probably never be acheived. COPYRIGHT Cygwin is Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. Cygwin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License; see the file COPYING. If not, write to the Free Software Foundation, 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. The GPL is currently available online at: http://www.gnu.org/licenses/gpl.html AUTHOR Joshua Daniel Franklin, [EMAIL PROTECTED] SEE ALSO intro(1) 2002 April 05 INTRO(3) __________________________________________________ Do You Yahoo!? Yahoo! Tax Center - online filing with TurboTax http://taxes.yahoo.com/ -- Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple Bug reporting: http://cygwin.com/bugs.html Documentation: http://cygwin.com/docs.html FAQ: http://cygwin.com/faq/