Commit 15502013a9c88939919ed2c7ceb55cd3528fc21c
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,45 +46,35 @@ that to replace the one in the 20111220 version, which is based on | ||
| 46 | 4.7.0. That particular workaround results in a Windows-hosted 64-bit | 46 | 4.7.0. That particular workaround results in a Windows-hosted 64-bit |
| 47 | targetted mingw that can build a qpdf that passes its test suite. | 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 | * LibJpeg (http://gnuwin32.sourceforge.net/packages/jpeg.htm) | 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 | * LibTiff (http://gnuwin32.sourceforge.net/packages/tiff.htm) | 63 | * LibTiff (http://gnuwin32.sourceforge.net/packages/tiff.htm) |
| 72 | 64 | ||
| 73 | This archive provides some needed binaries and DLLs if you want to | 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 | * GhostScript (http://www.ghostscript.com/download/gsdnld.html) | 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 | that the binary is available as "gs", while its default name is | 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 | Jian Ma <stronghorse@tom.com> has generously provided a port of QPDF | 79 | Jian Ma <stronghorse@tom.com> has generously provided a port of QPDF |
| 90 | that works with Microsoft VC6. Several changes are required, but they | 80 | that works with Microsoft VC6. Several changes are required, but they |