Mail Archives: cygwin/2006/03/26/22:24:39
On 3/25/06, George wrote:
> FWIW, I'd like to think that expanding the contents of the Cygwin man
> pages ('man cygwin' and 'man intro') to provide the above information as
> well as offer an overview of Cygwin-specific tools, etc. would go a long
> way.
Wow, someone actually read that page I wrote? I think I already did mention
all those things, with the exception of "man foo" for obvious reasons. The
important sections:
AVAILABILITY
Cygwin is developed by volunteers collaborating over the Internet. It
is distributed through the website http://cygwin.com, where you can
find extensive documentation, including FAQ, User's Guide, and API Ref-
erence. 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
Cygwin uses the GNU versions of many of the standard UNIX command-line
utilities (sed, awk, etc.), so the user environment is more similar to
a Linux system than, for example, Sun Solaris.
The default login shell and /bin/sh for Cygwin is bash, the GNU
"Bourne-Again Shell", but other shells such as tcsh (an improved csh)
are also available and can be installed using Cygwin's setup.exe.
NOTES
To port applications you will need to install the development tools,
which you can do by selecting gcc in setup.exe (dependencies are auto-
matically 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 extensively, 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 docu-
mentation 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 pack-
ages provide system-independent documentation in the /usr/share/doc/
directory and Cygwin-specific documentation in /usr/share/doc/Cygwin/
For example, if you have both less and cron installed, the command
less /usr/share/doc/Cygwin/cron.README
would display the instructions to set up cron on your system.
REPORTING BUGS
If you find a bug in Cygwin, please read
http://cygwin.com/bugs.html
and follow the instructions for reporting found there. If you are able
to track down the source of the bug and can provide a fix, there are
instructions for contributing patches at:
http://cygwin.com/contrib.html
--
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 -