Update javadocs README with proxy info. Add some eclipse setting files to .gitignore

This commit is contained in:
Joe Di Pol
2019-01-08 10:00:09 -08:00
committed by Joe DiPol
parent 5c7a36440a
commit 6e37bb930e
2 changed files with 25 additions and 0 deletions

2
.gitignore vendored
View File

@@ -22,3 +22,5 @@ node/
*.swp
.gradle/
build/
.project
.settings/

View File

@@ -15,3 +15,26 @@ When building locally against SNAPSHOT, you can generate the `sources.jar` for
$ mvn install -Psources
$ cd javadocs ; mvn generate-sources
```
## Resolving links behind proxy
If you are behind a proxy and get errors from javadoc that it can't
resolve links then you need to pass your proxy settings to javadoc.
One easy way to do this is to use the `JAVA_TOOL_OPTIONS` environment
variable to set the http proxy Java system properties.
If you've already set these system properties in `MAVEN_OPTS`:
```bash
echo $MAVEN_OPTS
-Dhttp.proxyHost=yourproxy.com -Dhttp.proxyPort=80
-Dhttp.nonProxyHosts=127.0.0.1|localhost|yourdomain.com
-Dhttps.proxyHost=yourproxy.com -Dhttps.proxyPort=80
-Dhttps.nonProxyHosts=127.0.0.1|localhost|yourdomain.com
```
then you can just do:
```bash
export JAVA_TOOL_OPTIONS="${MAVEN_OPTS}"
```