[foreign] Instructions for using libraries on Windows

[Maurizio Cimadamore]

The changes you made look good - only nit, in the Windows notes you 
mention "Visual Studios" (note the plural) a few times - I'd replace 
with the singular form.

The rest is good

Maurizio

On 17/01/2019 17:27, Jorn Vernee wrote:
> I got the .html generation working with the help of Erik from 
> build-dev, so I think I can manage myself.
>
> Want me to sent an RFR with an actual webrev as well?
>
> Jorn
>
> Maurizio Cimadamore schreef op 2019-01-17 18:20:
>> Let us know if you need help with pushing this
>>
>> Thanks for trying this out on Windows!
>>
>> Maurizio
>>
>> On 17/01/2019 16:48, Jorn Vernee wrote:
>>>> The `make update-build-doc` does not work on windows [1], so I ask
>>>> that you generate the .html dos for me instead.
>>>
>>> Apologies. It seems to be a configuration problem on my end, and not 
>>> necessarily a problem with Windows.
>>>
>>> Jorn
>>>
>>> Jorn Vernee schreef op 2019-01-17 17:36:
>>>> Hi,
>>>>
>>>> I have updated panama_foreign.md with instructions for jextracting and
>>>> running OpenGL and Python. I have also tried other Windows applicable
>>>> libraries, here were the issues:
>>>>
>>>> LAPACK & BLAS: require libgfortran-3 as a dependency, which I couldn't
>>>> find a binary distro for so quickly. (MINGW has a package for it, but
>>>> only libgfortran-4)
>>>>
>>>> Tensorflow: is crashing jextract with a stack overflow error.
>>>>
>>>> ```
>>>>     Exception in thread "main" java.lang.StackOverflowError
>>>>         at
>>>> jdk.internal.clang/jdk.internal.clang.StructType.<init>(StructType.java:37) 
>>>>         at
>>>> jdk.internal.clang/jdk.internal.clang.StructType.<init>(StructType.java:32) 
>>>>         at 
>>>> jdk.internal.clang/jdk.internal.clang.Type.<init>(Type.java:30)
>>>>         at
>>>> jdk.internal.clang/jdk.internal.clang.Type.canonicalType(Native
>>>> Method)
>>>>         at
>>>> jdk.jextract/com.sun.tools.jextract.TypeDictionary.getInternal(TypeDictionary.java:134) 
>>>>         at
>>>> jdk.jextract/com.sun.tools.jextract.TypeDictionary.getInternal(TypeDictionary.java:134) 
>>>>         at
>>>> jdk.jextract/com.sun.tools.jextract.TypeDictionary.getInternal(TypeDictionary.java:134) 
>>>>         at
>>>> jdk.jextract/com.sun.tools.jextract.TypeDictionary.getInternal(TypeDictionary.java:134) 
>>>>         ...
>>>> ```
>>>>
>>>> FWIW, you made a note about needing to pass `-C -c -C c++` to jextract
>>>> so it doesn't interpret some methods as varargs. I've tried without
>>>> those flags and am observing the same vararg problem, but in that case
>>>> extraction does succeed.
>>>>
>>>> The other libraries libproc, readline, and unistd don't seem
>>>> applicable to Windows. I will be on the lookout for Windows specific
>>>> examples that could be interesting.
>>>>
>>>> The `make update-build-doc` does not work on windows [1], so I ask
>>>> that you generate the .html dos for me instead.
>>>>
>>>> Here is the updated panama_foreign.md:
>>>> http://cr.openjdk.java.net/~jvernee/panama/panama_foreign.md
>>>>
>>>> Jorn
>>>>
>>>> [1] : 
>>>> https://mail.openjdk.java.net/pipermail/build-dev/2019-January/024666.html