diff options
author | Corinna Vinschen <corinna@vinschen.de> | 2010-08-13 15:52:13 +0400 |
---|---|---|
committer | Corinna Vinschen <corinna@vinschen.de> | 2010-08-13 15:52:13 +0400 |
commit | a016fed8bae15b01b279288639215e5fc225678a (patch) | |
tree | aa2d7ce37576362efafbba41a5ea6672958b0f1c /winsup/doc/faq-programming.xml | |
parent | 260b80740ecf07b137aa6a6711d5d56fdd861d44 (diff) |
* faq-programming.xml (faq.programming.win32-api): Remove simplicity.
Add note and xrefs to User's Guide chapters explaining restrictions
using the Win32 API.
* new-features.sgml (ov-new1.7.6): Add note about Win CWD.
* overview2.sgml (ov-hi-intro): Add note and xrefs about Win32 API
restrictions. Tone down flexibility.
* pathnames.sgml (pathnames-intro): Add xref to pathnames-win32-api
section.
(pathnames-win32-api): New section describing Win32 CWD restriction.
* setup2.sgml (setup-env-ov): New sub-section.
(setup-env-win32): Ditto, describing Win32 environment restriction.
Diffstat (limited to 'winsup/doc/faq-programming.xml')
-rw-r--r-- | winsup/doc/faq-programming.xml | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 3936dbc51..331454735 100644 --- a/winsup/doc/faq-programming.xml +++ b/winsup/doc/faq-programming.xml @@ -172,10 +172,10 @@ gcj --main=Hello Hello.java <question><para>How do I use Win32 API calls?</para></question> <answer> -<para>It's pretty simple actually. Cygwin tools require that you explicitly -link the import libraries for whatever Win32 API functions that you -are going to use, with the exception of kernel32, which is linked -automatically (because the startup and/or built-in code uses it). +<para>Cygwin tools require that you explicitly link the import libraries +for whatever Win32 API functions that you are going to use, with the exception +of kernel32, which is linked automatically (because the startup and/or +built-in code uses it). </para> <para>For example, to use graphics functions (GDI) you must link with gdi32 like this: @@ -194,6 +194,12 @@ including user32, gdi32 and, IIRC, comdlg32. <para>It is a good idea to put import libraries last on your link line, or at least after all the object files and static libraries that reference them. </para> + +<note><para>There are a few restrictions for calls to the Win32 API. +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>, +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> </answer></qandaentry> <qandaentry id="faq.programming.win32-no-cygwin"> |