From 42fb62041d4bcc7fa8eb200891fbf91876ebf738 Mon Sep 17 00:00:00 2001 From: Joshua Daniel Franklin Date: Fri, 16 Jan 2004 06:31:49 +0000 Subject: 2004-01-15 Joshua Daniel Franklin * setup-net.sgml: Add "internet-setup" id anchor. * overview.sgml: Update "What is it?" section. Add links to "Is it free software?" section. Update "Brief History" section. * overview2.sgml: Rewrite "Expectations for {Windows,Unix}" as "Quick Start for those more experienced with {Windows,Unix}". --- winsup/doc/overview2.sgml | 87 +++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 76 insertions(+), 11 deletions(-) (limited to 'winsup/doc/overview2.sgml') diff --git a/winsup/doc/overview2.sgml b/winsup/doc/overview2.sgml index 04b6b35e7..560bd8205 100644 --- a/winsup/doc/overview2.sgml +++ b/winsup/doc/overview2.sgml @@ -1,23 +1,86 @@ -Expectations for UNIX Programmers + +Quick Start Guide for those more experienced with Windows + +If you are new to the world of UNIX, you may find it difficult to +understand at first. This guide is not meant to be comprehensive, +so we recommend that you use the many available Internet resources +to become acquainted with UNIX basics (search for "UNIX basics" or +"UNIX tutorial"). + + +To install a basic Cygwin environment, run the +setup.exe program and click Next +at each page. The default settings are correct for most users. If you +want to know more about what each option means, see +. Use setup.exe +any time you want to update or install a Cygwin package. If you are +installing Cygwin for a specific purpose, use it to install the tools +that you need. For example, if you want to compile C++ programs, you +need the gcc-g++ package and probably a text +editor like nano. When running +setup.exe, clicking on categories and packages in the +package installation screen will provide you with the ability to control +what is installed or updated. + + +Another option is to install everything by clicking on the +Default field next to the All +category. However, be advised that this will download and install +several hundreds of megabytes of software to your computer. The best +plan is probably to click on individual categories and install either +entire categories or packages from the categories themselves. + + +Developers coming from a Windows background will find a set of tools capable of +writing console or GUI executables that rely on the Microsoft Win32 API. The +dlltool utility may be used to write Windows Dynamically +Linked Libraries (DLLs). The resource compiler windres is +also provided. All tools may be used from the Microsoft command prompt, +with full support for normal Windows pathnames. + + -Developers coming from a UNIX background will find a set of utilities + +Quick Start Guide for those more experienced with UNIX + +If you are an experienced UNIX user who misses a powerful command-line +environment, you will enjoy Cygwin. Note that there are some workarounds +that cause Cygwin to behave differently than most UNIX-like operating +systems; these are described in more detail in +. + + +Any time you want to update or install a Cygwin package, use the +graphical setup.exe program. By default, +setup.exe only installs a minimal set of packages, +so look around and choose your favorite utilities on the package +selection screen. You may also search for specfic tools on the Cygwin +website's Setup Package +Search For more information about what each option in +setup.exe means, see . + + +Another option is to install everything by clicking on the +Default field next to the All +category. However, be advised that this will download and install +several hundreds of megabytes of software to your computer. The best +plan is probably to click on individual categories and install either +entire categories or packages from the categories themselves. + + +Developers coming from a UNIX background will find a set of utilities they are already comfortable using, including a working UNIX shell. The compiler tools are the standard GNU compilers most people will have previously used under UNIX, only ported to the Windows host. Programmers wishing to port UNIX software to Windows NT or 9x will find that the Cygwin library provides an easy way to port many UNIX packages, with only minimal source code -changes. - +changes. + -Expectations for Windows Programmers -Developers coming from a Windows background will find a set of tools capable -of writing console or GUI executables that rely on the Microsoft Win32 API. -The linker and dlltool utility may be used to write Windows Dynamically Linked -Libraries (DLLs). The resource compiler "windres" is also provided with the -native Windows GNUPro tools. All tools may be used from the Microsoft command -line prompt, with full support for normal Windows pathnames. +Highlights of Cygwin Functionality + Introduction When a binary linked against the library is executed, the Cygwin DLL is loaded into the application's text segment. Because we are trying to emulate a UNIX kernel @@ -318,3 +381,5 @@ thread to wake up. This case is now the same as the first one since we know at least one descriptor is ready. So select returns, after polling all of the file descriptors one last time. + + -- cgit v1.2.3