Skip to content

Commit

Permalink
Site checkin for project japicmp-base
Browse files Browse the repository at this point in the history
  • Loading branch information
siom79 committed Jul 21, 2024
1 parent 24020bd commit 449f4e5
Show file tree
Hide file tree
Showing 591 changed files with 9,281 additions and 8,602 deletions.
53 changes: 29 additions & 24 deletions AntTask.html
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/AntTask.md at 2024-05-03
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/AntTask.md at 2024-07-21
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="Date-Revision-yyyymmdd" content="20240503" />
<meta name="Date-Revision-yyyymmdd" content="20240721" />
<meta http-equiv="Content-Language" content="en" />
<title>japicmp-base &#x2013; Ant Task</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
Expand All @@ -34,8 +34,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://siom79.github.io/japicmp" class="externalLink" title="japicmp">japicmp</a><span class="divider">/</span></li>
<li class="active ">Ant Task</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-03</li>
<li id="projectVersion" class="pull-right">Version: 0.21.3-SNAPSHOT</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-07-21</li>
<li id="projectVersion" class="pull-right">Version: 0.22.0</li>
</ul>
</div>
<div class="row-fluid">
Expand Down Expand Up @@ -153,106 +153,111 @@ <h2><a name="Advanced_Usage"></a>Advanced Usage</h2>
<td>false</td>
<td>If true, report only filenames (not full paths).</td></tr>
<tr class="b">
<td align="left">reportOnlySummary</td>
<td>true</td>
<td>false</td>
<td>If true, report only a breakdown of classes and their status when generating plain text or html reports.</td></tr>
<tr class="a">
<td align="left">ignoreMissingClasses</td>
<td>true</td>
<td>n.a.</td>
<td>Ignore all superclasses/interfaces missing on the classpath.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">ignoreMissingClassesbyRegularExpressions</td>
<td>true</td>
<td>n.a.</td>
<td>Ignore only those superclasses/interface missing on the classpath that are selected by a regular expression.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">accessModifier</td>
<td>true</td>
<td>protected</td>
<td>Ignore changes below the access modifier level (public, package, protected, private).</td></tr>
<tr class="a">
<tr class="b">
<td align="left">oldClassPath</td>
<td>true</td>
<td>n.a.</td>
<td>Classpath for the dependencies of the old version.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">newClassPath</td>
<td>true</td>
<td>n.a.</td>
<td>Classpath for the dependencies of the new version.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">oldClassPathRef</td>
<td>true</td>
<td>n.a.</td>
<td>Classpath reference for the dependencies of the old version.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">newClassPathRef</td>
<td>true</td>
<td>n.a.</td>
<td>Classpath reference for the dependencies of the new version.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">includes</td>
<td>true</td>
<td>n.a.</td>
<td>Semicolon separated list of elements to include in the form <code>package.Class#classMember</code>, <code>*</code> can be used as wildcard. Annotations are given as FQN starting with <code>@</code>. Examples: <code>mypackage;my.Class;other.Class#method(int,long);foo.Class#field;@my.Annotation</code>.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">excludes</td>
<td>true</td>
<td>n.a.</td>
<td>Semicolon separated list of elements to exclude in the form <code>package.Class#classMember</code>, <code>*</code> can be used as wildcard. Annotations are given as FQN starting with <code>@</code>. Examples: <code>mypackage;my.Class;other.Class#method(int,long);foo.Class#field;@my.Annotation</code>.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">includeExclusively</td>
<td>true</td>
<td>false</td>
<td>Include only packages specified in the &#x201c;includes&#x201d; parameter, exclude their sub-packages.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">excludeExclusively</td>
<td>true</td>
<td>false</td>
<td>Exclude only packages specified in the &#x201c;excludes&#x201d; parameter, include their sub-packages.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">xmlOutputFile</td>
<td>true</td>
<td>n.a.</td>
<td>Path to the xml output file.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">htmlOutputFile</td>
<td>true</td>
<td>n.a.</td>
<td>Path to the html output file.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">htmlStylesheet</td>
<td>true</td>
<td>n.a.</td>
<td>Path to your own stylesheet.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">errorOnBinaryIncompatibility</td>
<td>true</td>
<td>false</td>
<td>Exit with an error if a binary incompatibility is detected.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">errorOnSourceIncompatibility</td>
<td>true</td>
<td>false</td>
<td>Exit with an error if a source incompatibility is detected.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">errorOnModifications</td>
<td>true</td>
<td>false</td>
<td>Exit with an error if any change between versions is detected.</td></tr>
<tr class="a">
<tr class="b">
<td align="left">errorOnExclusionIncompatibility</td>
<td>true</td>
<td>false</td>
<td>Ignore incompatible changes caused by an excluded class.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">errorOnSemanticIncompatibility</td>
<td>true</td>
<td>false</td>
<td>Exit with an error if the binary compatibility changes are inconsistent with Semantic Versioning. This expects versions of the form Major.Minor.Patch (e.g. 1.2.3 or 1.2.3-SNAPSHOT).</td></tr>
<tr class="a">
<tr class="b">
<td align="left">ignoreMissingOldVersion</td>
<td>true</td>
<td>false</td>
<td>When errorOnSemanticIncompatibility is true, ignore non-resolvable artifacts for the old version.</td></tr>
<tr class="b">
<tr class="a">
<td align="left">ignoreMissingNewVersion</td>
<td>true</td>
<td>false</td>
Expand Down
21 changes: 13 additions & 8 deletions CliTool.html
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/CliTool.md at 2024-05-03
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/CliTool.md at 2024-07-21
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="Date-Revision-yyyymmdd" content="20240503" />
<meta name="Date-Revision-yyyymmdd" content="20240721" />
<meta http-equiv="Content-Language" content="en" />
<title>japicmp-base &#x2013; CLI-Tool</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
Expand All @@ -34,8 +34,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://siom79.github.io/japicmp" class="externalLink" title="japicmp">japicmp</a><span class="divider">/</span></li>
<li class="active ">CLI-Tool</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-03</li>
<li id="projectVersion" class="pull-right">Version: 0.21.3-SNAPSHOT</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-07-21</li>
<li id="projectVersion" class="pull-right">Version: 0.22.0</li>
</ul>
</div>
<div class="row-fluid">
Expand Down Expand Up @@ -75,7 +75,8 @@ <h1>CLI-Tool</h1>
[(-n &lt;pathToNewVersionJar&gt; | --new &lt;pathToNewVersionJar&gt;)]
[--new-classpath &lt;newClassPath&gt;] [--no-annotations]
[(-o &lt;pathToOldVersionJar&gt; | --old &lt;pathToOldVersionJar&gt;)]
[--old-classpath &lt;oldClassPath&gt;] [--report-only-filename]
[--old-classpath &lt;oldClassPath&gt;]
[--report-only-filename] [--report-only-summary]
[(-s | --semantic-versioning)]
[(-x &lt;pathToXmlOutputFile&gt; | --xml-file &lt;pathToXmlOutputFile&gt;)]
[--error-on-binary-incompatibility]
Expand Down Expand Up @@ -157,6 +158,10 @@ <h1>CLI-Tool</h1>
--report-only-filename
Reports just filenames (not full paths) in report description.

