[Bug 63381] Suggested change to "How to build" instructions

[bu...@apache.org]

https://bz.apache.org/bugzilla/show_bug.cgi?id=63381

--- Comment #1 from David Gauntt <dm...@uab.edu> ---
Created attachment 36570
  --> https://bz.apache.org/bugzilla/attachment.cgi?id=36570&action=edit
Suggested text for the "Working with Eclipse" section of "How to build" page

After spending a few (!) weeks getting my first successful build of POI, I
think that I can make suggestions useful for those like me with experience with
Eclipse but not experience with Ant; these suggestions are in the attached
file.

The Ugly Details

The ultimate reason for my struggles is that when I tried to run Ant from
within Eclipse instead of the command line, any Java code run by Ant would run
with a working directory of "C:/Windows/System32" instead of the directory
containing build.xml. This strikes me as an OS-specific Eclipse bug.  It
happened running Eclipse 2019-03 in Windows 10, but not Eclipse 2019-03 in Mac
OS X 11.6.

In Windows 10, when I ran the "assemble" target, its dependency "test-ooxml"
would fail while running "TestPOIXMLDocument"

I was able to partially compensate for this changing the value of tempdir from
a relative to an absolute path by replacing
    <property name="tempdir" value="build/tmp"/>
with
    <property name="tempdir" value="<absolute path of folder containing
build.xml>/build/tmp"/>

With this change "TestPOIXMLDocument" would succeed, but the later test
"AddImageBenchmark" would fail. It may be possible to solve this by changing
more path parameters in build.xml from relative to absolute, but for the time
being it seems to me that the simplest workaround is to recommend running Ant
from the command prompt.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org