comparison src/org/tmatesoft/hg/repo/HgRuntimeException.java @ 425:48f993aa2f41

FIXMEs: exceptions, javadoc
author Artem Tikhomirov <tikhomirov.artem@gmail.com>
date Wed, 28 Mar 2012 18:39:29 +0200
parents 9c9c442b5f2e
children 31a89587eb04
comparison
equal deleted inserted replaced
424:6437d261048a 425:48f993aa2f41
14 * the terms of a license other than GNU General Public License 14 * the terms of a license other than GNU General Public License
15 * contact TMate Software at support@hg4j.com 15 * contact TMate Software at support@hg4j.com
16 */ 16 */
17 package org.tmatesoft.hg.repo; 17 package org.tmatesoft.hg.repo;
18 18
19 import org.tmatesoft.hg.core.HgException;
19 import org.tmatesoft.hg.core.Nodeid; 20 import org.tmatesoft.hg.core.Nodeid;
20 import org.tmatesoft.hg.internal.ExceptionInfo; 21 import org.tmatesoft.hg.internal.ExceptionInfo;
21 import org.tmatesoft.hg.util.Path; 22 import org.tmatesoft.hg.util.Path;
22 23
23 /** 24 /**
24 * Almost any method in Hg4J low-level API may throw subclass of this exception to indicate unexpected 25 * Almost any method in <b>Hg4J</b> low-level API (@link org.tmatesoft.hg.repo} may throw subclass of this exception
25 * state/condition encountered, flawed data or IO error. Since most cases can't be handled in a reasonable 26 * to indicate unexpected state/condition encountered, flawed data or IO error.
26 * manner (other than catch all exceptions and tell client something went wrong), and propagating all possible 27 * Since most cases can't be handled in a reasonable manner (other than catch all exceptions and tell client
27 * exceptions up through API is dubious task, low-level exceptions are made runtime, rooting at this single class. 28 * something went wrong), and propagating all possible exceptions up through API is dubious task, low-level
29 * exceptions are made runtime, rooting at this single class.
28 * 30 *
29 * <p>Hi-level api, {@link org.tmatesoft.hg.core}, where interaction with user-supplied values is more explicit, 31 * <p>Hi-level api, {@link org.tmatesoft.hg.core}, where interaction with user-supplied values is more explicit,
30 * may follow different exception strategy. 32 * may follow different exception strategy.
31 * 33 *
34 * @see HgException
32 * @author Artem Tikhomirov 35 * @author Artem Tikhomirov
33 * @author TMate Software Ltd. 36 * @author TMate Software Ltd.
34 */ 37 */
35 @SuppressWarnings("serial") 38 @SuppressWarnings("serial")
36 public abstract class HgRuntimeException extends RuntimeException { 39 public abstract class HgRuntimeException extends RuntimeException {