JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

* Throughout, replace http with https as far as cygwin.com and

Browse Source 
sourceware.org URLs are concerned.
	* Throughout, simplify ulink expressions if the visible text is the
	URL anyway.
	* faq-programming.xml (faq.programming.dll-relocatable): Remove.
	* faq-setup.xml (faq.setup.name-with-space): Change for 1.7.34.
	(faq.setup.home): Ditto.
	* faq-using.xml (faq.using.printing): Clarify old links and availability
	of a2ps and file.
	(faq.using.xemacs): Drop outdated version info and pointers to native
	XEmacs.
	(faq.using.ntemacs): Remove.
	* faq-what.xml (faq.what.what): Rephrase to reflect reality.
	(faq.what.supported): Ditto.
	(faq.what.who): Rephrase slightly.
	* legal.xml: Bump copyright.
	* setup-net.xml (internet-setup): Fix references to setup executables.
This commit is contained in:
Corinna Vinschen 2015-02-03 13:48:43 +00:00
parent 0f5a7b350f
commit db9a8c9983
17 changed files with 195 additions and 392 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
winsup/doc/ChangeLog
View File

@ -1,3 +1,23 @@
2015-02-03 Corinna Vinschen <corinna@vinschen.de>
* Throughout, replace http with https as far as cygwin.com and
sourceware.org URLs are concerned.
* Throughout, simplify ulink expressions if the visible text is the
URL anyway.
* faq-programming.xml (faq.programming.dll-relocatable): Remove.
* faq-setup.xml (faq.setup.name-with-space): Change for 1.7.34.
(faq.setup.home): Ditto.
* faq-using.xml (faq.using.printing): Clarify old links and availability
of a2ps and file.
(faq.using.xemacs): Drop outdated version info and pointers to native
XEmacs.
(faq.using.ntemacs): Remove.
* faq-what.xml (faq.what.what): Rephrase to reflect reality.
(faq.what.supported): Ditto.
(faq.what.who): Rephrase slightly.
* legal.xml: Bump copyright.
* setup-net.xml (internet-setup): Fix references to setup executables.
2015-01-23 Pierre A. Humblet <phumblet@phumblet.no-ip.org> 2015-01-23 Pierre A. Humblet <phumblet@phumblet.no-ip.org>
Corinna Vinschen <corinna@vinschen.de> Corinna Vinschen <corinna@vinschen.de>

2
winsup/doc/README
View File

@ -1,5 +1,5 @@
The cygwin-doc source files are kept in CVS. Please see The cygwin-doc source files are kept in CVS. Please see
http://cygwin.com/cvs.html for more information. https://cygwin.com/cvs.html for more information.
BUILD REQUIREMENTS: BUILD REQUIREMENTS:

2
winsup/doc/cygwinenv.xml
View File

@ -20,7 +20,7 @@ by prefixing with <literal>no</literal>.</para>
foreign applications which try to inject threads into a Cygwin process, foreign applications which try to inject threads into a Cygwin process,
or which redirect system sockets by providing an enforced so-called or which redirect system sockets by providing an enforced so-called
<literal>Layered Service Provider</literal>. This may or may not help to <literal>Layered Service Provider</literal>. This may or may not help to
detect <ulink url="http://cygwin.com/faq/faq.html#faq.using.bloda"> detect <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda">
BLODAs</ulink>. Don't use this option for day-to-day usage, it will slow BLODAs</ulink>. Don't use this option for day-to-day usage, it will slow
down every thread and socket creation!</para> down every thread and socket creation!</para>
</listitem> </listitem>

2
winsup/doc/faq-api.xml
View File

@ -36,7 +36,7 @@ is going on). They are only intended for those people who wish to
contribute code to the project. If you aren't going to be happy contribute code to the project. If you aren't going to be happy
debugging problems in a buggy snapshot, avoid these and wait for a real debugging problems in a buggy snapshot, avoid these and wait for a real
release. The snapshots are available from release. The snapshots are available from
<ulink url="http://cygwin.com/snapshots/">http://cygwin.com/snapshots/</ulink>. <ulink url="https://cygwin.com/snapshots/"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>

2
winsup/doc/faq-copyright.xml
View File

@ -10,7 +10,7 @@
<question><para>What are the copyrights?</para></question> <question><para>What are the copyrights?</para></question>
<answer> <answer>
<para>Please see <ulink url="http://cygwin.com/licensing.html"/> <para>Please see <ulink url="https://cygwin.com/licensing.html"/>
for more information about Cygwin copyright and licensing.</para> for more information about Cygwin copyright and licensing.</para>
</answer> </answer>
</qandaentry> </qandaentry>

135
winsup/doc/faq-programming.xml
View File

