Permalink
Browse files

Document workaround for bug #303.

README.Java:
    Document the workaround for bug #303.

README.MinGW:
    Wrap a couple of overlong lines.
  • Loading branch information...
1 parent 0b0d3fc commit c5f35d84f77f11ebf780ce862b7a9dce818371d7 @juliensf juliensf committed Nov 22, 2013
Showing with 22 additions and 5 deletions.
  1. +17 −0 README.Java
  2. +5 −5 README.MinGW
View
17 README.Java
@@ -95,6 +95,23 @@ Java compiler, but we haven't tried that yet.
-----------------------------------------------------------------------------
+BUILDING THE JAVA GRADE ON WINDOWS
+
+When building the Java grade on Windows it sometimes possible for the fully
+qualified names of some generated files to exceed the maximum path length.
+If this occurs the Mercury compiler will abort with a message like:
+
+ Uncaught Mercury exception:
+ Software Error: parse_tree.module_cmds: predicate \
+ `parse_tree.module_cmds.list_class_files_for_jar'/6: \
+ Unexpected: io.file_type failed: No such file or directory
+
+In this case all that can (currently) be done is to reduce the length of the
+build path, for example by shifting the build directory closer to the root of
+the file system (e.g. C:\mercury).
+
+-----------------------------------------------------------------------------
+
BUILDING THE MERCURY COMPILER IN THE JAVA GRADE
Building the Mercury compiler and other related tools in the Java grade
View
10 README.MinGW
@@ -10,13 +10,13 @@ Using the MinGW port of GCC you can build a Mercury compiler that can generate
executables that will run natively on Windows without the need for a support
environment like Cygwin. Using the standard MinGW version of GCC will result
in a Mercury compiler that generates 32-bit executables. To build a Mercury
-compiler that generates 64-bit executables for Windows you will need to
-use the MinGW64 port of GCC.
+compiler that generates 64-bit executables for Windows you will need to use the
+MinGW64 port of GCC.
NOTE: a Unix like environment is required to build and install the Mercury
-compiler. MSYS or Cygwin can be used for this purpose. A Unix like environment
-is only required for installing Mercury, you do *not* require one to use
-Mercury once it is installed.
+compiler. MSYS or Cygwin can be used for this purpose. A Unix like
+environment is only required for installing Mercury, you do *not* require one
+to use Mercury once it is installed.
-----------------------------------------------------------------------------

0 comments on commit c5f35d8

Please sign in to comment.