port/path/to/repos/dirA", and
target
may be
"dirB"
.
If target
is null or empty (""
) then the scope of the diff operation is the repository location to which this object is set.
The reporter
is used to describe the state of the target item(s) (i.e. items' revision numbers). All the paths described by the reporter
should be relative to the repository location to which this object is set.
After that the editor
is used to carry out all the work on evaluating differences against url
. This editor
contains knowledge of where the change will begin (when {@link ISVNEditor#openRoot(long) ISVNEditor.openRoot()} is called).
If ignoreAncestry
is false then the ancestry of the paths being diffed is taken into consideration - they are treated as related. In this case, for example, if calculating differences between two files with identical contents but different ancestry, the entire contents of the target file is considered as having been removed and added again.
If ignoreAncestry
is true then the two paths are merely compared ignoring the ancestry.
NOTE: you may not invoke methods of this SVNRepository object from within the provided reporter
and editor
.
This method is analogous to
diff(url, targetRevision, revision, target, ignoreAncestry, SVNDepth.fromRecurse(recursive), getContents, reporter, editor)
.
@param url a repository location of the entry against which differences are calculated
@param targetRevision a revision number of the entry located at the specified
url
; defaults to the latest revision (HEAD) if this arg is invalid
@param revision a revision number of the repository location to which this driver object is set
@param target a target entry name (optional)
@param ignoreAncestry if
true thenthe ancestry of the two entries to be diffed is ignored, otherwise not
@param recursive if
true and the diff scopeis a directory, descends recursively, otherwise not
@param getContents if
false contents (diff windows) will not be sent to the editor.
@param reporter a caller's reporter
@param editor a caller's editor
@throws SVNException in the following cases:
url
not found neither in the specified revision
nor in the HEAD revision - a failure occured while connecting to a repository
- the user authentication failed (see {@link org.tmatesoft.svn.core.SVNAuthenticationException})
@deprecated use {@link #diff(SVNURL,long,long,String,boolean,SVNDepth,boolean,ISVNReporterBaton,ISVNEditor)}instead