Skip to content

Commit

Permalink
Improve Maven instructions. Fixes typetools#5086.
Browse files Browse the repository at this point in the history
  • Loading branch information
mernst committed Mar 21, 2022
1 parent 7765b28 commit 9e4c766
Showing 1 changed file with 8 additions and 7 deletions.
15 changes: 8 additions & 7 deletions docs/manual/external-tools.tex
Original file line number Diff line number Diff line change
Expand Up @@ -973,18 +973,17 @@
</dependencies>
\end{alltt}

Java 11 and later do not need the \<com.google.errorprone.javac>
Java 11 and later do not need the \<com.google.errorprone:javac>
dependency. If you will never use Java 8, you can omit it.
The need for the \<com.google.errorprone:javac> artifact when running under
JDK 8 is explained in Section~\ref{javac-jdk8}.

Periodically update to the most recent version, to obtain the
latest bug fixes and new features:
\begin{Verbatim}
mvn versions:use-latest-versions -Dincludes="org.checkerframework:*"
\end{Verbatim}

The need for the \<com.google.errorprone:javac> artifact when running under
JDK 8 is explained in Section~\ref{javac-jdk8}.

\end{enumerate}

\item If using JDK 8, use a Maven property to hold the location of the
Expand Down Expand Up @@ -1022,7 +1021,7 @@
creating three new profiles as shown below (the example uses the Nullness
Checker). If your POM file does not already use the
\code{maven-compiler-plugin} plugin, you are done. If your POM file
already uses the plugin, copy edit the first profile to incorporate the
already uses the plugin, copy and edit the first profile to incorporate the
existing configuration.

%% TODO: Is this comment still accurate?
Expand Down Expand Up @@ -1145,7 +1144,7 @@
\end{mysmall}

Now, building with Maven will run the checkers during every compilation
that uses JDK 8 or JDK 11.
that uses JDK 8 or higher.

If you wish to run checkers while compiling your source code but not your
tests, wrap the \code{<configuration>...</configuration>} within
Expand All @@ -1160,8 +1159,10 @@
\end{Verbatim}

To compile without using the Checker Framework, pass
\<-P '!checkerframework-java11'> (or \<-P '!checkerframework-java8'>)
\<-P '!checkerframework>
on the Maven command line.
It should also work to pass
\<-P '!checkerframework-jdk9orlater' or \<-P '!checkerframework-java8'>.

% TODO: Figure out why, and then remove this paragraph.
Warning: adding
Expand Down

0 comments on commit 9e4c766

Please sign in to comment.