@ -15,17 +15,17 @@ volunteers to prepare and maintain packages, because the priority of the
Cygwin Team is Cygwin itself. Cygwin Team is Cygwin itself.
</para> </para>
<para>The Cygwin Package Contributor's Guide at <para>The Cygwin Package Contributor's Guide at
<ulink url="http://cygwin.com/setup.html">http://cygwin.com/setup.html</ulink> details everything you need to know <ulink url="https://cygwin.com/setup.html"/> details everything you need to know
about being a package maintainer. The quickest way to get started is to about being a package maintainer. The quickest way to get started is to
read the <emphasis>Initial packaging procedure, script-based</emphasis> section on read the <emphasis>Initial packaging procedure, script-based</emphasis> section on
that page. The <literal>generic-build-script</literal> found there works well for that page. The <literal>generic-build-script</literal> found there works well for
most packages. most packages.
</para> </para>
<para>For questions about package maintenance, use the cygwin-apps mailing <para>For questions about package maintenance, use the cygwin-apps mailing
list (start at <ulink url="http://cygwin.com/lists.html">http://cygwin.com/lists.html</ulink>) <emphasis>after</emphasis> list (start at <ulink url="https://cygwin.com/lists.html"/>) <emphasis>after</emphasis>
searching and browsing the cygwin-apps list archives, of course. Be searching and browsing the cygwin-apps list archives, of course. Be
sure to look at the <emphasis>Submitting a package</emphasis> checklist at sure to look at the <emphasis>Submitting a package</emphasis> checklist at
<ulink url="http://cygwin.com/setup.html">http://cygwin.com/setup.html</ulink> before sending an ITP (Intent To <ulink url="https://cygwin.com/setup.html"/> before sending an ITP (Intent To
Package) email to cygwin-apps. Package) email to cygwin-apps.
</para> </para>
<para>You should also announce your intentions to the general cygwin list, in <para>You should also announce your intentions to the general cygwin list, in
@ -38,7 +38,7 @@ case others were thinking the same thing.
<answer> <answer>
<para>If you want to contribute to Cygwin itself, see <para>If you want to contribute to Cygwin itself, see
<ulink url="http://cygwin.com/contrib.html">http://cygwin.com/contrib.html</ulink>. <ulink url="https://cygwin.com/contrib.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -360,7 +360,7 @@ package at runtime.
<answer> <answer>
<para>Beware of using non-portable shell features in your Makefiles (see tips <para>Beware of using non-portable shell features in your Makefiles (see tips
at <ulink url="http://cygwin.com/faq/faq.html#faq.using.shell-scripts" />). at <ulink url="https://cygwin.com/faq/faq.html#faq.using.shell-scripts"/>).
</para> </para>
<para>Errors of <literal>make: execvp: /bin/sh: Illegal Argument</literal> or <para>Errors of <literal>make: execvp: /bin/sh: Illegal Argument</literal> or
<literal>make: execvp: /bin/sh: Argument list too long</literal> are often <literal>make: execvp: /bin/sh: Argument list too long</literal> are often
@ -388,7 +388,7 @@ done
</screen> </screen>
<para> <para>
See <ulink url="http://cygwin.com/cygwin-ug-net/using.html#mount-table" /> See <ulink url="https://cygwin.com/cygwin-ug-net/using.html#mount-table"/>
for more information on using mount. for more information on using mount.
</para> </para>
@ -401,7 +401,7 @@ error?</para></question>
<para> <para>
Try running cygserver. Read Try running cygserver. Read
<ulink url="http://cygwin.com/cygwin-ug-net/using-cygserver.html" />. If you're <ulink url="https://cygwin.com/cygwin-ug-net/using-cygserver.html"/>. If you're
trying to use PostgreSQL, also read trying to use PostgreSQL, also read
<literal>/usr/share/doc/Cygwin/postgresql-*.README</literal>. <literal>/usr/share/doc/Cygwin/postgresql-*.README</literal>.
</para> </para>
@ -469,9 +469,9 @@ or at least after all the object files and static libraries that reference them.
<note><para>There are a few restrictions for calls to the Win32 API. <note><para>There are a few restrictions for calls to the Win32 API.
For details, see the User's Guide section For details, see the User's Guide section
<ulink url="http://cygwin.com/cygwin-ug-net/setup-env.html#setup-env-win32">Restricted Win32 environment</ulink>, <ulink url="https://cygwin.com/cygwin-ug-net/setup-env.html#setup-env-win32">Restricted Win32 environment</ulink>,
as well as the User's Guide section as well as the User's Guide section
<ulink url="http://cygwin.com/cygwin-ug-net/using.html#pathnames-win32-api">Using the Win32 file API in Cygwin applications</ulink>.</para></note> <ulink url="https://cygwin.com/cygwin-ug-net/using.html#pathnames-win32-api">Using the Win32 file API in Cygwin applications</ulink>.</para></note>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.programming.win32-no-cygwin"> <qandaentry id="faq.programming.win32-no-cygwin">
@ -485,7 +485,7 @@ desirable for native Windows programs that don't need a UNIX emulation layer.
</para> </para>
<para>This is not to be confused with 'MinGW' (Minimalist GNU for Windows), <para>This is not to be confused with 'MinGW' (Minimalist GNU for Windows),
which is a completely separate effort. That project's home page is which is a completely separate effort. That project's home page is
<ulink url="http://www.mingw.org/index.shtml">http://www.mingw.org/index.shtml</ulink>. <ulink url="http://www.mingw.org/index.shtml"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -500,7 +500,7 @@ self-contained executable.
</para> </para>
<para>If this is an issue because you intend to distribute your Cygwin <para>If this is an issue because you intend to distribute your Cygwin
application, then you had better read and understand application, then you had better read and understand
<ulink url="http://cygwin.com/licensing.html">http://cygwin.com/licensing.html</ulink>, which explains the licensing <ulink url="https://cygwin.com/licensing.html"/>, which explains the licensing
options. Unless you purchase a special commercial license from Red options. Unless you purchase a special commercial license from Red
Hat, then your Cygwin application must be Open Source. Hat, then your Cygwin application must be Open Source.
</para> </para>
@ -558,7 +558,7 @@ code links against the Cygwin dll (and if your program is calling
functions from Cygwin, it must, as a matter of fact, be linked against functions from Cygwin, it must, as a matter of fact, be linked against
it), you must apply the GPL to your source as well. Of course, this it), you must apply the GPL to your source as well. Of course, this
only matters if you plan to distribute your program in binary form. For only matters if you plan to distribute your program in binary form. For
more information, see <ulink url="http://gnu.org/licenses/gpl-faq.html">http://gnu.org/licenses/gpl-faq.html</ulink>. If more information, see <ulink url="http://gnu.org/licenses/gpl-faq.html"/>. If
that is not a problem, read on. that is not a problem, read on.
</para> </para>
<para>If you want to load the DLL dynamically, read <para>If you want to load the DLL dynamically, read
@ -711,7 +711,7 @@ documentation, see the README included in the <literal>cygwin-doc</literal> pack
</para> </para>
<para>Next, get the Cygwin source. Ideally, you should check out <para>Next, get the Cygwin source. Ideally, you should check out
what you need from CVS (<ulink url="http://cygwin.com/cvs.html" />). This is the what you need from CVS (<ulink url="https://cygwin.com/cvs.html"/>). This is the
<emphasis>preferred method</emphasis> for acquiring the sources. Otherwise, if <emphasis>preferred method</emphasis> for acquiring the sources. Otherwise, if
you are trying to duplicate a cygwin release then you should you are trying to duplicate a cygwin release then you should
download the corresponding source package download the corresponding source package
@ -751,10 +751,10 @@ same time. Remove all but one.
symbols that you see in gdb are basically meaningless. It is also a good symbols that you see in gdb are basically meaningless. It is also a good
idea to use the latest code in case the bug has been fixed, so we idea to use the latest code in case the bug has been fixed, so we
recommend trying the latest snapshot from recommend trying the latest snapshot from
<ulink url="http://cygwin.com/snapshots/" /> or building the DLL from CVS. <ulink url="https://cygwin.com/snapshots/"/> or building the DLL from CVS.
</para> </para>
<para>To build a debugging version of the Cygwin DLL, you will need to follow <para>To build a debugging version of the Cygwin DLL, you will need to follow
the instructions at <ulink url="http://cygwin.com/faq/faq.html#faq.programming.building-cygwin" />. the instructions at <ulink url="https://cygwin.com/faq/faq.html#faq.programming.building-cygwin"/>.
You can also contact the mailing list for pointers (a simple test case that You can also contact the mailing list for pointers (a simple test case that
demonstrates the bug is always welcome). demonstrates the bug is always welcome).
</para> </para>
@ -776,7 +776,7 @@ incompatibilities. Please send us patches if you do this work!
<answer> <answer>
<para>If you need to change the maximum amount of memory available to Cygwin, see <para>If you need to change the maximum amount of memory available to Cygwin, see
<ulink url="http://cygwin.com/cygwin-ug-net/setup-maxmem.html">http://cygwin.com/cygwin-ug-net/setup-maxmem.html</ulink>. Otherwise, <ulink url="https://cygwin.com/cygwin-ug-net/setup-maxmem.html"/>. Otherwise,
just pass heap/stack linker arguments to gcc. To create foo.exe with just pass heap/stack linker arguments to gcc. To create foo.exe with
a heap size of 200MB and a stack size of 8MB, you would invoke a heap size of 200MB and a stack size of 8MB, you would invoke
gcc as: gcc as:
@ -802,7 +802,7 @@ recursively, provided the command is in your path.
<answer> <answer>
<para>There's documentation that explains the process in the Cygwin User's <para>There's documentation that explains the process in the Cygwin User's
Guide here: <ulink url="http://cygwin.com/cygwin-ug-net/dll.html">http://cygwin.com/cygwin-ug-net/dll.html</ulink> Guide here: <ulink url="https://cygwin.com/cygwin-ug-net/dll.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -817,107 +817,6 @@ question.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.programming.dll-relocatable">
<question><para>How can I build a relocatable dll?</para></question>
<answer>
<para><emphasis role='bold'>(Please note: This section has not yet been updated for the latest net release. However, there was a discussion on the cygwin mailing list once that addresses this issue. Read <ulink url="http://cygwin.com/ml/cygwin/2000-06/msg00688.html">http://cygwin.com/ml/cygwin/2000-06/msg00688.html</ulink> and related messages.)</emphasis>
</para>
<para>You must execute the following sequence of five commands, in this
order:
</para>
<screen>
$(LD) -s --base-file BASEFILE --dll -o DLLNAME OBJS LIBS -e ENTRY
$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE \
--base-file BASEFILE --output-exp EXPFILE
$(LD) -s --base-file BASEFILE EXPFILE -dll -o DLLNAME OBJS LIBS -e ENTRY
$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE \
--base-file BASEFILE --output-exp EXPFILE
$(LD) EXPFILE --dll -o DLLNAME OBJS LIBS -e ENTRY
</screen>
<para>In this example, $(LD) is the linker, ld.
</para>
<para>$(DLLTOOL) is dlltool.
</para>
<para>$(AS) is the assembler, as.
</para>
<para>DLLNAME is the name of the DLL you want to create, e.g., tcl80.dll.
</para>
<para>OBJS is the list of object files you want to put into the DLL.
</para>
<para>LIBS is the list of libraries you want to link the DLL against. For
example, you may or may not want -lcygwin. You may want -lkernel32.
</para>
<para>DEFFILE is the name of your definitions file. A simple DEFFILE would
consist of ``EXPORTS'' followed by a list of all symbols which should
be exported from the DLL. Each symbol should be on a line by itself.
Other programs will only be able to access the listed symbols.
</para>
<para>BASEFILE is a temporary file that is used during this five stage
process, e.g., tcl.base.
</para>
<para>EXPFILE is another temporary file, e.g., tcl.exp.
</para>
<para>ENTRY is the name of the function which you want to use as the entry
point. This function should be defined using the WINAPI attribute,
and should take three arguments:
int WINAPI startup (HINSTANCE, DWORD, LPVOID)
</para>
<para>This means that the actual symbol name will have an appended @12, so if
your entry point really is named <literal>startup</literal>, the string you should
use for ENTRY in the above examples would be <literal>startup@12</literal>.
</para>
<para>If your DLL calls any Cygwin API functions, the entry function will need
to initialize the Cygwin impure pointer. You can do that by declaring
a global variable <literal>_impure_ptr</literal>, and then initializing it in the
entry function. Be careful not to export the global variable
<literal>_impure_ptr</literal> from your DLL; that is, do not put it in DEFFILE.
</para>
<screen>
/* This is a global variable. */
struct _reent *_impure_ptr;
extern struct _reent *__imp_reent_data;
int entry (HINSTANT hinst, DWORD reason, LPVOID reserved)
{
_impure_ptr = __imp_reent_data;
/* Whatever else you want to do. */
}
</screen>
<para>You may put an optional `--subsystem windows' on the $(LD) lines.
Note that if you specify a --subsytem &lt;x&gt; flag to ld,
the -e entry must come after the subsystem flag, since the subsystem flag
sets a different default entry point.
</para>
<para>You may put an optional `--image-base BASEADDR' on the $(LD) lines.
This will set the default image base. Programs using this DLL will
start up a bit faster if each DLL occupies a different portion of the
address space. Each DLL starts at the image base, and continues for
whatever size it occupies.
</para>
<para>Now that you've built your DLL, you may want to build a library so
that other programs can link against it. This is not required: you
could always use the DLL via LoadLibrary. However, if you want to be
able to link directly against the DLL, you need to create a library.
Do that like this:
</para>
<para>$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE --output-lib LIBFILE
</para>
<para>$(DLLTOOL), $(AS), DLLNAME, and DEFFILE are the same as above. Make
sure you use the same DLLNAME and DEFFILE, or things won't work right.
</para>
<para>LIBFILE is the name of the library you want to create, e.g.,
libtcl80.a. You can then link against that library using something
like -ltcl80 in your linker command.
</para>
</answer></qandaentry>
<qandaentry id="faq.programming.debug"> <qandaentry id="faq.programming.debug">
<question><para>How can I debug what's going on?</para></question> <question><para>How can I debug what's going on?</para></question>
<answer> <answer>

27
winsup/doc/faq-resources.xml
View File

@ -24,20 +24,19 @@ their documentation in <literal>/usr/doc/</literal>
instead of <literal>/usr/share/doc/</literal>. instead of <literal>/usr/share/doc/</literal>.
</para> </para>
<para>There are links to quite a lot of documentation on the main Cygwin <para>There are links to quite a lot of documentation on the main Cygwin
project web page, <ulink url="http://cygwin.com/">http://cygwin.com/</ulink>, project web page, <ulink url="https://cygwin.com/"/>, including this FAQ.
including this FAQ. Be sure to at least read any 'Release Notes' or 'Readme' Be sure to at least read any 'Release Notes' or 'Readme' or 'read this'
or 'read this' links on the main web page, if there are any. links on the main web page, if there are any.
</para> </para>
<para>There is a comprehensive Cygwin User's Guide at <ulink <para>There is a comprehensive Cygwin User's Guide at
url="http://cygwin.com/cygwin-ug-net/cygwin-ug-net.html">http://cygwin.com/cygwin-ug-net/cygwin-ug-net.html</ulink> <ulink url="https://cygwin.com/cygwin-ug-net/cygwin-ug-net.html"/>
and an API Reference at <ulink and an API Reference at
url="http://cygwin.com/cygwin-api/cygwin-api.html">http://cygwin.com/cygwin-api/cygwin-api.html</ulink>. <ulink url="https://cygwin.com/cygwin-api/cygwin-api.html"/>.
</para> </para>
<para>You can find documentation for the individual GNU tools at <ulink <para>You can find documentation for the individual GNU tools at
url="http://www.fsf.org/manual/">http://www.fsf.org/manual/</ulink>. (You <ulink url="http://www.fsf.org/manual/"/>. (You should read GNU manuals from
should read GNU manuals from a local mirror, check <ulink a local mirror, check
url="http://www.fsf.org/server/list-mirrors.html">http://www.fsf.org/server/list-mirrors.html</ulink> <ulink url="http://www.fsf.org/server/list-mirrors.html"/> for a list of them.)
for a list of them.)
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -45,14 +44,14 @@ for a list of them.)
<question><para>What Cygwin mailing lists can I join?</para></question> <question><para>What Cygwin mailing lists can I join?</para></question>
<answer> <answer>
<para>Comprehensive information about the Cygwin mailing lists can be found at <para>Comprehensive information about the Cygwin mailing lists can be found at
<ulink url="http://cygwin.com/lists.html" />. <ulink url="https://cygwin.com/lists.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.resources.problems"> <qandaentry id="faq.resources.problems">
<question><para>What if I have a problem? (Or: Why won't you/the mailing list answer my questions?)</para></question> <question><para>What if I have a problem? (Or: Why won't you/the mailing list answer my questions?)</para></question>
<answer> <answer>
<para>Comprehensive information about reporting problems with Cygwin can be found at <ulink url="http://cygwin.com/problems.html" />. <para>Comprehensive information about reporting problems with Cygwin can be found at <ulink url="https://cygwin.com/problems.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
</qandadiv> </qandadiv>

