Re: cygwin-man

[Joshua Daniel Franklin <joshuadfranklin at yahoo dot com>]

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, joshuadfranklin@yahoo.com


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/