OK everyone here is your chance to speak your mind about what someone who installs Cygwin and types "man intro" (expecting a revelation, no doubt) will see:
INTRO(1) Cygwin INTRO(1) NAME intro - Introduction to the Cygwin Environment 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. The intro(3) man page gives an introduction to this API. A collection of tools, ported from UNIX, which provide UNIX/Linux look and feel. This man page describes the user environment. AVAILABILITY Cygwin is developed by volunteers collaborating over the Internet. It is distributed through the website http://cygwin.com, where you can find extensive documenta- tion, including FAQ, User's Guide, and API Reference. The Cygwin website should be considered the authoritative source of information. The source code, released under the GNU General Public License, Version 2, is also available from the website or one of the mirrors. COMPATIBILITY The majority of the tools Cygwin provides are part of the Free Software Foundation's GNU Operating System. (In fact, Cygwin was once known as GNU/Win32.) As such, the user environment is more similar to a GNU/Linux system than, for example, Sun Solaris. However, the FSF has put great effort into maintaining compatibility with standard UNIX utilities where possible, so assuming the necessary utilities are installed most scripts will run without editing on both UNIX and Cygwin. The default login shell for Cygwin is the GNU "Bourne- Again Shell", bash, but other shells such as tcsh (an improved csh) are also available and can be installed using Cygwin's setup.exe. The Bourne-compatible shell ash is used as /bin/sh. NOTES To port applications you will need to install the develop- ment tools, which you can do by selecting gcc in setup.exe (dependencies are automatically handled). If you need a specific program or library, you can search for a Cygwin package containing it at: http://cygwin.com/packages/ If you are a UNIX veteran who plans to use Cygwin exten- sively, you will probably find it worth your while to learn to use Cygwin-specific tools that provide a UNIX-like interface to common operations. For example, cygpath converts between UNIX and Win32-style pathnames. The full documentation for these utilities is at: http://cygwin.com/cygwin-ug-net/using-utils.html The optional cygutils package also contains utilities that help with common problems, such as dos2unix and unix2dos for the CRLF issue. DOCUMENTATION In addition to man pages and texinfo documentation, many Cygwin packages provide system-independent documentation in the /usr/doc/ directory and Cygwin-specific documenta- tion in /usr/doc/Cygwin For example, if you have both less and cron installed, the command less /usr/src/Cygwin/cron.README would display the instructions to set up cron on your sys- tem. REPORTING BUGS If you find a bug in Cygwin, please provide a patch to fix the bug. There are instructions at: http://cygwin.com/contrib.html If you cannot do this, at the very least read http://cygwin.com/bugs.html and follow the instructions for reporting found there. COPYRIGHT Cygwin is Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. Cygwin is Free software; for complete licensing informa- tion, refer to: http://cygwin.com/licensing.html MAINTAINER This man page was written and is maintained by Joshua Daniel Franklin, [EMAIL PROTECTED] SEE ALSO intro(3) 2002 April 07 INTRO(1) __________________________________________________ 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/