83
winsup/doc/faq-setup.xml
View File

@ -15,16 +15,16 @@ installer <command>setup-*.exe</command>. It is flexible and easy to use.
You can pick and choose the packages you wish to install, and update You can pick and choose the packages you wish to install, and update
them individually. Full source code is available for all packages and them individually. Full source code is available for all packages and
tools. More information on using Cygwin Setup may be found at tools. More information on using Cygwin Setup may be found at
<ulink url="http://cygwin.com/cygwin-ug-net/setup-net.html" />. <ulink url="https://cygwin.com/cygwin-ug-net/setup-net.html"/>.
</para> </para>
<para>If you do it any other way, you're on your own! <para>If you do it any other way, you're on your own!
If something doesn't work right for you, and If something doesn't work right for you, and
it's not covered here or in the latest development snapshot at it's not covered here or in the latest development snapshot at
<ulink url="http://cygwin.com/snapshots/">http://cygwin.com/snapshots/</ulink>, then by all means report it to the <ulink url="https://cygwin.com/snapshots/"/>, then by all means report it to the
mailing list. mailing list.
</para> </para>
<para>For a searchable list of packages that can be installed with Cygwin, <para>For a searchable list of packages that can be installed with Cygwin,
see <ulink url="http://cygwin.com/packages/">http://cygwin.com/packages/</ulink>. see <ulink url="https://cygwin.com/packages/"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -143,10 +143,10 @@ now.)
<para>Cygwin Setup can be used to install any packages that are on a <para>Cygwin Setup can be used to install any packages that are on a
Cygwin mirror, which usually includes one version previous to the Cygwin mirror, which usually includes one version previous to the
current one. The complete list may be searched at current one. The complete list may be searched at
<ulink url="http://cygwin.com/packages/">http://cygwin.com/packages/</ulink>. There is no complete archive of <ulink url="https://cygwin.com/packages/"/>. There is no complete archive of
older packages. If you have a problem with the current version of older packages. If you have a problem with the current version of
a Cygwin package, please report it to the mailing list using the a Cygwin package, please report it to the mailing list using the
guidelines at <ulink url="http://cygwin.com/problems.html">http://cygwin.com/problems.html</ulink>. guidelines at <ulink url="https://cygwin.com/problems.html"/>.
</para> </para>
<para>That said, if you really need an older package, you may be able to find <para>That said, if you really need an older package, you may be able to find
an outdated or archival mirror by searching the web for an old package an outdated or archival mirror by searching the web for an old package
@ -199,7 +199,7 @@ disk if you are paranoid.
<para>This should be safe, but only if Cygwin Setup is not substituted by <para>This should be safe, but only if Cygwin Setup is not substituted by
something malicious, and no mirror has been compromised. something malicious, and no mirror has been compromised.
</para> </para>
<para>See also <ulink url="http://cygwin.com/faq/faq.html#faq.using.bloda" /> <para>See also <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda"/>
for a list of applications that have been known, at one time or another, to for a list of applications that have been known, at one time or another, to
interfere with the normal functioning of Cygwin. interfere with the normal functioning of Cygwin.
</para> </para>
@ -211,10 +211,10 @@ interfere with the normal functioning of Cygwin.
<para>When using Cygwin Setup for the first time, the default is to install <para>When using Cygwin Setup for the first time, the default is to install
a minimal subset of all available packages. If you want anything beyond that, a minimal subset of all available packages. If you want anything beyond that,
you will have to select it explicitly. See you will have to select it explicitly. See
<ulink url="http://cygwin.com/packages/" /> for a searchable list of available <ulink url="https://cygwin.com/packages/"/> for a searchable list of available
packages, or use <literal>cygcheck -p </literal> as described in the Cygwin packages, or use <literal>cygcheck -p </literal> as described in the Cygwin
User's Guide at User's Guide at
<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html#cygcheck" />. <ulink url="https://cygwin.com/cygwin-ug-net/using-utils.html#cygcheck"/>.
</para> </para>
<para>If you want to build programs, of course you'll need <literal>gcc</literal>, <para>If you want to build programs, of course you'll need <literal>gcc</literal>,
<literal>binutils</literal>, <literal>make</literal> and probably other packages from the <literal>binutils</literal>, <literal>make</literal> and probably other packages from the
@ -316,11 +316,11 @@ prior actions is in <literal>/var/log/setup.log</literal>.
<answer> <answer>
<para>First, make sure that you are using the latest version of Cygwin Setup. <para>First, make sure that you are using the latest version of Cygwin Setup.
The latest version is always available from the Cygwin Home Page at <ulink The latest version is always available from the Cygwin Home Page at
url="http://cygwin.com/">http://cygwin.com/</ulink>. </para> <ulink url="https://cygwin.com/"/>.
</para>
<para>If you are downloading from the Internet, setup will fail if it cannot <para>If you are downloading from the Internet, setup will fail if it cannot
download the list of mirrors at <ulink download the list of mirrors at <ulink url="https://cygwin.com/mirrors.html"/>.
url="http://cygwin.com/mirrors.html">http://cygwin.com/mirrors.html</ulink>.
It could be that the network is too busy. Something similar could be the It could be that the network is too busy. Something similar could be the
cause of a download site not working. Try another mirror, or try again cause of a download site not working. Try another mirror, or try again
later. later.
@ -356,13 +356,13 @@ you are much better off if you can avoid the problem entirely.
</para> </para>
<para>You have two choices: <para>You have two choices:
</para><orderedlist> </para><orderedlist>
<listitem><para>You can rename the user in the Windows User Manager GUI and then <listitem><para>You can rename the user in the Windows User Manager GUI.
run mkpasswd.
</para> </para>
</listitem> </listitem>
<listitem><para>If you already have an /etc/passwd file, you can simply edit <listitem><para>If that's not possible, you can create an /etc/passwd file
your Cygwin user name (first field). It's also a good idea to avoid spaces in using the <command>mkpasswd</command> command. Then you can simply edit your
the home directory. Cygwin user name (first field). It's also a good idea to avoid spaces in the
home directory.
</para> </para>
</listitem> </listitem>
</orderedlist> </orderedlist>
@ -373,30 +373,33 @@ the home directory.
<question><para>My <literal>HOME</literal> environment variable is not what I want.</para></question> <question><para>My <literal>HOME</literal> environment variable is not what I want.</para></question>
<answer> <answer>
<para>When starting Cygwin from Windows, <literal>HOME</literal> is determined as follows <para>When starting Cygwin from Windows, <literal>HOME</literal> is determined
in order of decreasing priority: as follows:
</para> </para>
<orderedlist> <orderedlist>
<listitem><para><literal>HOME</literal> from the Windows environment, translated to POSIX form. <listitem><para>If <literal>HOME</literal> is set in the Windows environment,
translated to POSIX form.
</para> </para>
</listitem> </listitem>
<listitem><para>The pw_home field from the passwd entry as returned by <command>getent passwd</command>. <listitem><para>Otherwise, use the pw_home field from the passwd entry as
</para> returned by <command>getent passwd</command>. If you want to learn how this
</listitem> field is set by Cygwin and how you can change it, this is explained in great
<listitem><para>/home/USERNAME detail in the Cygwin User's Guide at
<ulink url="https://cygwin.com/cygwin-ug-net/ntsec.html"/>.
</para> </para>
</listitem> </listitem>
</orderedlist> </orderedlist>
<para>When using Cygwin from the network (telnet, ssh,...), <literal>HOME</literal> is taken from the passwd entry. <para>When using Cygwin from a network login (via ssh for instance),
<literal>HOME</literal> is always taken from the passwd entry.
</para> </para>
<para>If your <literal>HOME</literal> is set to a value such as /cygdrive/c, it is likely <para>If your <literal>HOME</literal> is set to a value such as /cygdrive/c,
that it was set in Windows. Start a DOS Command Window and type it is likely that it was set in Windows. Start a DOS Command Window and type
"set HOME" to verify if this is the case. "set HOME" to verify if this is the case.
</para> </para>
<para>Access to shared drives is often restricted when starting from the network, <para>Access to shared drives is often restricted when starting from the
thus Domain users may wish to have a different <literal>HOME</literal> in the network, thus Domain users may wish to have a different <literal>HOME</literal>
Windows environment (on shared drive) than in Cygwin (on local drive). in the Windows environment (on shared drive) than in Cygwin (on local drive).
Note that ssh only considers the account information as retrieved by Note that ssh only considers the account information as retrieved by
getpwnam(3), disregarding <literal>HOME</literal>. getpwnam(3), disregarding <literal>HOME</literal>.
</para> </para>
@ -443,7 +446,7 @@ of Cygwin is as follows:
<orderedlist> <orderedlist>
<listitem><para>If you have any Cygwin services running, remove by repeating <listitem><para>If you have any Cygwin services running, remove by repeating
the instructions in <ulink the instructions in <ulink
url="http://cygwin.com/faq/faq.html#faq.setup.uninstall-service" /> for url="https://cygwin.com/faq/faq.html#faq.setup.uninstall-service"/> for
all services that you installed. Common services that might have been all services that you installed. Common services that might have been
installed are <literal>sshd</literal>, <literal>cron</literal>, installed are <literal>sshd</literal>, <literal>cron</literal>,
<literal>cygserver</literal>, <literal>inetd</literal>, <literal>apache</literal>, <literal>cygserver</literal>, <literal>inetd</literal>, <literal>apache</literal>,
@ -454,12 +457,12 @@ installed are <literal>sshd</literal>, <literal>cron</literal>,
that might be running in the background. Exit the command prompt and ensure that might be running in the background. Exit the command prompt and ensure
that no Cygwin processes remain. Note: If you want to save your mount points for a later that no Cygwin processes remain. Note: If you want to save your mount points for a later
reinstall, first save the output of <literal>mount -m</literal> as described at reinstall, first save the output of <literal>mount -m</literal> as described at
<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html#mount" />. <ulink url="https://cygwin.com/cygwin-ug-net/using-utils.html#mount"/>.
</para> </para>
</listitem> </listitem>
<listitem><para>If you installed <literal>cyglsa.dll</literal> by running the <listitem><para>If you installed <literal>cyglsa.dll</literal> by running the
shell script <literal>/usr/bin/cyglsa-config</literal> as described in shell script <literal>/usr/bin/cyglsa-config</literal> as described in
<ulink url="http://cygwin.com/cygwin-ug-net/ntsec.html" />, then you need to <ulink url="https://cygwin.com/cygwin-ug-net/ntsec.html"/>, then you need to
configure Windows to stop using the LSA authentication package. You do so by configure Windows to stop using the LSA authentication package. You do so by
editing the registry and restoring editing the registry and restoring
<literal>/HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/Lsa/Authentication Packages</literal> <literal>/HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/Lsa/Authentication Packages</literal>
@ -522,7 +525,7 @@ problems, or at the request of a Cygwin developer.
<para>You cannot use Cygwin Setup to install a snapshot. <para>You cannot use Cygwin Setup to install a snapshot.
</para> </para>
<para>First, you will need to download the snapshot from the snapshots <para>First, you will need to download the snapshot from the snapshots
page at <ulink url="http://cygwin.com/snapshots/">http://cygwin.com/snapshots/</ulink>. Note the directory where page at <ulink url="https://cygwin.com/snapshots/"/>. Note the directory where
you saved the snapshot tarball. you saved the snapshot tarball.
</para> </para>
<para>Before installing a snapshot, you must first Close <emphasis role='bold'>all</emphasis> Cygwin <para>Before installing a snapshot, you must first Close <emphasis role='bold'>all</emphasis> Cygwin
@ -552,7 +555,7 @@ to <literal>C:\cygwin\bin\cygwin1.dll</literal> (assuming you installed Cygwin i
<para>The operative word in trying the snapshots is "<emphasis>trying</emphasis>". If you <para>The operative word in trying the snapshots is "<emphasis>trying</emphasis>". If you
notice a problem with the snapshot that was not present in the release notice a problem with the snapshot that was not present in the release
DLL (what we call a "regression"), please report it to the Cygwin DLL (what we call a "regression"), please report it to the Cygwin
mailing list (see <ulink url="http://cygwin.com/problems.html">http://cygwin.com/problems.html</ulink> for problem mailing list (see <ulink url="https://cygwin.com/problems.html"/> for problem
reporting guidelines). If you wish to go back to the older version of the reporting guidelines). If you wish to go back to the older version of the
DLL, again, close all Cygwin processes, delete DLL, again, close all Cygwin processes, delete
<literal>C:\cygwin\bin\cygwin1.dll</literal>, and <literal>C:\cygwin\bin\cygwin1.dll</literal>, and
@ -569,11 +572,11 @@ files, reinstall the "<literal>cygwin</literal>" package using Setup.
<answer> <answer>
<para>NO. Cygwin Setup cannot do this for you. Use a tool designed for <para>NO. Cygwin Setup cannot do this for you. Use a tool designed for
this purpose. See <ulink url="http://rsync.samba.org/">http://rsync.samba.org/</ulink>, this purpose. See <ulink url="http://rsync.samba.org/"/>,
<ulink url="http://www.gnu.org/software/wget/">http://www.gnu.org/software/wget/</ulink> for utilities that can do this for you. <ulink url="http://www.gnu.org/software/wget/"/> for utilities that can do this for you.
For more information on setting up a custom Cygwin package server, see For more information on setting up a custom Cygwin package server, see
the Cygwin Setup homepage at the Cygwin Setup homepage at
<ulink url="http://sourceware.org/cygwin-apps/setup.html">http://sourceware.org/cygwin-apps/setup.html</ulink>. <ulink url="https://sourceware.org/cygwin-apps/setup.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -582,10 +585,10 @@ the Cygwin Setup homepage at
<answer> <answer>
<para>While some users have successfully done this, for example Indiana <para>While some users have successfully done this, for example Indiana
University's XLiveCD <ulink url="http://xlivecd.indiana.edu/">http://xlivecd.indiana.edu/</ulink>, there is no University's XLiveCD <ulink url="http://xlivecd.indiana.edu/"/>, there is no
easy way to do it. Full instructions for constructing a portable Cygwin easy way to do it. Full instructions for constructing a portable Cygwin
on CD by hand can be found on the mailing list at on CD by hand can be found on the mailing list at
<ulink url="http://www.cygwin.com/ml/cygwin/2003-07/msg01117.html">http://www.cygwin.com/ml/cygwin/2003-07/msg01117.html</ulink> <ulink url="https://www.cygwin.com/ml/cygwin/2003-07/msg01117.html"/>
(Thanks to fergus at bonhard dot uklinux dot net for these instructions.) (Thanks to fergus at bonhard dot uklinux dot net for these instructions.)
Please note that these instructions are rather old and are referring to the Please note that these instructions are rather old and are referring to the
somewhat different setup of a Cygwin 1.5.x release. As soon as somebody set somewhat different setup of a Cygwin 1.5.x release. As soon as somebody set

