Improve documentation of PathSuffixFilter

Change-Id: I1077dbb1f10c7cc687c0d1b8a8e8f763ca96977c
Signed-off-by: Robin Stocker <robin@nibor.org>
Signed-off-by: Chris Aniszczyk <caniszczyk@gmail.com>
This commit is contained in:
Robin Stocker 2013-07-15 17:20:53 +02:00 committed by Chris Aniszczyk
parent 06dd0e9e27
commit 7033179440
1 changed files with 11 additions and 3 deletions

View File

@ -52,17 +52,25 @@
import org.eclipse.jgit.treewalk.TreeWalk;
/**
* Includes tree entries only if they match the configured path.
* Includes tree entries only if they end with the configured path (suffix
* match).
* <p>
* For example, <code>PathSuffixFilter.create(".txt")</code> will match all
* paths ending in <code>.txt</code>.
* <p>
* Using this filter is recommended instead of filtering the entries using
* {@link TreeWalk#getPathString()} and <code>endsWith</code> or some other type
* of string match function.
*/
public class PathSuffixFilter extends TreeFilter {
/**
* Create a new tree filter for a user supplied path.
* Create a new tree filter for a user supplied path suffix.
* <p>
* Path strings use '/' to delimit directories on all platforms.
*
* @param path
* the path (suffix) to filter on. Must not be the empty string.
* the path suffix to filter on. Must not be the empty string.
* @return a new filter for the requested path.
* @throws IllegalArgumentException
* the path supplied was the empty string.