[pkg-wine-party] [wine] 11/12: Document generating 32-bit results with the -tools packages.

[Jens Reyer]

This is an automated email from the git hooks/post-receive script.

jreyer-guest pushed a commit to branch master
in repository wine.

commit 2e52d32383b040ff7118e46b441410d64f184655
Author: Jens Reyer <jre.winesim at gmail.com>
Date:   Sun Jun 5 19:13:52 2016 +0200

    Document generating 32-bit results with the -tools packages.
    
    See: #824673
    Thanks: Andrey Gursky and Javier Serrano Polo
---
 debian/README.debian | 23 ++++++++++++++++++++---
 debian/changelog     |  2 ++
 debian/control.in    |  6 ++++--
 3 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/debian/README.debian b/debian/README.debian
index a32409d..044a2fd 100644
--- a/debian/README.debian
+++ b/debian/README.debian
@@ -65,8 +65,8 @@ setup with "rm -rf ~/.wine". This will destroy everything you've installed,
 including configuration and data files, so if you have anything important,
 please back it up first. You can then start fresh.
 
-32-/64-bit
-==========
+Running 32-bit Windows applications on 64-bit systems
+=====================================================
 Most Windows binaries are 32-bit applications. You need to install wine32 (or
 wine32-development) to run them. wine64 (or wine64-development) alone cannot do
 this.
@@ -78,7 +78,7 @@ wine32-development). As root, execute e.g.:
 
 If you have wine32 and wine64 (or wine32-development and wine64-development)
 installed, Wine will default to a shared 64-bit prefix that runs most 32-bit
-Windows applications.
+Windows applications (WoW64).
 
 If this causes problems for an application, you may create a 32-bit prefix by
 running e.g.:
@@ -92,6 +92,23 @@ $ WINEPREFIX="$HOME/.wine32" wine-development application.exe
 If you don't want 64-bit at all, just uninstall wine64 (or
 wine-64-development).
 
+32-bit results from the tools (winegcc, ...) on 64-bit systems
+==============================================================
+You may generate 32-bit results with the programs in wine32-tools (or
+wine32-development-tools) as well as with those in wine64-tools (or
+wine64-development-tools).
+
+Enable multiarch (see above). Than install the matching 32-bit Wine development
+files. As root, execute e.g. on amd64:
+# apt install libwine-dev:i386
+# apt install libwine-development-dev:i386
+
+Use the programs with the option "-m32" (for winemaker --wine32). If you are
+using wine64(-development)-tools specify the arch-specific path to some files
+additionally, e.g.:
+$ winegcc -m32 -L/usr/lib/i386-linux-gnu/wine ...
+$ winegcc-development -m32 -L/usr/lib/i386-linux-gnu/wine-development ...
+
 Wine Gecko
 ==========
 The downloader for Wine Gecko is intentionally disabled in the Debian packages.
diff --git a/debian/changelog b/debian/changelog
index 93b6c95..55188d9 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -13,6 +13,8 @@ wine-development (1.9.11-2) UNRELEASED; urgency=medium
   * Make wineNN-tools multi-arch installable (closes: #824673, see: #823264).
     Thanks to Javier Serrano Polo.
   * Let libwine-dev prefer wine64-tools to wine32-tools.
+  * Document generating 32-bit results with the -tools packages.
+    Thanks to Andrey Gursky and Javier Serrano Polo.
 
  -- Jens Reyer <jre.winesim at gmail.com>  Sun, 05 Jun 2016 15:24:30 +0200
 
diff --git a/debian/control.in b/debian/control.in
index aa2d506..ada0dc8 100644
--- a/debian/control.in
+++ b/debian/control.in
@@ -180,7 +180,8 @@ Description: Windows API implementation - 32-bit developer tools
  Wine is a free MS-Windows API implementation.
  This is still a work in progress and many applications may still not work.
  .
- This package provides Wine's 32-bit developer tools.
+ This package provides Wine's 32-bit developer tools. They are capable of
+ generating 32-bit results.
 
 Package: wine64VERSION-tools
 Architecture: amd64 arm64
@@ -202,7 +203,8 @@ Description: Windows API implementation - 64-bit developer tools
  Wine is a free MS-Windows API implementation.
  This is still a work in progress and many applications may still not work.
  .
- This package provides Wine's 64-bit developer tools.
+ This package provides Wine's 64-bit developer tools. They are capable of
+ generating both 32- and 64-bit results.
 
 Package: libwineVERSION
 Section: libs

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-wine/wine.git