171
winsup/doc/faq-using.xml
View File

@ -25,7 +25,7 @@ installed. Scroll down to locate the missing package, for instance
</para> </para>
<para>For a detailed explanation of the general problem, and how to extend <para>For a detailed explanation of the general problem, and how to extend
it to other missing DLLs and identify their containing packages, see it to other missing DLLs and identify their containing packages, see
<ulink url="http://cygwin.com/ml/cygwin/2002-01/msg01619.html">http://cygwin.com/ml/cygwin/2002-01/msg01619.html</ulink>. <ulink url="https://cygwin.com/ml/cygwin/2002-01/msg01619.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -50,7 +50,7 @@ will slow things down tremendously if it does not exist.
(sshd, inetd, etc), then it depends on the method used to switch to (sshd, inetd, etc), then it depends on the method used to switch to
another user. This problem as well as its solution is described in another user. This problem as well as its solution is described in
detail in the Cygwin User's Guide, see detail in the Cygwin User's Guide, see
<ulink url="http://cygwin.com/cygwin-ug-net/ntsec.html" />. <ulink url="https://cygwin.com/cygwin-ug-net/ntsec.html"/>.
</para> </para>
<para>Workarounds include using public network share that does not require <para>Workarounds include using public network share that does not require
authentication (for non-critical files), providing your password to a authentication (for non-critical files), providing your password to a
@ -238,8 +238,9 @@ currently installed as part of the sh-utils, but again, it does not work.
<literal>ssh username@localhost</literal> as a <literal>su</literal> <literal>ssh username@localhost</literal> as a <literal>su</literal>
replacement. replacement.
</para> </para>
<para>For some technical background into why <literal>su</literal> doesn't work, read <para>For some technical background into why <literal>su</literal> doesn't
<ulink url="http://www.cygwin.com/ml/cygwin/2003-06/msg00897.html">http://www.cygwin.com/ml/cygwin/2003-06/msg00897.html</ulink> and work, read
<ulink url="https://www.cygwin.com/ml/cygwin/2003-06/msg00897.html"/> and
related messages. related messages.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -274,7 +275,7 @@ for memory cards or USB sticks to exchange pictures...
<para>For other cases, understand that Cygwin attempts to show UNIX <para>For other cases, understand that Cygwin attempts to show UNIX
permissions based on the security features of Windows, so the Windows permissions based on the security features of Windows, so the Windows
ACLs are likely the source of your problem. See the Cygwin User's ACLs are likely the source of your problem. See the Cygwin User's
Guide at <ulink url="http://cygwin.com/cygwin-ug-net/ntsec.html" /> Guide at <ulink url="https://cygwin.com/cygwin-ug-net/ntsec.html"/>
for more information on how Cygwin maps Windows permissions. for more information on how Cygwin maps Windows permissions.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -326,25 +327,26 @@ to determine whether they are executable.
<question><para>How do I print under Cygwin?</para></question> <question><para>How do I print under Cygwin?</para></question>
<answer> <answer>
<para>lpr is available in the cygutils package. Some <ulink url="http://cygwin.com/ml/cygwin/2008-05/msg00123.html">usage hints</ulink> are available courtesy of Rodrigo Medina. <para>lpr is available in the cygutils package. Some <ulink url="https://cygwin.com/ml/cygwin/2008-05/msg00123.html">usage hints</ulink> are available courtesy of Rodrigo Medina.
</para> </para>
<para>Jason Tishler has written a couple of messages that explain how to use <para>Jason Tishler has written a couple of messages that explain how to use
a2ps (for nicely formatted text in PostScript) and ghostscript (to print a2ps (for nicely formatted text in PostScript) and ghostscript (to print
PostScript files on non-PostScript Windows printers). Start at PostScript files on non-PostScript Windows printers). Start at
<ulink url="http://cygwin.com/ml/cygwin/2001-04/msg00657.html">http://cygwin.com/ml/cygwin/2001-04/msg00657.html</ulink>. Note that the <ulink url="https://cygwin.com/ml/cygwin/2001-04/msg00657.html"/>. Note that
<literal>file</literal> command is now available as part of Cygwin setup. these are old mails and <command>a2ps</command> as well as
<command>file</command> are long available as part of the Cygwin distribution.
</para> </para>
<para>Alternatively, you can use the Windows <literal>print</literal> <para>Alternatively, you can use the Windows <command>print</command>
command. (It does not seem to be available on Win9x.) Type command. Type
</para> </para>
<screen> <screen>
bash$ print /\? bash$ print /\?
</screen> </screen>
<para>for usage instructions (note the <literal>?</literal> must be escaped from the <para>for usage instructions (note the <literal>?</literal> must be escaped
shell). from the shell).
</para> </para>
<para>Finally, you can simply <literal>cat</literal> the file to the printer's share name: <para>Finally, you can simply <command>cat</command> the file to the printer's share name:
</para> </para>
<screen> <screen>
bash$ cat myfile &gt; //host/printer bash$ cat myfile &gt; //host/printer
@ -362,7 +364,7 @@ formfeed character to your file.
<para>Internationalization is a complex issue. The short answer is that <para>Internationalization is a complex issue. The short answer is that
Cygwin relies on the setting of the setting of LANG/LC_xxx environment Cygwin relies on the setting of the setting of LANG/LC_xxx environment
variables. The long answer can be found in the User's Guide in the variables. The long answer can be found in the User's Guide in the
section <ulink url="http://cygwin.com/cygwin-ug-net/setup-locale.html">Internationalization</ulink> section <ulink url="https://cygwin.com/cygwin-ug-net/setup-locale.html">Internationalization</ulink>
</para> </para>
<para> Cygwin uses UTF-8 by default. To use a different character set, you <para> Cygwin uses UTF-8 by default. To use a different character set, you
@ -414,7 +416,7 @@ if you have one a single Cygwin installation, for example, if you update the
Cygwin package without exiting <emphasis>all</emphasis> Cygwin apps (including Cygwin package without exiting <emphasis>all</emphasis> Cygwin apps (including
services like sshd) beforehand.</para> services like sshd) beforehand.</para>
<para>The only DLL that is sanctioned by the Cygwin project is the one that <para>The only DLL that is sanctioned by the Cygwin project is the one that
you get by running <ulink url="http://cygwin.com/install.html">setup.exe</ulink>, you get by running <ulink url="https://cygwin.com/install.html">setup-x86.exe or setup-x86_64.exe</ulink>,
installed in a directory controlled by this program. If you have other installed in a directory controlled by this program. If you have other
versions on your system and desire help from the cygwin project, you should versions on your system and desire help from the cygwin project, you should
delete or rename all DLLs that are not installed by delete or rename all DLLs that are not installed by
@ -450,7 +452,7 @@ Can I bundle Cygwin with my product for free?
</para></question> </para></question>
<answer><para> <answer><para>
Only if you comply with Cygwin's <ulink Only if you comply with Cygwin's <ulink
url="http://cygwin.com/licensing.html">license</ulink> very carefully. If you url="https://cygwin.com/licensing.html">license</ulink> very carefully. If you
choose to distribute cygwin1.dll, you must be willing to distribute the choose to distribute cygwin1.dll, you must be willing to distribute the
exact source code used to build that copy of cygwin1.dll as per the exact source code used to build that copy of cygwin1.dll as per the
terms of the GPL. If you ship applications that link with cygwin1.dll, terms of the GPL. If you ship applications that link with cygwin1.dll,
@ -485,7 +487,7 @@ installed distribution.
<para>Probably because there is nobody willing or able to maintain it. It <para>Probably because there is nobody willing or able to maintain it. It
takes time, and the priority for the Cygwin Team is the Cygwin package. takes time, and the priority for the Cygwin Team is the Cygwin package.
The rest is a volunteer effort. Want to contribute? See The rest is a volunteer effort. Want to contribute? See
<ulink url="http://cygwin.com/setup.html">http://cygwin.com/setup.html</ulink>. <ulink url="https://cygwin.com/setup.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -569,7 +571,7 @@ of your current Cygwin session.
</para> </para>
<para>You can change the default <literal>cygdrive</literal> prefix and whether it is binmode or textmode using the <filename>/etc/fstab</filename> file <para>You can change the default <literal>cygdrive</literal> prefix and whether it is binmode or textmode using the <filename>/etc/fstab</filename> file
as well. See the Cygwin User's Guide at as well. See the Cygwin User's Guide at
<ulink url="http://cygwin.com/cygwin-ug-net/using.html#mount-table">http://cygwin.com/cygwin-ug-net/using.html#mount-table</ulink> <ulink url="https://cygwin.com/cygwin-ug-net/using.html#mount-table"/>
for more details. for more details.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -618,7 +620,7 @@ of poorly written firewall-type software that causes things to break.
Note that with many of these products, simply disabling the firewall Note that with many of these products, simply disabling the firewall
does not remove these changes; it must be completely uninstalled. does not remove these changes; it must be completely uninstalled.
</para> </para>
<para>See also <ulink url="http://cygwin.com/faq/faq.html#faq.using.bloda" /> <para>See also <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda"/>
for a list of applications that have been known, at one time or another, to for a list of applications that have been known, at one time or another, to
interfere with the normal functioning of Cygwin. interfere with the normal functioning of Cygwin.
</para> </para>
@ -652,7 +654,7 @@ configuration fails.
<para>To help with this problem, Cygwin supports case sensitivity <para>To help with this problem, Cygwin supports case sensitivity
starting with Cygwin 1.7.0. For a detailed description how to use that starting with Cygwin 1.7.0. For a detailed description how to use that
feature see the Cygwin User's Guilde at feature see the Cygwin User's Guilde at
<ulink url="http://cygwin.com/cygwin-ug-net/using-specialnames.html">http://cygwin.com/cygwin-ug-net/using-specialnames.html</ulink>. <ulink url="https://cygwin.com/cygwin-ug-net/using-specialnames.html"/>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -672,7 +674,7 @@ letters 'aux' in it will hang.
<para>At least that's what happens when using native Windows tools. Cygwin <para>At least that's what happens when using native Windows tools. Cygwin
1.7.0 and later can deal with these filenames just fine. Again, see the 1.7.0 and later can deal with these filenames just fine. Again, see the
User's Guide at User's Guide at
<ulink url="http://cygwin.com/cygwin-ug-net/using-specialnames.html">http://cygwin.com/cygwin-ug-net/using-specialnames.html</ulink> <ulink url="https://cygwin.com/cygwin-ug-net/using-specialnames.html"/>
for a detailed description of what's possible with filenames and what is not. for a detailed description of what's possible with filenames and what is not.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -768,7 +770,7 @@ contents are exempt from scanning. In a default installation, this
would be <literal>C:\cygwin\bin</literal>. Obviously, this could be would be <literal>C:\cygwin\bin</literal>. Obviously, this could be
exploited by a hostile non-Cygwin program, so do this at your own risk. exploited by a hostile non-Cygwin program, so do this at your own risk.
</para> </para>
<para>See also <ulink url="http://cygwin.com/faq/faq.html#faq.using.bloda" /> <para>See also <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda"/>
for a list of applications that have been known, at one time or another, to for a list of applications that have been known, at one time or another, to
interfere with the normal functioning of Cygwin. interfere with the normal functioning of Cygwin.
</para> </para>
@ -781,7 +783,7 @@ interfere with the normal functioning of Cygwin.
<para>Yes. Install the emacs package. This provides everything you <para>Yes. Install the emacs package. This provides everything you
need in order to run GNU emacs in a terminal window. If you also want need in order to run GNU emacs in a terminal window. If you also want
to be able to use the X11 to be able to use the X11
(<ulink url="http://x.cygwin.com/">http://x.cygwin.com/</ulink>) (<ulink url="https://x.cygwin.com/"/>)
GUI, install the emacs-X11 package. In either case, you run emacs by GUI, install the emacs-X11 package. In either case, you run emacs by
typing 'emacs' or '/usr/bin/emacs'. typing 'emacs' or '/usr/bin/emacs'.
</para> </para>
@ -793,7 +795,7 @@ typing 'emacs' or '/usr/bin/emacs'.
<para>Yes. It can be used in three different modes:</para> <para>Yes. It can be used in three different modes:</para>
<para><itemizedlist> <para><itemizedlist>
<listitem><para>X11 (<ulink url="http://x.cygwin.com/">http://x.cygwin.com/</ulink>) GUI</para></listitem> <listitem><para>X11 (<ulink url="https://x.cygwin.com/"/>) GUI</para></listitem>
</itemizedlist></para> </itemizedlist></para>
<para>You have to <emphasis>set</emphasis> the DISPLAY environment variable <para>You have to <emphasis>set</emphasis> the DISPLAY environment variable
before starting xemacs.</para> before starting xemacs.</para>
@ -815,127 +817,12 @@ before starting xemacs.</para>
<screen> <screen>
bash$ xemacs -nw bash$ xemacs -nw
</screen> </screen>
<para>The current stable Cygwin version of XEmacs is 21.4.x. But there is also a
Cygwin test release version (21.5.x) available for download via setup.exe.
</para>
<para>To use all the standard packages with XEmacs you should download the following <para>To use all the standard packages with XEmacs you should download the following
two packages:</para> two packages:</para>
<para><itemizedlist> <para><itemizedlist>
<listitem><para>xemacs-sumo - XEmacs standard packages</para></listitem> <listitem><para>xemacs-sumo - XEmacs standard packages</para></listitem>
<listitem><para>xemacs-mule-sumo - XEmacs MULE (MUlti Lingual Emacs) packages</para></listitem> <listitem><para>xemacs-mule-sumo - XEmacs MULE (MUlti Lingual Emacs) packages</para></listitem>
</itemizedlist></para> </itemizedlist></para>
<para>An alternative <emphasis>native</emphasis> distribution of XEmacs for
Windows based systems can be downloaded from
<ulink url="http://xemacs.org/Download/win32/index.html">http://xemacs.org/Download/win32/index.html</ulink>.
It uses an <emphasis>InnoSetup Kit</emphasis> based installer.</para>
</answer></qandaentry>
<qandaentry id="faq.using.ntemacs">
<question><para>What about NT Emacs?</para></question>
<answer>
<para>If you want GNU Emacs with a native Microsoft GUI interface,
then you can either use XEmacs (see above), or native
NT Emacs: see section
<ulink url="http://www.gnu.org/software/emacs/windows/Getting-Emacs.html#Getting-Emacs">Where can I get pre-compiled versions?</ulink> in NT Emacs FAQ.
</para>
<para>NT Emacs uses the Windows command shell by default. Since it is not a
Cygwin application, it has no knowledge of Cygwin mounts. With those
points in mind, you need to add the following code to your ~/.emacs
(or ~/_emacs) file in order to use Cygwin bash. This is particularly useful
for the JDEE package (<ulink url="http://jdee.sunsite.dk/">http://jdee.sunsite.dk/</ulink>). The following
settings are for Emacs 21.1:
</para>
<screen>
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Initial setup
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; This assumes that Cygwin is installed in C:\cygwin (the
;; default) and that C:\cygwin\bin is not already in your
;; Windows Path (it generally should not be).
(setq exec-path (cons "C:/cygwin/bin" exec-path))
(setenv "PATH" (concat "C:\\cygwin\\bin;" (getenv "PATH")))
;; LOGNAME and USER are expected in many Emacs packages
;; Check these environment variables.
(if (and (null (getenv "USER"))
;; Windows includes variable USERNAME, which is copied to
;; LOGNAME and USER respectively.
(getenv "USERNAME"))
(setenv "USER" (getenv "USERNAME")))
(if (and (getenv "LOGNAME")
;; Bash shell defines only LOGNAME
(null (getenv "USER")))
(setenv "USER" (getenv "LOGNAME")))
(if (and (getenv "USER")
(null (getenv "LOGNAME")))
(setenv "LOGNAME" (getenv "USER")))
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; (A) M-x shell: This change M-x shell permanently
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Would call Windows command interpreter. Change it.
(setq shell-file-name "bash")
(setenv "SHELL" shell-file-name)
(setq explicit-shell-file-name shell-file-name)
;; Remove C-m (^M) characters that appear in output
(add-hook 'comint-output-filter-functions
'comint-strip-ctrl-m)
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; (B) *OR* call following function with M-x my-bash
;; The M-x shell would continue to run standard Windows shell
;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
(defun my-bash (&amp;optional buffer)
"Run Cygwin Bash shell in optional BUFFER; default *shell-bash*."
(autoload 'comint-check-proc "comint")
(interactive
(let ((name "*shell-bash*"))
(if current-prefix-arg
(setq name (read-string
(format "Cygwin shell buffer (default %s): " name)
(not 'initial-input)
(not 'history)
name)))
(list name)))
(or buffer
(setq buffer "*shell-bash*"))
(if (comint-check-proc buffer)
(pop-to-buffer buffer)
(let* ((shell-file-name "bash")
(explicit-shell-file-name shell-file-name)
(explicit-sh-args '("--login" "-i"))
(explicit-bash-args explicit-sh-args)
(w32-quote-process-args ?\"));; Use Cygwin quoting rules.
(shell buffer)
;; By default Emacs sends "\r\n", but bash wants plain "\n"
(set-buffer-process-coding-system 'undecided-dos 'undecided-unix)
;; With TAB completion, add slash path separator, none to filenames
(make-local-variable 'comint-completion-addsuffix)
(setq comint-completion-addsuffix '("/" . ""))
;; This variable is local to buffer
(setq comint-prompt-regexp "^[ \n\t]*[$] ?"))))
</screen>
<para>If you want NT Emacs to understand Cygwin paths, get
cygwin-mount.el from <ulink url="http://www.emacswiki.org/elisp/index.html">http://www.emacswiki.org/elisp/index.html</ulink>.
</para>
<para>Note that all of this ``just works'' if you use the Cygwin port of
Emacs or XEmacs from Cygwin Setup.
</para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.using.symlinkstoppedworking"> <qandaentry id="faq.using.symlinkstoppedworking">
@ -974,7 +861,7 @@ file:
</para> </para>
<para>Alternatively, use Windows shortcuts as symlinks. See the CYGWIN <para>Alternatively, use Windows shortcuts as symlinks. See the CYGWIN
environment variable option "winsymlinks" environment variable option "winsymlinks"
<ulink url="http://cygwin.com/cygwin-ug-net/using-cygwinenv.html">http://cygwin.com/cygwin-ug-net/using-cygwinenv.html</ulink> <ulink url="https://cygwin.com/cygwin-ug-net/using-cygwinenv.html"/>
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -1065,7 +952,7 @@ such as this when trying to start a Tk app:</para>
<para>Then you need to start an X server, or if one is already running, set the <para>Then you need to start an X server, or if one is already running, set the
<literal>DISPLAY</literal> variable to the proper value. The Cygwin distribution <literal>DISPLAY</literal> variable to the proper value. The Cygwin distribution
includes an X server; please see the <ulink url="http://x.cygwin.com/docs/ug/cygwin-x-ug.html">Cygwin/X User Guide</ulink> includes an X server; please see the <ulink url="https://x.cygwin.com/docs/ug/cygwin-x-ug.html">Cygwin/X User Guide</ulink>
for installation and startup instructions. for installation and startup instructions.
</para></answer></qandaentry> </para></answer></qandaentry>
@ -1223,7 +1110,7 @@ such as virtual memory paging and file caching.</para>
ones undoes the effects of rebaseall and often causes fork() failures ones undoes the effects of rebaseall and often causes fork() failures
to reappear. If so, just run rebaseall again. to reappear. If so, just run rebaseall again.
</para> </para>
<para>See the <ulink url="http://cygwin.com/cygwin-ug-net/highlights.html#ov-hi-process"> <para>See the <ulink url="https://cygwin.com/cygwin-ug-net/highlights.html#ov-hi-process">
process creation</ulink> section of the User's Guide for the technical reasons it is so process creation</ulink> section of the User's Guide for the technical reasons it is so
difficult to make <literal>fork()</literal> work reliably.</para> difficult to make <literal>fork()</literal> work reliably.</para>
</answer> </answer>

98
winsup/doc/faq-what.xml
View File

@ -10,22 +10,19 @@
<question><para>What is it?</para></question> <question><para>What is it?</para></question>
<answer> <answer>
<para>The Cygwin tools are ports of the popular GNU development tools for <para>Cygwin is a distribution of popular GNU and other Open Source tools
Microsoft Windows. They run thanks to the Cygwin library which running on Microsoft Windows. The core part is the Cygwin library which
provides the POSIX system calls and environment these programs expect. provides the POSIX system calls and environment these programs expect.
</para> </para>
<para>With these tools installed, it is possible to write Windows console <para>The Cygwin distribution contains thousands of packages from the Open
or GUI applications that make use of significant parts of the POSIX API. Source world including most GNU tools, many BSD tools, an X server and a full
As a result, it is possible to easily port many Unix programs without the need set of X applications. If you're a developer you will find tools, headers
for extensive changes to the source code. This includes configuring and libraries allowing to write Windows console or GUI applications that make
and building most of the available GNU software (including the packages use of significant parts of the POSIX API. Cygwin allows easy porting of many
included with the Cygwin development tools themselves) as well as lots Unix programs without the need for extensive changes to the source code. This
of BSD tools and packages (including OpenSSH). Even if includes configuring and building most of the available GNU or BSD software,
the development tools are of little to no use to you, you may have including the packages included with the Cygwin distribution themselves.
interest in the many standard POSIX utilities provided with the package. They can be used from one of the provided Unix shells like bash, tcsh or zsh.
They can be used from one of the provided Unix shells like bash, tcsh or zsh,
as well as from the standard Windows command shell if you have to for some
sad reason.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -33,17 +30,12 @@ sad reason.
<question><para>What versions of Windows are supported?</para></question> <question><para>What versions of Windows are supported?</para></question>
<answer> <answer>
<para>Cygwin can be expected to run on all modern versions of Windows. <para>Cygwin can be expected to run on all modern, released versions of Windows.
This includes, as of the time of writing this, Windows XP SP3, Windows State January 2015 this includes Windows XP SP3, Windows Server 2003/2003R2
Server 2003, Windows Vista, Windows Server 2008, Windows 7, Windows and all later versions of Windows up to Windows 8.1 and Windows Server 2012R2.
Server 2012, Windows 8. The 32 bit version also runs in the WOW64 32 bit The 32 bit version of Cygwin also runs in the WOW64 32 bit environment on
environment on released 64 bit versions of Windows released 64 bit versions of Windows (XP SP3 up to 8.1/2012R2), the 64 bit
(XP/2003/Vista/2008/7/2008 R2/8/2012). version of course only on 64 bit Windows.
Since Cygwin is a community-supported free software project, patches to
provide support for other versions would be thoughtfully considered.
Paid support contracts or enhancements are available through Red Hat. For
information about getting a Red Hat support contract, see
<ulink url="http://cygwin.com/licensing.html" />.
</para> </para>
<para>Keep in mind that Cygwin can only do as much as the underlying OS <para>Keep in mind that Cygwin can only do as much as the underlying OS
supports. Because of this, Cygwin will behave differently, and supports. Because of this, Cygwin will behave differently, and
@ -55,17 +47,17 @@ exhibit different limitations, on the various versions of Windows.
<question><para>Where can I get it?</para></question> <question><para>Where can I get it?</para></question>
<answer> <answer>
<para>The home page for the Cygwin project is <ulink url="http://cygwin.com/">http://cygwin.com/</ulink>. <para>The home page for the Cygwin project is
<ulink url="https://cygwin.com/"/>.
There you should find everything you need for Cygwin, including links There you should find everything you need for Cygwin, including links
for download and setup, a current list of mirror sites, a User's for download and setup, a current list of mirror sites, a User's
Guide, an API Reference, mailing lists and archives, and additional Guide, an API Reference, mailing lists and archives.
ported software.
</para> </para>
<para>You can find documentation for the individual GNU tools typically <para>You can find documentation for the individual GNU tools typically
as man pages or info pages as part of the Cygwin net distribution. as man pages or info pages as part of the Cygwin net distribution.
Additionally you can get the latest docs at Additionally you can get the latest docs at
<ulink url="http://www.gnu.org/manual/" />. (You should read GNU manuals from a <ulink url="http://www.gnu.org/manual/"/>. (You should read GNU manuals from a
local mirror. Check <ulink url="http://www.gnu.org/server/list-mirrors.html" /> local mirror. Check <ulink url="http://www.gnu.org/server/list-mirrors.html"/>
for a list of them.) for a list of them.)
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -85,7 +77,7 @@ these tools.
<para>In particular, if you intend to port a proprietary (non-GPL'd) <para>In particular, if you intend to port a proprietary (non-GPL'd)
application using Cygwin, you will need the proprietary-use license application using Cygwin, you will need the proprietary-use license
for the Cygwin library. This is available for purchase from Red Hat; for the Cygwin library. This is available for purchase from Red Hat;
please visit <ulink url="http://cygwin.com/licensing.html" /> for more please visit <ulink url="https://cygwin.com/licensing.html"/> for more
information. All other questions should be sent to the public project information. All other questions should be sent to the public project
mailing list cygwin@cygwin.com. mailing list cygwin@cygwin.com.
</para> </para>
@ -103,7 +95,9 @@ freedoms, so it is free software.
<para>To find the version of the Cygwin DLL installed, you can use <para>To find the version of the Cygwin DLL installed, you can use
<filename>uname</filename> as on Linux or <filename>cygcheck</filename>. Refer to each command's <filename>uname</filename> as on Linux or <filename>cygcheck</filename>. Refer to each command's
<literal>--help</literal> output and the <ulink url='http://cygwin.com/cygwin-ug-net/'>Cygwin User's Guide</ulink> for more information. <literal>--help</literal> output and the
<ulink url='https://cygwin.com/cygwin-ug-net/'>Cygwin User's Guide</ulink>
for more information.
</para> </para>
<para>If you are looking for the version number for the whole Cygwin <para>If you are looking for the version number for the whole Cygwin
release, there is none. Each package in the Cygwin release has its own release, there is none. Each package in the Cygwin release has its own
@ -113,10 +107,11 @@ Each package has its own version numbers and its own release process.
</para> </para>
<para>So, how do you get the most up-to-date version of Cygwin? Easy. Just <para>So, how do you get the most up-to-date version of Cygwin? Easy. Just
download the Cygwin Setup program by following the instructions download the Cygwin Setup program by following the instructions
<ulink url='http://cygwin.com/install.html'>here</ulink>. The setup program will handle the task <ulink url='https://cygwin.com/install.html'>here</ulink>.
of updating the packages on your system to the latest version. For The setup program will handle the task of updating the packages on your system
more information about using Cygwin's <filename>setup.exe</filename>, see to the latest version. For more information about using Cygwin's
<ulink url='http://cygwin.com/cygwin-ug-net/setup-net.html'>Setting Up Cygwin</ulink> <filename>setup.exe</filename>, see
<ulink url='https://cygwin.com/cygwin-ug-net/setup-net.html'>Setting Up Cygwin</ulink>
in the Cygwin User's Guide. in the Cygwin User's Guide.
</para></answer></qandaentry> </para></answer></qandaentry>
@ -129,26 +124,29 @@ questions, all of these people will appreciate it if you use the cygwin
mailing lists rather than sending personal email.)</emphasis> mailing lists rather than sending personal email.)</emphasis>
</para> </para>
<para> <para>
Corinna Vinschen (corinna) is the current project lead. Corinna is a Corinna Vinschen is the current project lead. Corinna is a senior Red Hat
senior Red Hat engineer. Corinna is responsible for such important engineer. Corinna is responsible for the Cygwin library and maintains a couple
subsystems as security and networking and has recently added support to of packages, for instance OpenSSH, OpenSSL, and a lot more.
Cygwin for wide characters, increased path length, IPv6, advisory
file locking and more.
</para> </para>
<para> <para>
Yaakov Selkowitz is the Cygwin/X coordinator. Jon Turney serves on the Yaakov Selkowitz is another Red Hat engineer working on the Cygwin project.
Cygwin/X team as a developer. He's the guy behind the current build and packaging system and maintains by
far the most packages in the Cygwin distribution.
</para>
<para>
Jon Turney is developer and maintainer of the Cygwin X server and a couple
of related packages.
</para> </para>
<para> <para>
The packages in the Net release are maintained by a large group of people; The packages in the Net release are maintained by a large group of people;
a complete list can be found <ulink url='http://cygwin.com/cygwin-pkg-maint'>here</ulink>. a complete list can be found
<ulink url='https://cygwin.com/cygwin-pkg-maint'>here</ulink>.
</para> </para>
<para>Please note that all of us working on Cygwin try to <para>Please note that all of us working on Cygwin try to be as responsive as
be as responsive as possible and deal with patches and questions as we possible and deal with patches and questions as we get them, but realistically
get them, but realistically we don't have time to answer all of the we don't have time to answer all of the email that is sent to the main mailing
email that is sent to the main mailing list. Making Net releases of the list. Making Net releases of the Win32 tools and helping people on the Net out
Win32 tools and helping people on the Net out is not our primary job is not our primary job function, so some email will have to go unanswered.
function, so some email will have to go unanswered.
</para> </para>
<para>Many thanks to everyone using the tools for their many contributions in <para>Many thanks to everyone using the tools for their many contributions in
the form of advice, bug reports, and code fixes. Keep them coming! the form of advice, bug reports, and code fixes. Keep them coming!

4
winsup/doc/highlights.xml
View File

@ -49,7 +49,7 @@ The chmod call maps UNIX-style permissions back to the Win32 equivalents.
Because many programs expect to be able to find the Because many programs expect to be able to find the
<filename>/etc/passwd</filename> and <filename>/etc/passwd</filename> and
<filename>/etc/group</filename> files, we provide <ulink <filename>/etc/group</filename> files, we provide <ulink
url="http://cygwin.com/cygwin-ug-net/using-utils.html">utilities</ulink> url="https://cygwin.com/cygwin-ug-net/using-utils.html">utilities</ulink>
that can be used to construct them from the user and group information that can be used to construct them from the user and group information
provided by the operating system.</para> provided by the operating system.</para>
@ -272,7 +272,7 @@ location, Cygwin can do nothing to compensate (though it will
retry a few times automatically).</para></listitem> retry a few times automatically).</para></listitem>
<listitem><para>DLL injection by <listitem><para>DLL injection by
<ulink url="http://cygwin.com/faq/faq.html#faq.using.bloda"> <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda">
BLODA</ulink>. Badly-behaved applications which BLODA</ulink>. Badly-behaved applications which
inject dlls into other processes often manage to clobber important inject dlls into other processes often manage to clobber important
sections of the child's address space, leading to base address sections of the child's address space, leading to base address

2
winsup/doc/legal.xml
View File

@ -4,7 +4,7 @@
<legalnotice id="legal"> <legalnotice id="legal">
<para>Copyright &copy; 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Red Hat, Inc.</para> <para>Copyright &copy; 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Red Hat, Inc.</para>
<!-- <!--

2
winsup/doc/new-features.xml
View File

@ -1460,7 +1460,7 @@ Getting a domain user's groups is hopefully more bulletproof now.
Cygwin now comes with a real LSA authentication package. This must be Cygwin now comes with a real LSA authentication package. This must be
manually installed by a privileged user using the /bin/cyglsa-config manually installed by a privileged user using the /bin/cyglsa-config
script. The advantages and disadvantages are noted in script. The advantages and disadvantages are noted in
http://cygwin.com/ml/cygwin-developers/2006-11/msg00000.html https://cygwin.com/ml/cygwin-developers/2006-11/msg00000.html
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>

2
winsup/doc/ov-ex-unix.xml
View File

@ -32,7 +32,7 @@ By default, <command>setup.exe</command> only installs a minimal subset of
packages. Add any other packages by clicking on the <literal>+</literal> packages. Add any other packages by clicking on the <literal>+</literal>
next to the Category name and selecting the package from the displayed next to the Category name and selecting the package from the displayed
list. You may search for specfic tools by using the list. You may search for specfic tools by using the
<ulink url="http://cygwin.com/packages/">Setup Package Search</ulink> <ulink url="https://cygwin.com/packages/">Setup Package Search</ulink>
at the Cygwin web site. at the Cygwin web site.
</para> </para>
<para> <para>

4
winsup/doc/overview.xml
View File

@ -51,7 +51,7 @@ information on how the GNU GPL may affect your use of these
tools. If you intend to port a proprietary application using the Cygwin tools. If you intend to port a proprietary application using the Cygwin
library, you may want the Cygwin proprietary-use license. library, you may want the Cygwin proprietary-use license.
For more information about the proprietary-use license, please go to For more information about the proprietary-use license, please go to
<ulink url="http://www.redhat.com/services/custom/cygwin/">http://www.redhat.com/services/custom/cygwin/</ulink>. <ulink url="http://www.redhat.com/services/custom/cygwin/"/>.
Customers of the native Win32 GNUPro should feel free to submit bug Customers of the native Win32 GNUPro should feel free to submit bug
reports and ask questions through Red Hat channels. All other reports and ask questions through Red Hat channels. All other
questions should be sent to the project mailing list questions should be sent to the project mailing list
@ -105,7 +105,7 @@ the GNU configure mechanism. Self hosting was achieved as of the beta
<para> <para>
The entire Cygwin toolset was available as a monolithic install. In The entire Cygwin toolset was available as a monolithic install. In
April 2000, the project announced a April 2000, the project announced a
<ulink url="http://www.cygwin.com/ml/cygwin/2000-04/msg00269.html"> <ulink url="https://www.cygwin.com/ml/cygwin/2000-04/msg00269.html">
New Cygwin Net Release</ulink> which provided the native non-Cygwin Win32 program New Cygwin Net Release</ulink> which provided the native non-Cygwin Win32 program
<command>setup.exe</command> to install and upgrade each package <command>setup.exe</command> to install and upgrade each package
separately. Since then, the Cygwin DLL and <command>setup.exe</command> separately. Since then, the Cygwin DLL and <command>setup.exe</command>

29
winsup/doc/setup-net.xml
View File

@ -8,10 +8,10 @@
<sect1 id="internet-setup"> <sect1 id="internet-setup">
<title>Internet Setup</title> <title>Internet Setup</title>
<para>To install the Cygwin net release, go to <ulink <para>To install the Cygwin net release, go to <ulink
url="http://cygwin.com/">http://cygwin.com/</ulink> and run either url="https://cygwin.com/"/> and run either
<ulink url="http://cygwin.com/setup-x86.exe">setup-x86.exe</ulink> <ulink url="https://cygwin.com/setup-x86.exe">setup-x86.exe</ulink>
to install the 32 bit version of Cygwin, or to install the 32 bit version of Cygwin, or
<ulink url="http://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink> <ulink url="https://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink>
to install the 64 bit version of Cygwin. This will download a GUI to install the 64 bit version of Cygwin. This will download a GUI
installer which can be run to download a complete cygwin installation installer which can be run to download a complete cygwin installation
via the internet. Follow the instructions on each screen to install Cygwin. via the internet. Follow the instructions on each screen to install Cygwin.
@ -22,9 +22,9 @@ via the internet. Follow the instructions on each screen to install Cygwin.
For easier reading the installer is called <command>setup.exe</command> For easier reading the installer is called <command>setup.exe</command>
throughout the following sections. This refers likewise to both throughout the following sections. This refers likewise to both
installer applications, installer applications,
<ulink url="http://cygwin.com/setup-x86.exe">setup-x86.exe</ulink> <ulink url="https://cygwin.com/setup-x86.exe">setup-x86.exe</ulink>
for 32 bit, as well as for 32 bit, as well as
<ulink url="http://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink> <ulink url="https://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink>
for 64 bit. Apart from the target architecture they are the same thing. for 64 bit. Apart from the target architecture they are the same thing.
</note> </note>
</para> </para>
@ -34,7 +34,7 @@ The <command>setup.exe</command> installer is designed to be easy
for new users to understand while remaining flexible for the for new users to understand while remaining flexible for the
experienced. The volunteer development team is constantly working experienced. The volunteer development team is constantly working
on <command>setup.exe</command>; before requesting a new feature, on <command>setup.exe</command>; before requesting a new feature,
check the wishlist in the <ulink url="http://sourceware.org/cgi-bin/cvsweb.cgi/setup/README?cvsroot=cygwin-apps&amp;rev=2">CVS <literal>README</literal> check the wishlist in the <ulink url="https://sourceware.org/cgi-bin/cvsweb.cgi/setup/README?cvsroot=cygwin-apps&amp;rev=2">CVS <literal>README</literal>
</ulink>. It may already be present in the CVS version! </ulink>. It may already be present in the CVS version!
</para> </para>
@ -52,9 +52,7 @@ most installations, you can get a working minimal Cygwin environment
installed by simply clicking the <literal>Next</literal> button installed by simply clicking the <literal>Next</literal> button
at each page. The only exception to this is choosing a Cygwin mirror, at each page. The only exception to this is choosing a Cygwin mirror,
which you can choose by experimenting with those listed at which you can choose by experimenting with those listed at
<ulink url="http://cygwin.com/mirrors.html"> <ulink url="https://cygwin.com/mirrors.html"/>. For more details about each of page of the
http://cygwin.com/mirrors.html
</ulink>. For more details about each of page of the
<command>setup.exe</command> installation, read on below. <command>setup.exe</command> installation, read on below.
Please note that this guide assumes that you have a basic understanding Please note that this guide assumes that you have a basic understanding
of Unix (or a Unix-like OS). If you are new to Unix, you will also want of Unix (or a Unix-like OS). If you are new to Unix, you will also want
@ -148,8 +146,8 @@ authorization for proxy servers.
<para> <para>
Since there is no way of knowing from where you will be downloading Since there is no way of knowing from where you will be downloading
Cygwin, you need to choose at least one mirror site. Cygwin mirrors Cygwin, you need to choose at least one mirror site. Cygwin mirrors
are geographically distributed around the world; check the list at <ulink are geographically distributed around the world; check the list at
url="http://cygwin.com/mirrors.html">http://cygwin.com/mirrors.html</ulink> <ulink url="https://cygwin.com/mirrors.html"/>
to find one near you. You can select multiple mirrors by holding down to find one near you. You can select multiple mirrors by holding down
<literal>CTRL</literal> and clicking on each one. If you have the URL of <literal>CTRL</literal> and clicking on each one. If you have the URL of
an unlisted mirror (for example, if your organization has an internal Cygwin an unlisted mirror (for example, if your organization has an internal Cygwin
@ -163,9 +161,8 @@ For each selected mirror site, <command>setup.exe</command> downloads a
small text file called <literal>setup.bz2</literal> that contains a list small text file called <literal>setup.bz2</literal> that contains a list
of packages available from that site along with some basic information about of packages available from that site along with some basic information about
each package which <command>setup.exe</command> parses and uses to create the each package which <command>setup.exe</command> parses and uses to create the
chooser window. For details about the format of this file, see chooser window. For details about the format of this file, see the
the <ulink url="http://sourceware.org/cygwin-apps/setup.html"> <ulink url="https://sourceware.org/cygwin-apps/setup.html">setup.exe homepage</ulink>.
setup.exe homepage</ulink>.
</para> </para>
<para> <para>
The chooser is the most complex part of <command>setup.exe</command>. The chooser is the most complex part of <command>setup.exe</command>.
@ -260,7 +257,7 @@ scripts to finish correctly setting up installed packages. Since each
script is run separately, several windows may pop up. If you are script is run separately, several windows may pop up. If you are
interested in what is being done, see the Cygwin Package Contributor's interested in what is being done, see the Cygwin Package Contributor's
Guide at <ulink Guide at <ulink
url="http://cygwin.com/setup.html">http://cygwin.com/setup.html</ulink> url="https://cygwin.com/setup.html"/>
When the last post-install script is completed, <command>setup.exe</command> When the last post-install script is completed, <command>setup.exe</command>
will display a box announcing the completion. A few packages, such as will display a box announcing the completion. A few packages, such as
the OpenSSH server, require some manual site-specific configuration. the OpenSSH server, require some manual site-specific configuration.
@ -277,7 +274,7 @@ HTTP instead of FTP). If you notice something is not working after
running setup, you can check the <command>setup.exe</command> log file running setup, you can check the <command>setup.exe</command> log file
at <literal>/var/log/setup.log.full</literal>. Make a backup of this at <literal>/var/log/setup.log.full</literal>. Make a backup of this
file before running <command>setup.exe</command> again, and follow the file before running <command>setup.exe</command> again, and follow the
steps for <ulink url="http://cygwin.com/problems.html">Reporting steps for <ulink url="https://cygwin.com/problems.html">Reporting
Problems with Cygwin</ulink>. Problems with Cygwin</ulink>.
</para> </para>
</sect2> </sect2>

2
winsup/doc/utils.xml
View File

@ -141,7 +141,7 @@ $ cygcheck -l less
of packages. This feature requires an active internet connection, since of packages. This feature requires an active internet connection, since
it must query the <literal>cygwin.com</literal> web site. In fact, it is it must query the <literal>cygwin.com</literal> web site. In fact, it is
equivalent to the search that is available on the <ulink equivalent to the search that is available on the <ulink
url="http://cygwin.com/packages/">Cygwin package listing</ulink> url="https://cygwin.com/packages/">Cygwin package listing</ulink>
page.</para> page.</para>
<para>For example, perhaps you are getting an error because you are missing <para>For example, perhaps you are getting an error because you are missing