[PYLUCENE-40] Document use of JCC_JDK

• Type: Improvement
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Assignee: Unassigned
• Reporter: Ryan Ollos
• Created: 12/Feb/18 23:48
• Updated: 01/Jun/18 19:33

Description

I found two issues when trying to help someone on Stack Overflow build the library. First, the documentation on PyPI states:

JCC’s setup.py file needs to be edited before building JCC to specify the location of the Java Runtime Environment’s header files and libraries.

However, it appears you have a better mechanism of setting JCC_JDK, but it's not documented.

Second, when setting JCC_JDK is appears to work correctly and use the path to the specified JCC_JDK in the compilation, but the first line of output might indicate that a different JRE is being used:

$JCC_JDK=/Library/Java/JavaVirtualMachines/jdk1.7.0_80.jdk/Contents/Home python setup.py install
found JAVAHOME = /Library/Java/JavaVirtualMachines/jdk1.8.0_141.jdk/Contents/Home
found JAVAFRAMEWORKS = /System/Library/Frameworks/JavaVM.framework
...

So maybe the found JAVAHOME should not be printed if JCC_JDK is set, so it appears that JCC_JDK is successfully overriding the JAVAHOME. I'll attach the full output from building on my platform.