Commit 15502013a9c88939919ed2c7ceb55cd3528fc21c

Authored by Jay Berkenbilt
1 parent dded2ec0

Tweak wording of Thorsten's documentation updates

Showing 1 changed file with 18 additions and 28 deletions
README-windows.txt
... ... @@ -46,45 +46,35 @@ that to replace the one in the 20111220 version, which is based on
46 46 4.7.0. That particular workaround results in a Windows-hosted 64-bit
47 47 targetted mingw that can build a qpdf that passes its test suite.
48 48  
49   -As of this writing, the image comparison tests confuse ghostscript in
50   -cygwin, but there's a chance they might work at some point. If you
51   -want to run them, you need ghostscript and tiff utils as well, and you
52   -will need to add --enable-test-compare-images from the configure
53   -statements given below.
54   -
55   -
56   -
57   -Additionally for Windows, some tests require 3rd party software which
58   -most likely is not available if not provided by an environment like
59   -MSYS, Cygwin or such, but can be downloaded separately as well for an
60   -environment not using both of the former mentioned. Just extract or
61   -install the following software into separate folders each and add the
62   -"bin" folder to your "PATH" env variable to make executables and DLLs
63   -available. If installers are provided, they might do that already by
64   -default.
  49 +Image comparison tests are disabled by default, but it is possible to
  50 +run them on Windows. To do so, add --enable-test-compare-images from
  51 +the configure statements given below and install some additional
  52 +third-party dependencies. These may be provided in an environment such
  53 +as MSYS or Cygwin or can be downloaded separately for other
  54 +environments. You may extract or install the following software into
  55 +separate folders each and add the "bin" folder to your "PATH"
  56 +environment variable to make executables and DLLs available. If
  57 +installers are provided, they might do that already by default.
65 58  
66 59 * LibJpeg (http://gnuwin32.sourceforge.net/packages/jpeg.htm)
67 60  
68   - This archive provides some needed DLLs for LibTiff if you want to
69   - use the image comparison tests.
  61 + This archive provides some needed DLLs needed by LibTiff.
70 62  
71 63 * LibTiff (http://gnuwin32.sourceforge.net/packages/tiff.htm)
72 64  
73 65 This archive provides some needed binaries and DLLs if you want to
74   - use the image comparison tests and is only working if DLLs from
75   - LibJpeg are available as well.
  66 + use the image comparison tests. It depends on some DLLs from
  67 + LibJpeg.
76 68  
77 69 * GhostScript (http://www.ghostscript.com/download/gsdnld.html)
78 70  
79   - GhstScript is needed for image comparison tests and it's important
  71 + GhostScript is needed for image comparison tests. It's important
80 72 that the binary is available as "gs", while its default name is
81   - "gswin32[c].exe". So you need to provide an additional "gs.exe"
82   - by copying one of the original files or use "mklink" to create a
83   - hard-/softlink, or need to provide a custom "gs.cmd" wrapper which
84   - simply forwards all args to one of the original binarys. Using
85   - "mkink" with "gswin32c.exe" should be preferred.
86   -
87   -
  73 + "gswin32[c].exe". You can either copy one of the original files,
  74 + use "mklink" to create a hard-/softlink, or provide a custom
  75 + "gs.cmd" wrapper that forwards all arguments to one of the original
  76 + binaries. Using "mklink" with "gswin32c.exe" is probably the best
  77 + choice.
88 78  
89 79 Jian Ma <stronghorse@tom.com> has generously provided a port of QPDF
90 80 that works with Microsoft VC6. Several changes are required, but they
... ...