libs/newlib-cygwin
libs
/
newlib-cygwin
mirror of git://sourceware.org/git/newlib-cygwin.git
4
0
Fork 0
Code Issues Projects Releases Wiki Activity

Cygwin: FAQ: convert ulinks to FAQ to xrefs 

Using ulinks here makes the result work on cygwin.com only, while
xrefs to FAQs are creating realtive links.  Add xreflabel where
appropriate.

Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
This commit is contained in:
Corinna Vinschen 2022-12-02 22:38:47 +01:00
parent 08f33e5b6a
commit cf65cbcea4
4 changed files with 17 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -32,22 +32,21 @@ User's Guide.
<para>Starting December 2022, the old developer snapshots have been <para>Starting December 2022, the old developer snapshots have been
deprecated by regular, automated test releases. See the next FAQ entry deprecated by regular, automated test releases. See the next FAQ entry
<ulink url="https://cygwin.com/faq/faq-api.html#faq.api.testrels"/>) <xref linkend="faq.api.testrels"></xref>
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.api.testrels"> <qandaentry id="faq.api.testrels" xreflabel="Test Releases">
<question><para>Are test releases for the Cygwin library available?</para></question> <question><para>Are test releases for the Cygwin library available?</para></question>
<answer> <answer>
<para>Yes. Starting December 2022, regular, automated test releases <para>Yes. Starting December 2022, regular, automated test releases
are created whenever a considerable patch is pushed to the Cygwin git are created whenever a considerable patch is pushed to the Cygwin git
repo at repo at <ulink url="https://cygwin.com/git/newlib-cygwin.git"/>.
<ulink url="https://cygwin.com/git/newlib-cygwin.git"/>.
You can download the cygwin package test releases just like any other You can download the cygwin package test releases just like any other
test release for any Cgywin package using the Cygwin Setup program. test release for any Cgywin package using the Cygwin Setup program.
For more info, see For more info, see
<ulink url="https://cygwin.com/faq/faq-setup.html#faq.setup.testrels"/> <xref linkend="faq.setup.testrels"></xref>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>

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

@ -357,7 +357,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="https://cygwin.com/faq/faq.html#faq.using.shell-scripts"/>). at <xref linkend="faq.using.shell-scripts"></xref>).
</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
@ -671,7 +671,7 @@ rewriting the runtime library in question from specs...
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.programming.building-cygwin"> <qandaentry id="faq.programming.building-cygwin" xreflabel="Build Cygwin">
<question><para>How do I build Cygwin on my own?</para></question> <question><para>How do I build Cygwin on my own?</para></question>
<answer> <answer>
@ -766,12 +766,11 @@ operation e.g. when checking a pointer is valid)
<para> <para>
It is also a good idea to use the latest code in case the bug has been fixed, It is also a good idea to use the latest code in case the bug has been fixed,
so we recommend trying the latest cygwin test release (see so we recommend trying the latest cygwin test release (see
<ulink url="https://cygwin.com/faq/faq-setup.html#faq.setup.testrels"/>) <xref linkend="faq.setup.testrels"></xref>) or building the DLL from git.
or building the DLL from git.
</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="https://cygwin.com/faq/faq.html#faq.programming.building-cygwin"/>. the instructions at <xref linkend="faq.programming.building-cygwin"></xref>.
</para> </para>
<para> <para>

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

@ -23,7 +23,7 @@ is available on using the Cygwin Setup program.
<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 it's not covered here or in If something doesn't work right for you, and it's not covered here or in
the latest Cygwin test package (see the latest Cygwin test package (see
<ulink url="https://cygwin.com/faq/faq-api.html#faq.api.testrels"/>), <xref linkend="faq.setup.testrels"></xref>),
then by all means report it to the mailing list. then by all means report it to the 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,
@ -183,7 +183,7 @@ and that installing the older version will not help improve Cygwin.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.setup.install-security"> <qandaentry id="faq.setup.install-security" xreflable="Secure Installation">
<question><para>How does Cygwin secure the installation and update process?</para></question> <question><para>How does Cygwin secure the installation and update process?</para></question>
<answer> <answer>
@ -292,7 +292,7 @@ We also provide automatic mechanisms
do not want to perform the signature checking on the Cygwin Setup program itself. do not want to perform the signature checking on the Cygwin Setup program itself.
Once the correct Setup program is running, it will counter other attacks Once the correct Setup program is running, it will counter other attacks
as described in as described in
<ulink url="https://cygwin.com/faq/faq.html#faq.setup.install-security"/>. <xref linkend="faq.setup.install-security"></xref>.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
@ -339,12 +339,12 @@ disk if you are paranoid.
<para>This should be safe, but only if the Cygwin Setup program is not substituted by <para>This should be safe, but only if the Cygwin Setup program is not substituted by
something malicious. something malicious.
See also See also
<ulink url="https://cygwin.com/faq/faq.html#faq.setup.install-security"/> <xref linkend="faq.setup.install-security"></xref>
for a description of how the for a description of how the
Cygwin project counters man-in-the-middle (MITM) attacks. Cygwin project counters man-in-the-middle (MITM) attacks.
</para> </para>
<para>See also <ulink url="https://cygwin.com/faq/faq.html#faq.using.bloda"/> <para>See also <xref linkend="faq.using.bloda"></xref>
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>
@ -627,7 +627,7 @@ directory has been stored in the registry at all.
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.setup.testrels"> <qandaentry id="faq.setup.testrels" xreflabel="Install Test Releases">
<question><para>How do I install Cygwin test releases?</para></question> <question><para>How do I install Cygwin test releases?</para></question>
<answer> <answer>

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

@ -401,7 +401,7 @@ for more information on how Cygwin maps Windows permissions.
</para> </para>
</answer></qandaentry> </answer></qandaentry>
<qandaentry id="faq.using.shell-scripts"> <qandaentry id="faq.using.shell-scripts" xreflabel="Using Shell Scripts">
<question><para>Why doesn't my shell script work?</para></question> <question><para>Why doesn't my shell script work?</para></question>
<answer> <answer>
@ -743,7 +743,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="https://cygwin.com/faq/faq.html#faq.using.bloda"/> <para>See also <xref linkend="faq.using.bloda"></xref>
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>
@ -891,7 +891,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="https://cygwin.com/faq/faq.html#faq.using.bloda"/> <para>See also <xref linkend="faq.using.bloda"></xref>
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>