--report-only-summary
Reports only a breakdown of classes and their status
when generating plain text or html reports.

-s, --semantic-versioning
Tells you which part of the version to increment.

Expand Down Expand Up @@ -196,16 +201,16 @@ <h1>CLI-Tool</h1>
<p>When your library implements interfaces or extends classes from other libraries than the JDK and you want to evaluate binary
compatibility you must specify the classpath for the two different versions:</p>

<div class="source"><pre class="prettyprint"><code>java -jar japicmp-0.21.2-jar-with-dependencies.jar -n new-version.jar -o old-version.jar --new-classpath other-library-v2.jar
<div class="source"><pre class="prettyprint"><code>java -jar japicmp-0.22.0-jar-with-dependencies.jar -n new-version.jar -o old-version.jar --new-classpath other-library-v2.jar
--old-classpath other-library-v1.jar
</code></pre></div>
<p>In case the classpath for both versions did not change, you can add the library using the standard way:</p>

<div class="source"><pre class="prettyprint"><code>java -cp japicmp-0.21.2-jar-with-dependencies.jar;otherLibrary.jar japicmp.JApiCmp -n new-version.jar -o old-version.jar
<div class="source"><pre class="prettyprint"><code>java -cp japicmp-0.22.0-jar-with-dependencies.jar;otherLibrary.jar japicmp.JApiCmp -n new-version.jar -o old-version.jar
</code></pre></div>
<p>For reporting purposes you can also provide more than one jar as old or new version(s):</p>

<div class="source"><pre class="prettyprint"><code>java -jar japicmp-0.21.2-jar-with-dependencies.jar -o lib1-old.jar;lib2-old.jar -n lib1-new.jar;lib2-new.jar
<div class="source"><pre class="prettyprint"><code>java -jar japicmp-0.22.0-jar-with-dependencies.jar -o lib1-old.jar;lib2-old.jar -n lib1-new.jar;lib2-new.jar
</code></pre></div>
</div>
</div>
Expand Down
8 changes: 4 additions & 4 deletions Examples.html
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/Examples.md at 2024-05-03
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/Examples.md at 2024-07-21
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="Date-Revision-yyyymmdd" content="20240503" />
<meta name="Date-Revision-yyyymmdd" content="20240721" />
<meta http-equiv="Content-Language" content="en" />
<title>japicmp-base &#x2013; Examples</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
Expand All @@ -34,8 +34,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://siom79.github.io/japicmp" class="externalLink" title="japicmp">japicmp</a><span class="divider">/</span></li>
<li class="active ">Examples</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-03</li>
<li id="projectVersion" class="pull-right">Version: 0.21.3-SNAPSHOT</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-07-21</li>
<li id="projectVersion" class="pull-right">Version: 0.22.0</li>
</ul>
</div>
<div class="row-fluid">
Expand Down
Loading

0 comments on commit 449f4e5

Please sign in to comment.