1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 2<HTML style="overflow:auto;"> 3<HEAD> 4<meta name="generator" content="JDiff v1.1.0"> 5<!-- Generated by the JDiff Javadoc doclet --> 6<!-- (http://www.jdiff.org) --> 7<meta name="description" content="JDiff is a Javadoc doclet which generates an HTML report of all the packages, classes, constructors, methods, and fields which have been removed, added or changed in any way, including their documentation, when two APIs are compared."> 8<meta name="keywords" content="diff, jdiff, javadiff, java diff, java difference, API difference, difference between two APIs, API diff, Javadoc, doclet"> 9<TITLE> 10JDiff Help 11</TITLE> 12<link href="/assets/android-developer-docs.css" rel="stylesheet" type="text/css" /> 13<link href="/stylesheet-jdiff.css" rel="stylesheet" type="text/css" /> 14<noscript> 15<style type="text/css"> 16body{overflow:auto;} 17#body-content{position:relative; top:0;} 18#doc-content{overflow:visible;border-left:3px solid #666;} 19#side-nav{padding:0;} 20#side-nav .toggle-list ul {display:block;} 21#resize-packages-nav{border-bottom:3px solid #666;} 22</style> 23</noscript> 24<style type="text/css"> 25</style> 26</HEAD> 27<BODY> 28<!-- Start of nav bar --> 29<TABLE summary="Navigation bar" BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"> 30<TR> 31<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 32 <TABLE summary="Navigation bar" BORDER="0" CELLPADDING="0" CELLSPACING="3"> 33 <TR ALIGN="center" VALIGN="top"> 34 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/reference/index.html" target="_top"><FONT CLASS="NavBarFont1"><B><code>5</code></B></FONT></A> </TD> 35 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="changes-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 36 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Package</FONT> </TD> 37 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> 38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="jdiff_statistics.html"><FONT CLASS="NavBarFont1"><B>Statistics</B></FONT></A> </TD> 39 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Help</B></FONT> </TD> 40 </TR> 41 </TABLE> 42</TD> 43<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Generated by<br><a href="http://www.jdiff.org" class="staysblack" target="_top">JDiff</a></b></EM></TD> 44</TR> 45<TR> 46 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell2"><FONT SIZE="-2"></FONT> 47</TD> 48 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell2"><FONT SIZE="-2"> 49 <A HREF="/changes.html" TARGET="_top"><B>FRAMES</B></A> 50 <A HREF="jdiff_help.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD> 51</TR> 52</TABLE> 53<HR> 54<!-- End of nav bar --> 55<center> 56<H1>JDiff Documentation</H1> 57</center> 58<BLOCKQUOTE> 59JDiff is a <a href="http://java.sun.com/j2se/javadoc/" target="_top">Javadoc</a> doclet which generates a report of the API differences between two versions of a product. It does not report changes in Javadoc comments, or changes in what a class or method does. 60This help page describes the different parts of the output from JDiff. 61</BLOCKQUOTE> 62<BLOCKQUOTE> 63 See the reference page in the <a href="http://www.jdiff.org">source for JDiff</a> for information about how to generate a report like this one. 64</BLOCKQUOTE> 65<BLOCKQUOTE> 66The indexes shown in the top-left frame help show each type of change in more detail. The index "All Differences" contains all the differences between the APIs, in alphabetical order. 67These indexes all use the same format: 68<ul> 69<li>Removed packages, classes, constructors, methods and fields are <strike>struck through</strike>.</li> 70<li>Added packages, classes, constructors, methods and fields appear in <b>bold</b>.</li> 71<li>Changed packages, classes, constructors, methods and fields appear in normal text.</li> 72</ul> 73</BLOCKQUOTE> 74<BLOCKQUOTE> 75You can always tell when you are reading a JDiff page, rather than a Javadoc page, by the color of the index bar and the color of the background. 76Links which take you to a Javadoc page are always in a <code>typewriter</code> font. 77Just like Javadoc, all interface names are in <i>italic</i>, and class names are not italicized. Where there are multiple entries in an index with the same name, the heading for them is also in italics, but is not a link. 78</BLOCKQUOTE> 79<BLOCKQUOTE> 80<H3><b><code>Javadoc</code></b></H3> 81This is a link to the <a href="/reference/index.html" target="_top">top-level</a> Javadoc page for the new version of the product. 82</BLOCKQUOTE> 83<BLOCKQUOTE> 84<H3>Overview</H3> 85The <a href="changes-summary.html">overview</a> is the top-level summary of what was removed, added and changed between versions. 86</BLOCKQUOTE> 87<BLOCKQUOTE> 88<H3>Package</H3> 89This is a link to the package containing the current changed class or interface. 90</BLOCKQUOTE> 91<BLOCKQUOTE> 92<H3>Class</H3> 93This is highlighted when you are looking at the changed class or interface. 94</BLOCKQUOTE> 95<BLOCKQUOTE> 96<H3>Text Changes</H3> 97This is a link to the top-level index of all documentation changes for the current package or class. 98If it is not present, then there are no documentation changes for the current package or class. 99This link can be removed entirely by not using the <code>-docchanges</code> option. 100</BLOCKQUOTE> 101<BLOCKQUOTE> 102<H3>Statistics</H3> 103This is a link to a page which shows statistics about the changes between the two APIs. 104This link can be removed entirely by not using the <code>-stats</code> option. 105</BLOCKQUOTE> 106<BLOCKQUOTE> 107<H3>Help</H3> 108A link to this Help page for JDiff. 109</BLOCKQUOTE> 110<BLOCKQUOTE> 111<H3>Prev/Next</H3> 112These links take you to the previous and next changed package or class. 113</BLOCKQUOTE> 114<BLOCKQUOTE> 115<H3>Frames/No Frames</H3> 116These links show and hide the HTML frames. All pages are available with or without frames. 117</BLOCKQUOTE> 118<BLOCKQUOTE> 119<H2>Complex Changes</H2> 120There are some complex changes which can occur between versions, for example, when two or more methods with the same name change simultaneously, or when a method or field is moved into or from a superclass. 121In these cases, the change will be seen as a removal and an addition, rather than as a change. Unexpected removals or additions are often part of one of these type of changes. 122</BLOCKQUOTE> 123<script src="//www.google-analytics.com/ga.js" type="text/javascript"> 124</script> 125<script type="text/javascript"> 126 try { 127 var pageTracker = _gat._getTracker("UA-5831155-1"); 128 pageTracker._setAllowAnchor(true); 129 pageTracker._initData(); 130 pageTracker._trackPageview(); 131 } catch(e) {} 132</script> 133</BODY> 134</HTML> 135