# HG changeset patch
# User Oleksandr Gavenko <gavenkoa@gmail.com>
# Date 1442650932 -10800
# Node ID 6f62f6dccf2c7dec20ef30bb3c6a03687ac8df0a
# Parent  a5b14a9f4498b591a45e0ee915e34050ed4135b6
Microsoft HTML Help under Debian.

diff -r a5b14a9f4498 -r 6f62f6dccf2c chm.rst
--- a/chm.rst	Fri Sep 18 16:11:49 2015 +0300
+++ b/chm.rst	Sat Sep 19 11:22:12 2015 +0300
@@ -32,53 +32,52 @@
 ====================
 
   http://msdn.microsoft.com/en-us/library/ms669985
-                Microsoft HTML Help Downloads
+    Microsoft HTML Help Downloads.
+  http://www.microsoft.com/en-us/download/details.aspx?id=21138
+    HTML Help Workshop and Documentation.
   http://support.microsoft.com/kb/269766/
-                INFO: Limited Unicode Support in HTML Help
+    INFO: Limited Unicode Support in HTML Help.
 
 Microsoft HTML Help under Debian.
 =================================
 
-Set Wine's Windows version to Windows 2000 (or above), and add an override to
-use the native itss.dll, both via ``winecfg``::
+Set Wine's Windows version to Windows 2000 (or above) via ``winecfg``.
+
+Install necessary dependency::
+
+  $ winetricks mfc40
 
-  wine winecfg
+Alternatively manually download and install `Microsoft Foundation Classes update
+<http://activex.microsoft.com/controls/vc/mfc40.cab>`_::
+
+  $ wget http://activex.microsoft.com/controls/vc/mfc40.cab
+  $ cabextract mfc40.cab
+  $ wine mfc40.exe
 
 Download `Microsoft HTML Help Workshop
 <https://msdn.microsoft.com/en-us/library/ms669985.aspx>`_ and install it as
 (from non-``noexec`` FS!!)::
 
-  wine htmlhelp.exe
+  $ wine htmlhelp.exe
 
-Install ``itircl.dll`` and ``itss.dll`` as::
+Install ``itircl.dll`` and ``itss.dll`` from ``hhupd.exe`` which available in
+installer or in ``~/.wine/drive_c/Program Files/HTML Help Workshop/redist``::
 
   cabextract -F hhupd.exe htmlhelp.exe
   cabextract -F itircl.dll hhupd.exe
   cabextract -F itss.dll hhupd.exe
   cp -a itircl.dll ~/.wine/drive_c/windows/system32/
   cp -a itss.dll ~/.wine/drive_c/windows/system32/
-  wine regsvr32 /s 'C:\WINDOWS\SYSTEM32\itircl.dll'
-  wine regsvr32 /s 'C:\WINDOWS\SYSTEM32\itss.dll'
 
-Download `Microsoft Foundation Classes update
-<http://activex.microsoft.com/controls/vc/mfc40.cab>`_, extract it, and install
-it as::
-
-  wget http://activex.microsoft.com/controls/vc/mfc40.cab
-  cabextract mfc40.cab
-  wine mfc40.exe
-  wget -N http://activex.microsoft.com/controls/vc/mfc40.cab
-  cabextract -F mfc40.exe mfc40.cab
-  cabextract -F mfc40.dll mfc40.exe
-  cp -a mfc40.dll ~/.wine/drive_c/windows/system32/
-
-Or just::
-
-  $ winetricks mfc40
+You must add exception for ``hhc.exe`` and ``hhw.exe`` to use native variant of
+``itss.dll`` via ``winecfg``. Note: don't set ``itss.dll`` to native by default
+becase then ``wine hh`` wouldn't work.
 
 See:
 
  * http://code.google.com/p/htmlhelp/wiki/HHW4Wine
+ * https://appdb.winehq.org/objectManager.php?sClass=version&iId=2978
+ * https://bugs.winehq.org/show_bug.cgi?id=7517
 
 Viewer.
 =======