aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSamuel Tardieu <sam@rfc1149.net>2015-02-10 11:47:25 +0100
committerSamuel Tardieu <sam@rfc1149.net>2015-02-10 11:49:09 +0100
commitfa6741ea0b36317d0c141e765d53ee37de72fa1d (patch)
tree2eed082066cd6e35095d9f108296194f939ff1e4
parent7c7ca769d65f5539c44de22948c2f5fb74efdf0c (diff)
downloadcgeo-fa6741ea0b36317d0c141e765d53ee37de72fa1d.zip
cgeo-fa6741ea0b36317d0c141e765d53ee37de72fa1d.tar.gz
cgeo-fa6741ea0b36317d0c141e765d53ee37de72fa1d.tar.bz2
Remove empty JavaDoc @param and @return
-rw-r--r--main/src/cgeo/geocaching/CacheListActivity.java3
-rw-r--r--main/src/cgeo/geocaching/DataStore.java26
-rw-r--r--main/src/cgeo/geocaching/EditWaypointActivity.java1
-rw-r--r--main/src/cgeo/geocaching/ImageSelectActivity.java1
-rw-r--r--main/src/cgeo/geocaching/LogTrackableActivity.java1
-rw-r--r--main/src/cgeo/geocaching/SearchResult.java4
-rw-r--r--main/src/cgeo/geocaching/StaticMapsProvider.java5
-rw-r--r--main/src/cgeo/geocaching/Waypoint.java4
-rw-r--r--main/src/cgeo/geocaching/activity/AbstractViewPagerActivity.java2
-rw-r--r--main/src/cgeo/geocaching/activity/ActivityMixin.java4
-rw-r--r--main/src/cgeo/geocaching/activity/ShowcaseViewBuilder.java1
-rw-r--r--main/src/cgeo/geocaching/apps/AbstractLocusApp.java3
-rw-r--r--main/src/cgeo/geocaching/apps/App.java2
-rw-r--r--main/src/cgeo/geocaching/apps/cache/navi/NavigationAppFactory.java18
-rw-r--r--main/src/cgeo/geocaching/apps/cachelist/MapsWithMeCacheListApp.java1
-rw-r--r--main/src/cgeo/geocaching/connector/ConnectorFactory.java1
-rw-r--r--main/src/cgeo/geocaching/connector/IConnector.java35
-rw-r--r--main/src/cgeo/geocaching/connector/ILoggingManager.java5
-rw-r--r--main/src/cgeo/geocaching/connector/capability/ILogin.java4
-rw-r--r--main/src/cgeo/geocaching/connector/ec/ECLogin.java1
-rw-r--r--main/src/cgeo/geocaching/connector/gc/GCLogin.java8
-rw-r--r--main/src/cgeo/geocaching/connector/gc/GCMap.java3
-rw-r--r--main/src/cgeo/geocaching/connector/gc/Tile.java10
-rw-r--r--main/src/cgeo/geocaching/connector/gc/UTFGridPosition.java1
-rw-r--r--main/src/cgeo/geocaching/connector/gc/UncertainProperty.java1
-rw-r--r--main/src/cgeo/geocaching/connector/oc/IOCAuthParams.java9
-rw-r--r--main/src/cgeo/geocaching/connector/ox/OXGPXParser.java1
-rw-r--r--main/src/cgeo/geocaching/connector/trackable/GeokretyConnector.java2
-rw-r--r--main/src/cgeo/geocaching/enumerations/CacheType.java1
-rw-r--r--main/src/cgeo/geocaching/export/GpxSerializer.java1
-rw-r--r--main/src/cgeo/geocaching/files/AbstractFileListActivity.java1
-rw-r--r--main/src/cgeo/geocaching/files/GPXImporter.java2
-rw-r--r--main/src/cgeo/geocaching/files/GPXParser.java4
-rw-r--r--main/src/cgeo/geocaching/filter/IFilter.java1
-rw-r--r--main/src/cgeo/geocaching/loaders/OfflineGeocacheListLoader.java1
-rw-r--r--main/src/cgeo/geocaching/location/Geopoint.java42
-rw-r--r--main/src/cgeo/geocaching/maps/CGeoMap.java2
-rw-r--r--main/src/cgeo/geocaching/maps/CachesOverlay.java2
-rw-r--r--[-rwxr-xr-x]main/src/cgeo/geocaching/maps/DirectionDrawer.java0
-rw-r--r--[-rwxr-xr-x]main/src/cgeo/geocaching/maps/DistanceDrawer.java0
-rw-r--r--main/src/cgeo/geocaching/settings/AbstractAttributeBasedPrefence.java1
-rw-r--r--main/src/cgeo/geocaching/settings/InfoPreference.java2
-rw-r--r--main/src/cgeo/geocaching/sorting/AbstractCacheComparator.java3
-rw-r--r--main/src/cgeo/geocaching/sorting/EventDateComparator.java3
-rw-r--r--main/src/cgeo/geocaching/ui/AbstractCachingPageViewCreator.java1
-rw-r--r--main/src/cgeo/geocaching/ui/CacheListAdapter.java1
-rw-r--r--main/src/cgeo/geocaching/ui/WeakReferenceHandler.java1
-rw-r--r--main/src/cgeo/geocaching/ui/dialog/Dialogs.java1
-rw-r--r--main/src/cgeo/geocaching/ui/logs/CacheLogsViewCreator.java1
-rw-r--r--main/src/cgeo/geocaching/ui/logs/TrackableLogsViewCreator.java1
-rw-r--r--main/src/cgeo/geocaching/utils/AsyncTaskWithProgress.java13
-rw-r--r--main/src/cgeo/geocaching/utils/DatabaseBackupUtils.java2
-rw-r--r--main/src/cgeo/geocaching/utils/Formatter.java1
-rw-r--r--main/src/cgeo/geocaching/utils/HtmlUtils.java2
-rw-r--r--main/src/cgeo/geocaching/utils/LeastRecentlyUsedMap.java1
-rw-r--r--main/src/cgeo/geocaching/utils/Log.java1
-rw-r--r--main/src/cgeo/geocaching/utils/MatcherWrapper.java2
-rw-r--r--main/src/cgeo/geocaching/utils/ProcessUtils.java4
-rw-r--r--main/src/cgeo/geocaching/utils/TextUtils.java4
59 files changed, 0 insertions, 259 deletions
diff --git a/main/src/cgeo/geocaching/CacheListActivity.java b/main/src/cgeo/geocaching/CacheListActivity.java
index c6cac21..d5e6c92 100644
--- a/main/src/cgeo/geocaching/CacheListActivity.java
+++ b/main/src/cgeo/geocaching/CacheListActivity.java
@@ -1650,8 +1650,6 @@ public class CacheListActivity extends AbstractListActivity implements FilteredA
/**
* Allow the title bar spinner to show the same subtitle like the activity itself would show.
*
- * @param list
- * @return
*/
public CharSequence getCacheListSubtitle(@NonNull final AbstractList list) {
// if this is the current list, be aware of filtering
@@ -1669,7 +1667,6 @@ public class CacheListActivity extends AbstractListActivity implements FilteredA
/**
* Calculate the subtitle of the current list depending on (optional) filters.
*
- * @return
*/
private CharSequence getCurrentSubtitle() {
final ArrayList<String> numbers = new ArrayList<>();
diff --git a/main/src/cgeo/geocaching/DataStore.java b/main/src/cgeo/geocaching/DataStore.java
index 52bf3f9..ff120dd 100644
--- a/main/src/cgeo/geocaching/DataStore.java
+++ b/main/src/cgeo/geocaching/DataStore.java
@@ -402,7 +402,6 @@ public class DataStore {
* Move the database to/from external cgdata in a new thread,
* showing a progress window
*
- * @param fromActivity
*/
public static void moveDatabase(final Activity fromActivity) {
final ProgressDialog dialog = ProgressDialog.show(fromActivity, fromActivity.getString(R.string.init_dbmove_dbmove), fromActivity.getString(R.string.init_dbmove_running), true, false);
@@ -1061,7 +1060,6 @@ public class DataStore {
*
* @param cache
* the Cache to save in the CacheCache/DB
- * @param saveFlags
*
*/
public static void saveCache(final Geocache cache, final Set<LoadFlags.SaveFlag> saveFlags) {
@@ -1073,7 +1071,6 @@ public class DataStore {
*
* @param caches
* the caches to save in the CacheCache/DB
- * @param saveFlags
*
*/
public static void saveCaches(final Collection<Geocache> caches, final Set<LoadFlags.SaveFlag> saveFlags) {
@@ -1312,7 +1309,6 @@ public class DataStore {
/**
* remove all waypoints of the given cache, where the id is not in the given list
*
- * @param cache
* @param remainingWaypointIds
* ids of waypoints which shall not be deleted
*/
@@ -1562,7 +1558,6 @@ public class DataStore {
/**
* Load caches.
*
- * @param geocodes
* @return Set of loaded caches. Never null.
*/
@NonNull
@@ -1618,8 +1613,6 @@ public class DataStore {
/**
* Load caches.
*
- * @param geocodes
- * @param loadFlags
* @return Set of loaded caches. Never null.
*/
@NonNull
@@ -1709,9 +1702,6 @@ public class DataStore {
/**
* Builds a where for a viewport with the size enhanced by 50%.
*
- * @param dbTable
- * @param viewport
- * @return
*/
@NonNull
@@ -1722,7 +1712,6 @@ public class DataStore {
/**
* creates a Cache from the cursor. Doesn't next.
*
- * @param cursor
* @return Cache from DB
*/
@NonNull
@@ -1938,7 +1927,6 @@ public class DataStore {
}
/**
- * @param geocode
* @return an immutable, non null list of logs
*/
@NonNull
@@ -2088,9 +2076,6 @@ public class DataStore {
/**
* Number of caches stored for a given type and/or list
*
- * @param cacheType
- * @param list
- * @return
*/
public static int getAllStoredCachesCount(final CacheType cacheType, final int list) {
if (cacheType == null) {
@@ -2176,8 +2161,6 @@ public class DataStore {
*
* @param coords
* the current coordinates to sort by distance, or null to sort by geocode
- * @param cacheType
- * @param listId
* @return a non-null set of geocodes
*/
@NonNull
@@ -2390,8 +2373,6 @@ public class DataStore {
/**
* remove all geocodes from the given list of geocodes where an offline log exists
*
- * @param geocodes
- * @return
*/
@NonNull
private static Set<String> exceptCachesWithOfflineLog(@NonNull final Set<String> geocodes) {
@@ -2738,7 +2719,6 @@ public class DataStore {
/**
* Remove a list. Caches in the list are moved to the standard list.
*
- * @param listId
* @return true if the list got deleted, false else
*/
public static boolean removeList(final int listId) {
@@ -2830,8 +2810,6 @@ public class DataStore {
/**
* Load the lazily initialized fields of a cache and return them as partial cache (all other fields unset).
*
- * @param geocode
- * @return
*/
@NonNull
public static Geocache loadCacheTexts(final String geocode) {
@@ -2908,10 +2886,6 @@ public class DataStore {
/**
* Loads all Waypoints in the coordinate rectangle.
*
- * @param excludeDisabled
- * @param excludeMine
- * @param type
- * @return
*/
@NonNull
diff --git a/main/src/cgeo/geocaching/EditWaypointActivity.java b/main/src/cgeo/geocaching/EditWaypointActivity.java
index 8cb947a..ce279bf 100644
--- a/main/src/cgeo/geocaching/EditWaypointActivity.java
+++ b/main/src/cgeo/geocaching/EditWaypointActivity.java
@@ -331,7 +331,6 @@ public class EditWaypointActivity extends AbstractActionBarActivity implements C
* @param type
* type to create a new default name for
*
- * @return
*/
private String getDefaultWaypointName(final WaypointType type) {
final ArrayList<String> wpNames = new ArrayList<>();
diff --git a/main/src/cgeo/geocaching/ImageSelectActivity.java b/main/src/cgeo/geocaching/ImageSelectActivity.java
index 26f105e..9d1c1e0 100644
--- a/main/src/cgeo/geocaching/ImageSelectActivity.java
+++ b/main/src/cgeo/geocaching/ImageSelectActivity.java
@@ -293,7 +293,6 @@ public class ImageSelectActivity extends AbstractActionBarActivity {
/**
* Scales and writes the scaled image.
*
- * @param filePath
* @return the scaled image path, or <tt>null</tt> if the image cannot be decoded
*/
@Nullable
diff --git a/main/src/cgeo/geocaching/LogTrackableActivity.java b/main/src/cgeo/geocaching/LogTrackableActivity.java
index fc4a066..5f0b8c5 100644
--- a/main/src/cgeo/geocaching/LogTrackableActivity.java
+++ b/main/src/cgeo/geocaching/LogTrackableActivity.java
@@ -334,7 +334,6 @@ public class LogTrackableActivity extends AbstractLoggingActivity implements Dat
* Adds the new log to the list of log entries for this trackable to be able to show it in the trackable activity.
*
*
- * @param logText
*/
private void addLocalTrackableLog(final String logText) {
final LogEntry logEntry = new LogEntry(date.getTimeInMillis(), typeSelected, logText);
diff --git a/main/src/cgeo/geocaching/SearchResult.java b/main/src/cgeo/geocaching/SearchResult.java
index 2f4471b..5de1298 100644
--- a/main/src/cgeo/geocaching/SearchResult.java
+++ b/main/src/cgeo/geocaching/SearchResult.java
@@ -216,10 +216,6 @@ public class SearchResult implements Parcelable {
}
/**
- * @param excludeDisabled
- * @param excludeMine
- * @param cacheType
- * @return
*/
public SearchResult filterSearchResults(final boolean excludeDisabled, final boolean excludeMine, final CacheType cacheType) {
diff --git a/main/src/cgeo/geocaching/StaticMapsProvider.java b/main/src/cgeo/geocaching/StaticMapsProvider.java
index 6d18cb4..8c399af 100644
--- a/main/src/cgeo/geocaching/StaticMapsProvider.java
+++ b/main/src/cgeo/geocaching/StaticMapsProvider.java
@@ -259,7 +259,6 @@ public final class StaticMapsProvider {
/**
* Check if at least one map file exists for the given cache.
*
- * @param cache
* @return <code>true</code> if at least one map file exists; <code>false</code> otherwise
*/
public static boolean hasStaticMap(@NonNull final Geocache cache) {
@@ -279,8 +278,6 @@ public final class StaticMapsProvider {
/**
* Checks if at least one map file exists for the given geocode and waypoint ID.
*
- * @param geocode
- * @param waypoint
* @return <code>true</code> if at least one map file exists; <code>false</code> otherwise
*/
public static boolean hasStaticMapForWaypoint(final String geocode, final Waypoint waypoint) {
@@ -298,8 +295,6 @@ public final class StaticMapsProvider {
/**
* Checks if all map files exist for the given geocode and waypoint ID.
*
- * @param geocode
- * @param waypoint
* @return <code>true</code> if all map files exist; <code>false</code> otherwise
*/
public static boolean hasAllStaticMapsForWaypoint(final String geocode, final Waypoint waypoint) {
diff --git a/main/src/cgeo/geocaching/Waypoint.java b/main/src/cgeo/geocaching/Waypoint.java
index 5cac4db..cc00b1c 100644
--- a/main/src/cgeo/geocaching/Waypoint.java
+++ b/main/src/cgeo/geocaching/Waypoint.java
@@ -37,8 +37,6 @@ public class Waypoint implements IWaypoint {
/**
* require name and type for every waypoint
*
- * @param name
- * @param type
*/
public Waypoint(final String name, final WaypointType type, final boolean own) {
this.name = name;
@@ -49,7 +47,6 @@ public class Waypoint implements IWaypoint {
/**
* copy constructor
*
- * @param other
*/
public Waypoint(final Waypoint other) {
merge(other);
@@ -262,7 +259,6 @@ public class Waypoint implements IWaypoint {
/**
* Delegates the creation of the waypoint-id for gpx-export to the waypoint
*
- * @return
*/
public String getGpxId() {
diff --git a/main/src/cgeo/geocaching/activity/AbstractViewPagerActivity.java b/main/src/cgeo/geocaching/activity/AbstractViewPagerActivity.java
index 64186a0..11a5436 100644
--- a/main/src/cgeo/geocaching/activity/AbstractViewPagerActivity.java
+++ b/main/src/cgeo/geocaching/activity/AbstractViewPagerActivity.java
@@ -68,14 +68,12 @@ public abstract class AbstractViewPagerActivity<Page extends Enum<Page>> extends
/**
* Returns a validated view.
*
- * @return
*/
public View getDispatchedView(final ViewGroup parentView);
/**
* Returns a (maybe cached) view.
*
- * @return
*/
public View getView(final ViewGroup parentView);
diff --git a/main/src/cgeo/geocaching/activity/ActivityMixin.java b/main/src/cgeo/geocaching/activity/ActivityMixin.java
index ff323e6..e9d3249 100644
--- a/main/src/cgeo/geocaching/activity/ActivityMixin.java
+++ b/main/src/cgeo/geocaching/activity/ActivityMixin.java
@@ -133,8 +133,6 @@ public final class ActivityMixin {
/**
* insert text into the EditText at the current cursor position
*
- * @param editText
- * @param insertText
* @param moveCursor
* place the cursor after the inserted text
*/
@@ -163,8 +161,6 @@ public final class ActivityMixin {
* was created from an intent by another app, and our own app is not yet running. The bug seems to be fixed in
* Android 4.4.something, however.
*
- * @param activity
- * @return
*/
public static boolean navigateUp(@NonNull final Activity activity) {
// see http://developer.android.com/training/implementing-navigation/ancestral.html
diff --git a/main/src/cgeo/geocaching/activity/ShowcaseViewBuilder.java b/main/src/cgeo/geocaching/activity/ShowcaseViewBuilder.java
index 14f9281..86f5302 100644
--- a/main/src/cgeo/geocaching/activity/ShowcaseViewBuilder.java
+++ b/main/src/cgeo/geocaching/activity/ShowcaseViewBuilder.java
@@ -29,7 +29,6 @@ public class ShowcaseViewBuilder extends Builder {
/**
* Use the hash of the title for the single shot remembering
*
- * @param title
*/
private void setSingleshot(final CharSequence title) {
super.singleShot(title.hashCode());
diff --git a/main/src/cgeo/geocaching/apps/AbstractLocusApp.java b/main/src/cgeo/geocaching/apps/AbstractLocusApp.java
index 9f39604..dfd148d 100644
--- a/main/src/cgeo/geocaching/apps/AbstractLocusApp.java
+++ b/main/src/cgeo/geocaching/apps/AbstractLocusApp.java
@@ -51,7 +51,6 @@ public abstract class AbstractLocusApp extends AbstractApp {
* which caches/waypoints to show
* @param withCacheWaypoints
* Whether to give waypoints of caches to Locus or not
- * @param activity
*/
protected static boolean showInLocus(final List<?> objectsToShow, final boolean withCacheWaypoints, final boolean export,
final Activity activity) {
@@ -94,7 +93,6 @@ public abstract class AbstractLocusApp extends AbstractApp {
/**
* This method constructs a <code>Point</code> for displaying in Locus
*
- * @param cache
* @param withWaypoints
* whether to give waypoints to Locus or not
* @param withCacheDetails
@@ -184,7 +182,6 @@ public abstract class AbstractLocusApp extends AbstractApp {
/**
* This method constructs a <code>Point</code> for displaying in Locus
*
- * @param waypoint
* @return null, when the <code>Point</code> could not be constructed
*/
@Nullable
diff --git a/main/src/cgeo/geocaching/apps/App.java b/main/src/cgeo/geocaching/apps/App.java
index db306ac..1383809 100644
--- a/main/src/cgeo/geocaching/apps/App.java
+++ b/main/src/cgeo/geocaching/apps/App.java
@@ -23,8 +23,6 @@ public interface App {
/**
* Whether or not the app can be used with the given cache (may depend on properties of the cache).
*
- * @param cache
- * @return
*/
boolean isEnabled(final Geocache cache);
}
diff --git a/main/src/cgeo/geocaching/apps/cache/navi/NavigationAppFactory.java b/main/src/cgeo/geocaching/apps/cache/navi/NavigationAppFactory.java
index d542541..48fe754 100644
--- a/main/src/cgeo/geocaching/apps/cache/navi/NavigationAppFactory.java
+++ b/main/src/cgeo/geocaching/apps/cache/navi/NavigationAppFactory.java
@@ -117,10 +117,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
* Delegates to {@link #showNavigationMenu(Activity, cgeo.geocaching.Geocache, cgeo.geocaching.Waypoint, Geopoint, boolean, boolean)} with
* <code>showInternalMap = true</code> and <code>showDefaultNavigation = false</code>
*
- * @param activity
- * @param cache
- * @param waypoint
- * @param destination
*/
public static void showNavigationMenu(final Activity activity,
final Geocache cache, final Waypoint waypoint, final Geopoint destination) {
@@ -131,7 +127,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
* Specialized way to handle selection of navigation tool.<br />
* A dialog is created for tool selection and the selected tool is started afterwards.
*
- * @param activity
* @param cache
* may be <code>null</code>
* @param waypoint
@@ -196,7 +191,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
/**
* Returns all installed navigation apps.
*
- * @return
*/
static List<NavigationAppsEnum> getInstalledNavigationApps() {
final List<NavigationAppsEnum> installedNavigationApps = new ArrayList<>();
@@ -224,7 +218,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
/**
* Returns all installed navigation apps for default navigation.
*
- * @return
*/
public static List<NavigationAppsEnum> getInstalledDefaultNavigationApps() {
final List<NavigationAppsEnum> installedNavigationApps = new ArrayList<>();
@@ -240,10 +233,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
* Handles menu selections for menu entries created with
* {@link #showNavigationMenu(Activity, Geocache, Waypoint, Geopoint)}.
*
- * @param item
- * @param activity
- * @param cache
- * @return
*/
public static boolean onMenuItemSelected(final MenuItem item, final Activity activity, final Geocache cache) {
final App menuItem = getAppFromMenuItem(item);
@@ -286,10 +275,7 @@ public final class NavigationAppFactory extends AbstractAppFactory {
/**
* Starts the default navigation tool if correctly set and installed or the compass app as default fallback.
*
- * @param defaultNavigation
*
- * @param activity
- * @param cache
*/
public static void startDefaultNavigationApplication(final int defaultNavigation, final Activity activity, final Geocache cache) {
if (cache == null || cache.getCoords() == null) {
@@ -310,8 +296,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
/**
* Starts the default navigation tool if correctly set and installed or the compass app as default fallback.
*
- * @param activity
- * @param waypoint
*/
public static void startDefaultNavigationApplication(final int defaultNavigation, final Activity activity, final Waypoint waypoint) {
if (waypoint == null || waypoint.getCoords() == null) {
@@ -324,8 +308,6 @@ public final class NavigationAppFactory extends AbstractAppFactory {
/**
* Starts the default navigation tool if correctly set and installed or the compass app as default fallback.
*
- * @param activity
- * @param destination
*/
public static void startDefaultNavigationApplication(final int defaultNavigation, final Activity activity, final Geopoint destination) {
if (destination == null) {
diff --git a/main/src/cgeo/geocaching/apps/cachelist/MapsWithMeCacheListApp.java b/main/src/cgeo/geocaching/apps/cachelist/MapsWithMeCacheListApp.java
index c6c7709..ed64d2d 100644
--- a/main/src/cgeo/geocaching/apps/cachelist/MapsWithMeCacheListApp.java
+++ b/main/src/cgeo/geocaching/apps/cachelist/MapsWithMeCacheListApp.java
@@ -45,7 +45,6 @@ public class MapsWithMeCacheListApp extends AbstractApp implements CacheListApp
/**
* get cache code from a PendingIntent after an invocation of MapsWithMe
*
- * @return
*/
@Nullable
public static String getCacheFromMapsWithMe(final Context context, final Intent intent) {
diff --git a/main/src/cgeo/geocaching/connector/ConnectorFactory.java b/main/src/cgeo/geocaching/connector/ConnectorFactory.java
index 10417d2..71473b6 100644
--- a/main/src/cgeo/geocaching/connector/ConnectorFactory.java
+++ b/main/src/cgeo/geocaching/connector/ConnectorFactory.java
@@ -235,7 +235,6 @@ public final class ConnectorFactory {
/**
* Get the geocode of a trackable from a URL.
*
- * @param url
* @return {@code null} if the URL cannot be decoded
*/
@Nullable
diff --git a/main/src/cgeo/geocaching/connector/IConnector.java b/main/src/cgeo/geocaching/connector/IConnector.java
index dc4bb6a..74b1028 100644
--- a/main/src/cgeo/geocaching/connector/IConnector.java
+++ b/main/src/cgeo/geocaching/connector/IConnector.java
@@ -15,7 +15,6 @@ public interface IConnector {
/**
* get name for display (currently only used in links)
*
- * @return
*/
@NonNull
public String getName();
@@ -32,8 +31,6 @@ public interface IConnector {
/**
* Get the browser URL for the given cache.
*
- * @param cache
- * @return
*/
@Nullable
public String getCacheUrl(final @NonNull Geocache cache);
@@ -41,8 +38,6 @@ public interface IConnector {
/**
* get long browser URL for the given cache
*
- * @param cache
- * @return
*/
@Nullable
public String getLongCacheUrl(final @NonNull Geocache cache);
@@ -50,14 +45,12 @@ public interface IConnector {
/**
* enable/disable watchlist controls in cache details
*
- * @return
*/
public boolean supportsWatchList();
/**
* Add the cache to the watchlist
*
- * @param cache
* @return True - success/False - failure
*/
public boolean addToWatchlist(@NonNull Geocache cache);
@@ -65,7 +58,6 @@ public interface IConnector {
/**
* Remove the cache from the watchlist
*
- * @param cache
* @return True - success/False - failure
*/
public boolean removeFromWatchlist(@NonNull Geocache cache);
@@ -73,28 +65,24 @@ public interface IConnector {
/**
* enable/disable favorite points controls in cache details
*
- * @return
*/
public boolean supportsFavoritePoints(@NonNull final Geocache cache);
/**
* enable/disable logging controls in cache details
*
- * @return
*/
public boolean supportsLogging();
/**
* enable/disable attaching image to log
*
- * @return
*/
public boolean supportsLogImages();
/**
* Get an ILoggingManager to guide the logging process.
*
- * @return
*/
@NonNull
public ILoggingManager getLoggingManager(@NonNull final LogCacheActivity activity, @NonNull final Geocache cache);
@@ -102,7 +90,6 @@ public interface IConnector {
/**
* Get host name of the connector server for dynamic loading of data.
*
- * @return
*/
@NonNull
public String getHost();
@@ -110,8 +97,6 @@ public interface IConnector {
/**
* Get cache data license text. This is displayed somewhere near the cache details.
*
- * @param cache
- * @return
*/
@NonNull
public String getLicenseText(final @NonNull Geocache cache);
@@ -119,8 +104,6 @@ public interface IConnector {
/**
* return true if this is a ZIP file containing a GPX file
*
- * @param fileName
- * @return
*/
public boolean isZippedGPXFile(@NonNull final String fileName);
@@ -129,15 +112,12 @@ public interface IConnector {
*
* @param cacheHasReliableLatLon
* flag of the cache
- * @return
*/
public boolean isReliableLatLon(boolean cacheHasReliableLatLon);
/**
* extract a geocode from the given URL, if this connector can handle that URL somehow
*
- * @param url
- * @return
*/
@Nullable
public String getGeocodeFromUrl(@NonNull final String url);
@@ -152,7 +132,6 @@ public interface IConnector {
/**
* Uploading personal note to website
*
- * @param cache
* @return success
*/
public boolean uploadPersonalNote(@NonNull Geocache cache);
@@ -167,7 +146,6 @@ public interface IConnector {
/**
* Resetting of modified coordinates on website to details
*
- * @param cache
* @return success
*/
public boolean deleteModifiedCoordinates(@NonNull Geocache cache);
@@ -175,8 +153,6 @@ public interface IConnector {
/**
* Uploading modified coordinates to website
*
- * @param cache
- * @param wpt
* @return success
*/
public boolean uploadModifiedCoordinates(@NonNull Geocache cache, @NonNull Geopoint wpt);
@@ -185,7 +161,6 @@ public interface IConnector {
* Return {@code true} if this connector is active for online interaction (download details, do searches, ...). If
* this is {@code false}, the connector will still be used for already stored offline caches.
*
- * @return
*/
public boolean isActive();
@@ -202,8 +177,6 @@ public interface IConnector {
* Check if the cache information is complete enough to be
* able to log online.
*
- * @param geocache
- * @return
*/
public boolean canLog(@NonNull Geocache geocache);
@@ -220,8 +193,6 @@ public interface IConnector {
* Get the list of <b>potentially</b> possible log types for a cache. Those may still be filtered further during the
* actual logging activity.
*
- * @param geocache
- * @return
*/
@NonNull
public List<LogType> getPossibleLogTypes(@NonNull Geocache geocache);
@@ -230,16 +201,12 @@ public interface IConnector {
* Get the GPX id for a waypoint when exporting. For some connectors there is an inherent name logic,
* for others its just the 'prefix'.
*
- * @param prefix
- * @return
*/
public String getWaypointGpxId(String prefix, @NonNull String geocode);
/**
* Get the 'prefix' (key) for a waypoint from the 'name' in the GPX file
*
- * @param name
- * @return
*/
@NonNull
public String getWaypointPrefix(String name);
@@ -247,14 +214,12 @@ public interface IConnector {
/**
* Get the maximum value for Terrain
*
- * @return
*/
public int getMaxTerrain();
/**
* Get a user readable collection of all online features of this connector.
*
- * @return
*/
@NonNull
public Collection<String> getCapabilities();
diff --git a/main/src/cgeo/geocaching/connector/ILoggingManager.java b/main/src/cgeo/geocaching/connector/ILoggingManager.java
index 40a5377..2b0a067 100644
--- a/main/src/cgeo/geocaching/connector/ILoggingManager.java
+++ b/main/src/cgeo/geocaching/connector/ILoggingManager.java
@@ -16,13 +16,8 @@ public interface ILoggingManager {
/**
* Post a log for a cache online
*
- * @param logType
- * @param date
- * @param log
* @param logPassword
* optional, maybe null
- * @param trackableLogs
- * @return
*/
@NonNull
LogResult postLog(@NonNull LogType logType,
diff --git a/main/src/cgeo/geocaching/connector/capability/ILogin.java b/main/src/cgeo/geocaching/connector/capability/ILogin.java
index 003ccf4..437eec8 100644
--- a/main/src/cgeo/geocaching/connector/capability/ILogin.java
+++ b/main/src/cgeo/geocaching/connector/capability/ILogin.java
@@ -27,14 +27,12 @@ public interface ILogin extends IConnector {
/**
* Returns the status of the last {@link #login(Handler, Context)} request.
*
- * @return
*/
boolean isLoggedIn();
/**
* User-centered string describing the current login/connection status
*
- * @return
*/
String getLoginStatusString();
@@ -42,7 +40,6 @@ public interface ILogin extends IConnector {
* Name the user has in this connector or empty string if not applicable.
* It might be necessary to execute {@link #login(Handler, Context)} before this information is valid.
*
- * @return
*/
String getUserName();
@@ -51,7 +48,6 @@ public interface ILogin extends IConnector {
* Normally retrieved/updated with {@link #login(Handler, Context)}.
* Might be stale as changes on the connectors site are generally not notified.
*
- * @return
*/
int getCachesFound();
diff --git a/main/src/cgeo/geocaching/connector/ec/ECLogin.java b/main/src/cgeo/geocaching/connector/ec/ECLogin.java
index 3ae8298..94b450b 100644
--- a/main/src/cgeo/geocaching/connector/ec/ECLogin.java
+++ b/main/src/cgeo/geocaching/connector/ec/ECLogin.java
@@ -88,7 +88,6 @@ public class ECLogin extends AbstractLogin {
/**
* Check if the user has been logged in when he retrieved the data.
*
- * @param data
* @return <code>true</code> if user is logged in, <code>false</code> otherwise
*/
private boolean getLoginStatus(@Nullable final String data) {
diff --git a/main/src/cgeo/geocaching/connector/gc/GCLogin.java b/main/src/cgeo/geocaching/connector/gc/GCLogin.java
index 035176b..71c31c1 100644
--- a/main/src/cgeo/geocaching/connector/gc/GCLogin.java
+++ b/main/src/cgeo/geocaching/connector/gc/GCLogin.java
@@ -166,7 +166,6 @@ public class GCLogin extends AbstractLogin {
/**
* Check if the user has been logged in when he retrieved the data.
*
- * @param page
* @return <code>true</code> if user is logged in, <code>false</code> otherwise
*/
boolean getLoginStatus(@Nullable final String page) {
@@ -412,8 +411,6 @@ public class GCLogin extends AbstractLogin {
/**
* POST HTTP request. Do the request a second time if the user is not logged in
*
- * @param uri
- * @return
*/
String postRequestLogged(final String uri, final Parameters params) {
final String data = Network.getResponseData(Network.postRequest(uri, params));
@@ -433,9 +430,6 @@ public class GCLogin extends AbstractLogin {
/**
* GET HTTP request. Do the request a second time if the user is not logged in
*
- * @param uri
- * @param params
- * @return
*/
@Nullable
String getRequestLogged(@NonNull final String uri, @Nullable final Parameters params) {
@@ -459,8 +453,6 @@ public class GCLogin extends AbstractLogin {
* Unfortunately the cache details page contains user generated whitespace in the personal note, therefore we cannot
* remove the white space from cache details pages.
*
- * @param uri
- * @return
*/
private static boolean canRemoveWhitespace(final String uri) {
return !StringUtils.contains(uri, "cache_details");
diff --git a/main/src/cgeo/geocaching/connector/gc/GCMap.java b/main/src/cgeo/geocaching/connector/gc/GCMap.java
index 1571faa..5d59613 100644
--- a/main/src/cgeo/geocaching/connector/gc/GCMap.java
+++ b/main/src/cgeo/geocaching/connector/gc/GCMap.java
@@ -226,7 +226,6 @@ public class GCMap {
* Area to search
* @param tokens
* Live map tokens
- * @return
*/
@NonNull
public static SearchResult searchByViewport(final Viewport viewport, final MapTokens tokens) {
@@ -257,7 +256,6 @@ public class GCMap {
* Live map tokens
* @param strategy
* Strategy for data retrieval and parsing, @see Strategy
- * @return
*/
@NonNull
private static SearchResult searchByViewport(final Viewport viewport, final MapTokens tokens, final Strategy strategy) {
@@ -360,7 +358,6 @@ public class GCMap {
*
* @param typeToDisplay
* - cache type to omit from exclusion list so it gets displayed
- * @return
*
* cache types for live map filter:
* 2 = traditional, 9 = ape, 5 = letterbox
diff --git a/main/src/cgeo/geocaching/connector/gc/Tile.java b/main/src/cgeo/geocaching/connector/gc/Tile.java
index 18d296d..dd6371b 100644
--- a/main/src/cgeo/geocaching/connector/gc/Tile.java
+++ b/main/src/cgeo/geocaching/connector/gc/Tile.java
@@ -143,7 +143,6 @@ public class Tile {
* First point
* @param right
* Second point
- * @return
*/
static int calcZoomLon(final Geopoint left, final Geopoint right, final int numberOfTiles) {
@@ -176,7 +175,6 @@ public class Tile {
* First point
* @param top
* Second point
- * @return
*/
static int calcZoomLat(final Geopoint bottom, final Geopoint top, final int numberOfTiles) {
@@ -207,8 +205,6 @@ public class Tile {
* Calculates the inverted hyperbolic sine
* (after Bronstein, Semendjajew: Taschenbuch der Mathematik)
*
- * @param x
- * @return
*/
private static double asinh(final double x) {
return Math.log(x + Math.sqrt(x * x + 1.0));
@@ -280,8 +276,6 @@ public class Tile {
* Calculate needed tiles for the given viewport to cover it with
* max 2x2 tiles
*
- * @param viewport
- * @return
*/
protected static Set<Tile> getTilesForViewport(final Viewport viewport) {
return getTilesForViewport(viewport, 2, Tile.ZOOMLEVEL_MIN);
@@ -292,10 +286,6 @@ public class Tile {
* You can define the minimum number of tiles on the longer axis
* and/or the minimum zoom level.
*
- * @param viewport
- * @param tilesOnAxis
- * @param minZoom
- * @return
*/
protected static Set<Tile> getTilesForViewport(final Viewport viewport, final int tilesOnAxis, final int minZoom) {
final Set<Tile> tiles = new HashSet<>();
diff --git a/main/src/cgeo/geocaching/connector/gc/UTFGridPosition.java b/main/src/cgeo/geocaching/connector/gc/UTFGridPosition.java
index 9de7e1e..f5cd208 100644
--- a/main/src/cgeo/geocaching/connector/gc/UTFGridPosition.java
+++ b/main/src/cgeo/geocaching/connector/gc/UTFGridPosition.java
@@ -36,7 +36,6 @@ final class UTFGridPosition {
/**
* @param key
* Key in the format (xx, xx)
- * @return
*/
static UTFGridPosition fromString(final String key) {
final MatcherWrapper matcher = new MatcherWrapper(UTFGridPosition.PATTERN_JSON_KEY, key);
diff --git a/main/src/cgeo/geocaching/connector/gc/UncertainProperty.java b/main/src/cgeo/geocaching/connector/gc/UncertainProperty.java
index 71adcbd..c9e01a2 100644
--- a/main/src/cgeo/geocaching/connector/gc/UncertainProperty.java
+++ b/main/src/cgeo/geocaching/connector/gc/UncertainProperty.java
@@ -4,7 +4,6 @@ package cgeo.geocaching.connector.gc;
/**
* Property with certainty. When merging properties, the one with higher certainty wins.
*
- * @param <T>
*/
public class UncertainProperty<T> {
diff --git a/main/src/cgeo/geocaching/connector/oc/IOCAuthParams.java b/main/src/cgeo/geocaching/connector/oc/IOCAuthParams.java
index acf7b48..5e5151a 100644
--- a/main/src/cgeo/geocaching/connector/oc/IOCAuthParams.java
+++ b/main/src/cgeo/geocaching/connector/oc/IOCAuthParams.java
@@ -7,7 +7,6 @@ public interface IOCAuthParams {
/**
* The site name: 'www.opencaching...'
*
- * @return
*/
@NonNull
String getSite();
@@ -15,56 +14,48 @@ public interface IOCAuthParams {
/**
* ResId of the Consumer key
*
- * @return
*/
int getCKResId();
/**
* ResId of the Consumer secret
*
- * @return
*/
int getCSResId();
/**
* ResId of the Authorization title
*
- * @return
*/
int getAuthTitleResId();
/**
* Preference key of the public token
*
- * @return
*/
int getTokenPublicPrefKey();
/**
* Preference key of the secret token
*
- * @return
*/
int getTokenSecretPrefKey();
/**
* Preference key of the temporary public token (OAuth)
*
- * @return
*/
int getTempTokenPublicPrefKey();
/**
* Preference key of the temporary secret token (OAuth)
*
- * @return
*/
int getTempTokenSecretPrefKey();
/**
* The URI to use as a callback (OAuth)
*
- * @return
*/
@NonNull
String getCallbackUri();
diff --git a/main/src/cgeo/geocaching/connector/ox/OXGPXParser.java b/main/src/cgeo/geocaching/connector/ox/OXGPXParser.java
index 7896826..25f66f4 100644
--- a/main/src/cgeo/geocaching/connector/ox/OXGPXParser.java
+++ b/main/src/cgeo/geocaching/connector/ox/OXGPXParser.java
@@ -29,7 +29,6 @@ public class OXGPXParser extends GPX10Parser {
* The short description of OX caches contains "title by owner, type(T/D/Awesomeness)". That is a lot of
* duplication. Additionally a space between type and (T/D/Awesomeness) is introduced.
*
- * @param cache
*/
private static void removeTitleFromShortDescription(final @NonNull Geocache cache) {
cache.setShortDescription(StringUtils.replace(StringUtils.trim(StringUtils.substringAfterLast(cache.getShortDescription(), ",")), "(", " ("));
diff --git a/main/src/cgeo/geocaching/connector/trackable/GeokretyConnector.java b/main/src/cgeo/geocaching/connector/trackable/GeokretyConnector.java
index c2c9876..24b0630 100644
--- a/main/src/cgeo/geocaching/connector/trackable/GeokretyConnector.java
+++ b/main/src/cgeo/geocaching/connector/trackable/GeokretyConnector.java
@@ -59,8 +59,6 @@ public class GeokretyConnector extends AbstractTrackableConnector {
/**
* Get geocode from geokrety id
*
- * @param id
- * @return
*/
public static String geocode(final int id) {
return String.format("GK%04X", id);
diff --git a/main/src/cgeo/geocaching/enumerations/CacheType.java b/main/src/cgeo/geocaching/enumerations/CacheType.java
index 4e3b33a..4b882aa 100644
--- a/main/src/cgeo/geocaching/enumerations/CacheType.java
+++ b/main/src/cgeo/geocaching/enumerations/CacheType.java
@@ -122,7 +122,6 @@ public enum CacheType {
/**
* Whether this type contains the given cache.
*
- * @param cache
* @return true if this is the ALL type or if this type equals the type of the cache.
*/
public boolean contains(final Geocache cache) {
diff --git a/main/src/cgeo/geocaching/export/GpxSerializer.java b/main/src/cgeo/geocaching/export/GpxSerializer.java
index 6755798..8139c76 100644
--- a/main/src/cgeo/geocaching/export/GpxSerializer.java
+++ b/main/src/cgeo/geocaching/export/GpxSerializer.java
@@ -174,7 +174,6 @@ public final class GpxSerializer {
}
/**
- * @param boolFlag
* @return XML schema compliant boolean representation of the boolean flag. This must be either true, false, 0 or 1,
* but no other value (also not upper case True/False).
*/
diff --git a/main/src/cgeo/geocaching/files/AbstractFileListActivity.java b/main/src/cgeo/geocaching/files/AbstractFileListActivity.java
index 427fd48..3ec9849 100644
--- a/main/src/cgeo/geocaching/files/AbstractFileListActivity.java
+++ b/main/src/cgeo/geocaching/files/AbstractFileListActivity.java
@@ -201,7 +201,6 @@ public abstract class AbstractFileListActivity<T extends ArrayAdapter<File>> ext
* Check if a filename belongs to the AbstractFileListActivity. This implementation checks for file extensions.
* Subclasses may override this method to filter out specific files.
*
- * @param filename
* @return <code>true</code> if the filename belongs to the list
*/
protected boolean filenameBelongsToList(@NonNull final String filename) {
diff --git a/main/src/cgeo/geocaching/files/GPXImporter.java b/main/src/cgeo/geocaching/files/GPXImporter.java
index e7523f3..5699ebe 100644
--- a/main/src/cgeo/geocaching/files/GPXImporter.java
+++ b/main/src/cgeo/geocaching/files/GPXImporter.java
@@ -95,8 +95,6 @@ public class GPXImporter {
*
* @param uri
* URI of the file to import
- * @param mimeType
- * @param pathName
*/
public void importGPX(final Uri uri, final @Nullable String mimeType, final @Nullable String pathName) {
final ContentResolver contentResolver = fromActivity.getContentResolver();
diff --git a/main/src/cgeo/geocaching/files/GPXParser.java b/main/src/cgeo/geocaching/files/GPXParser.java
index 4f8979b..e4bb7e1 100644
--- a/main/src/cgeo/geocaching/files/GPXParser.java
+++ b/main/src/cgeo/geocaching/files/GPXParser.java
@@ -840,7 +840,6 @@ public abstract class GPXParser extends FileParser {
/**
* Add listeners for GSAK extensions
*
- * @param cacheParent
*/
private void registerGsakExtensions(final Element cacheParent) {
for (final String gsakNamespace : GSAK_NS) {
@@ -901,7 +900,6 @@ public abstract class GPXParser extends FileParser {
/**
* Add listeners for c:geo extensions
*
- * @param cacheParent
*/
private void registerCgeoExtensions(final Element cacheParent) {
final Element cgeoVisited = cacheParent.getChild(CGEO_NS, "visited");
@@ -940,8 +938,6 @@ public abstract class GPXParser extends FileParser {
* GPX 1.0 and 1.1 use different XML elements to put the cache into, therefore needs to be overwritten in the
* version specific subclasses
*
- * @param waypoint
- * @return
*/
protected abstract Element getCacheParent(Element waypoint);
diff --git a/main/src/cgeo/geocaching/filter/IFilter.java b/main/src/cgeo/geocaching/filter/IFilter.java
index eea1303..2bc2004 100644
--- a/main/src/cgeo/geocaching/filter/IFilter.java
+++ b/main/src/cgeo/geocaching/filter/IFilter.java
@@ -12,7 +12,6 @@ public interface IFilter {
String getName();
/**
- * @param cache
* @return true if the filter accepts the cache, false otherwise
*/
boolean accepts(@NonNull final Geocache cache);
diff --git a/main/src/cgeo/geocaching/loaders/OfflineGeocacheListLoader.java b/main/src/cgeo/geocaching/loaders/OfflineGeocacheListLoader.java
index 04d720e..b9fbc76 100644
--- a/main/src/cgeo/geocaching/loaders/OfflineGeocacheListLoader.java
+++ b/main/src/cgeo/geocaching/loaders/OfflineGeocacheListLoader.java
@@ -26,7 +26,6 @@ public class OfflineGeocacheListLoader extends AbstractSearchLoader {
}
/**
- * @param listId
* @return the bundle needed for querying the LoaderManager for the offline list with the given id
*/
public static Bundle getBundleForList(final int listId) {
diff --git a/main/src/cgeo/geocaching/location/Geopoint.java b/main/src/cgeo/geocaching/location/Geopoint.java
index ad693ca..8781124 100644
--- a/main/src/cgeo/geocaching/location/Geopoint.java
+++ b/main/src/cgeo/geocaching/location/Geopoint.java
@@ -97,12 +97,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Create new Geopoint from individual textual components.
*
- * @param latDir
- * @param latDeg
- * @param latDegFrac
- * @param lonDir
- * @param lonDeg
- * @param lonDegFrac
*/
public Geopoint(final String latDir, final String latDeg, final String latDegFrac,
final String lonDir, final String lonDeg, final String lonDegFrac) {
@@ -113,14 +107,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Create new Geopoint from individual textual components.
*
- * @param latDir
- * @param latDeg
- * @param latMin
- * @param latMinFrac
- * @param lonDir
- * @param lonDeg
- * @param lonMin
- * @param lonMinFrac
*/
public Geopoint(final String latDir, final String latDeg, final String latMin, final String latMinFrac,
final String lonDir, final String lonDeg, final String lonMin, final String lonMinFrac) {
@@ -131,16 +117,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Create new Geopoint from individual textual components.
*
- * @param latDir
- * @param latDeg
- * @param latMin
- * @param latSec
- * @param latSecFrac
- * @param lonDir
- * @param lonDeg
- * @param lonMin
- * @param lonSec
- * @param lonSecFrac
*/
public Geopoint(final String latDir, final String latDeg, final String latMin, final String latSec, final String latSecFrac,
final String lonDir, final String lonDeg, final String lonMin, final String lonSec, final String lonSecFrac) {
@@ -347,7 +323,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get latitude character (N or S).
*
- * @return
*/
public char getLatDir() {
return latitude >= 0 ? 'N' : 'S';
@@ -356,7 +331,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get longitude character (E or W).
*
- * @return
*/
public char getLonDir() {
return longitude >= 0 ? 'E' : 'W';
@@ -365,7 +339,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral non-negative latitude degrees.
*
- * @return
*/
public int getLatDeg() {
return getDeg(latitude);
@@ -374,7 +347,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral non-negative longitude degrees.
*
- * @return
*/
public int getLonDeg() {
return getDeg(longitude);
@@ -387,7 +359,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the latitude degrees scaled up by 10^5.
*
- * @return
*/
public int getLatDegFrac() {
return getDegFrac(latitude);
@@ -396,7 +367,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the longitude degrees scaled up by 10^5.
*
- * @return
*/
public int getLonDegFrac() {
return getDegFrac(longitude);
@@ -409,7 +379,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral latitude minutes.
*
- * @return
*/
public int getLatMin() {
return getMin(latitude);
@@ -418,7 +387,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral longitude minutes.
*
- * @return
*/
public int getLonMin() {
return getMin(longitude);
@@ -431,7 +399,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the latitude minutes scaled up by 1000.
*
- * @return
*/
public int getLatMinFrac() {
return getMinFrac(latitude);
@@ -440,7 +407,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the longitude minutes scaled up by 1000.
*
- * @return
*/
public int getLonMinFrac() {
return getMinFrac(longitude);
@@ -453,7 +419,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the latitude minutes.
*
- * @return
*/
public double getLatMinRaw() {
return getMinRaw(latitude);
@@ -462,7 +427,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the longitude minutes.
*
- * @return
*/
public double getLonMinRaw() {
return getMinRaw(longitude);
@@ -475,7 +439,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral part of the latitude seconds.
*
- * @return
*/
public int getLatSec() {
return getSec(latitude);
@@ -484,7 +447,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the integral part of the longitude seconds.
*
- * @return
*/
public int getLonSec() {
return getSec(longitude);
@@ -497,7 +459,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the latitude seconds scaled up by 1000.
*
- * @return
*/
public int getLatSecFrac() {
@@ -507,7 +468,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the fractional part of the longitude seconds scaled up by 1000.
*
- * @return
*/
public int getLonSecFrac() {
@@ -521,7 +481,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the latitude seconds.
*
- * @return
*/
public double getLatSecRaw() {
return getSecRaw(latitude);
@@ -530,7 +489,6 @@ public final class Geopoint implements ICoordinates, Parcelable {
/**
* Get the longitude seconds.
*
- * @return
*/
public double getLonSecRaw() {
return getSecRaw(longitude);
diff --git a/main/src/cgeo/geocaching/maps/CGeoMap.java b/main/src/cgeo/geocaching/maps/CGeoMap.java
index a7983bb..70d8bb8 100644
--- a/main/src/cgeo/geocaching/maps/CGeoMap.java
+++ b/main/src/cgeo/geocaching/maps/CGeoMap.java
@@ -511,7 +511,6 @@ public class CGeoMap extends AbstractMap implements ViewFactory {
/**
* Set the zoom of the map. The zoom is restricted to a certain minimum in case of live map.
*
- * @param zoom
*/
private void setZoom(final int zoom) {
mapView.getMapController().setZoom(isLiveEnabled ? Math.max(zoom, MIN_LIVEMAP_ZOOM) : zoom);
@@ -1120,7 +1119,6 @@ public class CGeoMap extends AbstractMap implements ViewFactory {
/**
* get if map is loading something
*
- * @return
*/
public boolean isLoading() {
return !loadTimer.isUnsubscribed() &&
diff --git a/main/src/cgeo/geocaching/maps/CachesOverlay.java b/main/src/cgeo/geocaching/maps/CachesOverlay.java
index c4c4465..048217e 100644
--- a/main/src/cgeo/geocaching/maps/CachesOverlay.java
+++ b/main/src/cgeo/geocaching/maps/CachesOverlay.java
@@ -158,8 +158,6 @@ public class CachesOverlay extends AbstractItemizedOverlay {
* reality and therefore the minor changes due to the projection will not make any visible difference at the zoom
* levels which are used to see the circles.
*
- * @param projection
- * @return
*/
private int calculateDrawingRadius(MapProjectionImpl projection) {
float[] distanceArray = new float[1];
diff --git a/main/src/cgeo/geocaching/maps/DirectionDrawer.java b/main/src/cgeo/geocaching/maps/DirectionDrawer.java
index c746221..c746221 100755..100644
--- a/main/src/cgeo/geocaching/maps/DirectionDrawer.java
+++ b/main/src/cgeo/geocaching/maps/DirectionDrawer.java
diff --git a/main/src/cgeo/geocaching/maps/DistanceDrawer.java b/main/src/cgeo/geocaching/maps/DistanceDrawer.java
index f2d11bb..f2d11bb 100755..100644
--- a/main/src/cgeo/geocaching/maps/DistanceDrawer.java
+++ b/main/src/cgeo/geocaching/maps/DistanceDrawer.java
diff --git a/main/src/cgeo/geocaching/settings/AbstractAttributeBasedPrefence.java b/main/src/cgeo/geocaching/settings/AbstractAttributeBasedPrefence.java
index 1930c17..4a78037 100644
--- a/main/src/cgeo/geocaching/settings/AbstractAttributeBasedPrefence.java
+++ b/main/src/cgeo/geocaching/settings/AbstractAttributeBasedPrefence.java
@@ -42,7 +42,6 @@ public abstract class AbstractAttributeBasedPrefence extends Preference {
/**
* Evaluate the attributes which where requested in {@link AbstractAttributeBasedPrefence#getAttributeNames()}.
*
- * @param values
*/
protected abstract void processAttributeValues(TypedArray values);
diff --git a/main/src/cgeo/geocaching/settings/InfoPreference.java b/main/src/cgeo/geocaching/settings/InfoPreference.java
index 8040a62..b1c7fed 100644
--- a/main/src/cgeo/geocaching/settings/InfoPreference.java
+++ b/main/src/cgeo/geocaching/settings/InfoPreference.java
@@ -91,8 +91,6 @@ public class InfoPreference extends AbstractAttributeBasedPrefence {
/**
* Add an info icon at the left hand side of the preference.
*
- * @param parent
- * @return
*/
private View addInfoIcon(ViewGroup parent) {
View preferenceView = super.onCreateView(parent);
diff --git a/main/src/cgeo/geocaching/sorting/AbstractCacheComparator.java b/main/src/cgeo/geocaching/sorting/AbstractCacheComparator.java
index a0c5a9f..917bb8a 100644
--- a/main/src/cgeo/geocaching/sorting/AbstractCacheComparator.java
+++ b/main/src/cgeo/geocaching/sorting/AbstractCacheComparator.java
@@ -37,7 +37,6 @@ abstract class AbstractCacheComparator implements CacheComparator {
*
* The default returns <code>true</code> and can be overridden if needed in child classes.
*
- * @param cache
* @return <code>true</code> if the cache holds the necessary data to be compared meaningfully
*/
@SuppressWarnings("static-method")
@@ -51,8 +50,6 @@ abstract class AbstractCacheComparator implements CacheComparator {
* A cache is smaller than another cache if it is desirable to show it first when presented to the user.
* For example, a highly rated cache must be considered smaller than a poorly rated one.
*
- * @param cache1
- * @param cache2
* @return an integer < 0 if cache1 is less than cache2, 0 if they are equal, and > 0 if cache1 is greater than
* cache2.
*/
diff --git a/main/src/cgeo/geocaching/sorting/EventDateComparator.java b/main/src/cgeo/geocaching/sorting/EventDateComparator.java
index 425ddbb..efeeb5d 100644
--- a/main/src/cgeo/geocaching/sorting/EventDateComparator.java
+++ b/main/src/cgeo/geocaching/sorting/EventDateComparator.java
@@ -17,9 +17,6 @@ public class EventDateComparator extends DateComparator {
/**
* copy of {@link Integer#compare(int, int)}, as that is not available on lower API levels
*
- * @param left
- * @param right
- * @return
*/
private static int compare(final int left, final int right) {
return left < right ? -1 : (left == right ? 0 : 1);
diff --git a/main/src/cgeo/geocaching/ui/AbstractCachingPageViewCreator.java b/main/src/cgeo/geocaching/ui/AbstractCachingPageViewCreator.java
index 306c686..60e8b2d 100644
--- a/main/src/cgeo/geocaching/ui/AbstractCachingPageViewCreator.java
+++ b/main/src/cgeo/geocaching/ui/AbstractCachingPageViewCreator.java
@@ -14,7 +14,6 @@ import android.view.ViewGroup;
/**
* View creator which destroys the created view on every {@link #notifyDataSetChanged()}.
*
- * @param <ViewClass>
*/
public abstract class AbstractCachingPageViewCreator<ViewClass extends View> implements PageViewCreator {
diff --git a/main/src/cgeo/geocaching/ui/CacheListAdapter.java b/main/src/cgeo/geocaching/ui/CacheListAdapter.java
index ebbe23f..a5146cd 100644
--- a/main/src/cgeo/geocaching/ui/CacheListAdapter.java
+++ b/main/src/cgeo/geocaching/ui/CacheListAdapter.java
@@ -160,7 +160,6 @@ public class CacheListAdapter extends ArrayAdapter<Geocache> {
/**
* change the sort order
*
- * @param comparator
*/
public void setComparator(final CacheComparator comparator) {
cacheComparator = comparator;
diff --git a/main/src/cgeo/geocaching/ui/WeakReferenceHandler.java b/main/src/cgeo/geocaching/ui/WeakReferenceHandler.java
index d51e697..aa75db7 100644
--- a/main/src/cgeo/geocaching/ui/WeakReferenceHandler.java
+++ b/main/src/cgeo/geocaching/ui/WeakReferenceHandler.java
@@ -11,7 +11,6 @@ import java.lang.ref.WeakReference;
*
* Create static private subclasses of this handler class in your activity.
*
- * @param <ActivityType>
*/
public abstract class WeakReferenceHandler<ActivityType extends Activity> extends Handler {
diff --git a/main/src/cgeo/geocaching/ui/dialog/Dialogs.java b/main/src/cgeo/geocaching/ui/dialog/Dialogs.java
index 47ce6e1..3729677 100644
--- a/main/src/cgeo/geocaching/ui/dialog/Dialogs.java
+++ b/main/src/cgeo/geocaching/ui/dialog/Dialogs.java
@@ -408,7 +408,6 @@ public final class Dialogs {
/**
* Move the cursor to the end of the input field.
*
- * @param input
*/
public static void moveCursorToEnd(final EditText input) {
input.setSelection(input.getText().length(), input.getText().length());
diff --git a/main/src/cgeo/geocaching/ui/logs/CacheLogsViewCreator.java b/main/src/cgeo/geocaching/ui/logs/CacheLogsViewCreator.java
index c29e1e8..6855aab 100644
--- a/main/src/cgeo/geocaching/ui/logs/CacheLogsViewCreator.java
+++ b/main/src/cgeo/geocaching/ui/logs/CacheLogsViewCreator.java
@@ -33,7 +33,6 @@ public class CacheLogsViewCreator extends LogsViewCreator {
/**
* May return null!
*
- * @return
*/
private Geocache getCache() {
if (this.activity instanceof CacheDetailActivity) {
diff --git a/main/src/cgeo/geocaching/ui/logs/TrackableLogsViewCreator.java b/main/src/cgeo/geocaching/ui/logs/TrackableLogsViewCreator.java
index 24c8871..c120286 100644
--- a/main/src/cgeo/geocaching/ui/logs/TrackableLogsViewCreator.java
+++ b/main/src/cgeo/geocaching/ui/logs/TrackableLogsViewCreator.java
@@ -19,7 +19,6 @@ public class TrackableLogsViewCreator extends LogsViewCreator {
private final TrackableActivity trackableActivity;
/**
- * @param trackableActivity
*/
public TrackableLogsViewCreator(final TrackableActivity trackableActivity) {
super(trackableActivity);
diff --git a/main/src/cgeo/geocaching/utils/AsyncTaskWithProgress.java b/main/src/cgeo/geocaching/utils/AsyncTaskWithProgress.java
index 3d2b2b1..29aea63 100644
--- a/main/src/cgeo/geocaching/utils/AsyncTaskWithProgress.java
+++ b/main/src/cgeo/geocaching/utils/AsyncTaskWithProgress.java
@@ -14,8 +14,6 @@ import android.os.AsyncTask;
* automatically derived from the number of {@code Params} given to the task in {@link #execute(Object...)}.
* </p>
*
- * @param <Params>
- * @param <Result>
*/
public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Params, Integer, Result> {
@@ -28,9 +26,6 @@ public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Pa
/**
* Creates an AsyncTask with progress dialog.
*
- * @param activity
- * @param progressTitle
- * @param progressMessage
*/
public AsyncTaskWithProgress(final Activity activity, final String progressTitle, final String progressMessage) {
this(activity, progressTitle, progressMessage, false);
@@ -39,8 +34,6 @@ public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Pa
/**
* Creates an AsyncTask with progress dialog.
*
- * @param activity
- * @param progressTitle
*/
public AsyncTaskWithProgress(final Activity activity, final String progressTitle) {
this(activity, progressTitle, null);
@@ -49,9 +42,6 @@ public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Pa
/**
* Creates an AsyncTask with progress dialog.
*
- * @param activity
- * @param progressTitle
- * @param progressMessage
*/
public AsyncTaskWithProgress(final Activity activity, final String progressTitle, final String progressMessage, final boolean indeterminate) {
this.activity = activity;
@@ -63,8 +53,6 @@ public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Pa
/**
* Creates an AsyncTask with progress dialog.
*
- * @param activity
- * @param progressTitle
*/
public AsyncTaskWithProgress(final Activity activity, final String progressTitle, final boolean indeterminate) {
this(activity, progressTitle, null, indeterminate);
@@ -101,7 +89,6 @@ public abstract class AsyncTaskWithProgress<Params, Result> extends AsyncTask<Pa
/**
* This method should typically be overridden by sub classes instead of {@link #onPostExecute(Object)}.
*
- * @param result
*/
protected void onPostExecuteInternal(final Result result) {
// empty by default
diff --git a/main/src/cgeo/geocaching/utils/DatabaseBackupUtils.java b/main/src/cgeo/geocaching/utils/DatabaseBackupUtils.java
index 1449f8c..a65a9fb 100644
--- a/main/src/cgeo/geocaching/utils/DatabaseBackupUtils.java
+++ b/main/src/cgeo/geocaching/utils/DatabaseBackupUtils.java
@@ -82,8 +82,6 @@ public class DatabaseBackupUtils {
/**
* Create a backup after confirming to overwrite the existing backup.
*
- * @param activity
- * @param runAfterwards
*/
public static void createBackup(final Activity activity, final Runnable runAfterwards) {
// avoid overwriting an existing backup with an empty database
diff --git a/main/src/cgeo/geocaching/utils/Formatter.java b/main/src/cgeo/geocaching/utils/Formatter.java
index 081779f..9b96aae 100644
--- a/main/src/cgeo/geocaching/utils/Formatter.java
+++ b/main/src/cgeo/geocaching/utils/Formatter.java
@@ -208,7 +208,6 @@ public abstract class Formatter {
/**
* Formatting of the hidden date of a cache
*
- * @param cache
* @return {@code null} or hidden date of the cache (or event date of the cache) in human readable format
*/
public static String formatHiddenDate(final Geocache cache) {
diff --git a/main/src/cgeo/geocaching/utils/HtmlUtils.java b/main/src/cgeo/geocaching/utils/HtmlUtils.java
index e90b70d..739acf7 100644
--- a/main/src/cgeo/geocaching/utils/HtmlUtils.java
+++ b/main/src/cgeo/geocaching/utils/HtmlUtils.java
@@ -21,8 +21,6 @@ public final class HtmlUtils {
* Extract the text from a HTML based string. This is similar to what HTML.fromHtml(...) does, but this method also
* removes the embedded images instead of replacing them by a small rectangular representation character.
*
- * @param html
- * @return
*/
public static String extractText(final CharSequence html) {
if (StringUtils.isBlank(html)) {
diff --git a/main/src/cgeo/geocaching/utils/LeastRecentlyUsedMap.java b/main/src/cgeo/geocaching/utils/LeastRecentlyUsedMap.java
index 6122532..f89c040 100644
--- a/main/src/cgeo/geocaching/utils/LeastRecentlyUsedMap.java
+++ b/main/src/cgeo/geocaching/utils/LeastRecentlyUsedMap.java
@@ -117,7 +117,6 @@ public abstract class LeastRecentlyUsedMap<K, V> extends LinkedHashMap<K, V> {
* Interface for handlers that wish to get notified when items are
* removed from the LRUMap
*
- * @param <V>
*/
public interface RemoveHandler<V> {
diff --git a/main/src/cgeo/geocaching/utils/Log.java b/main/src/cgeo/geocaching/utils/Log.java
index 2f51e42..861faaa 100644
--- a/main/src/cgeo/geocaching/utils/Log.java
+++ b/main/src/cgeo/geocaching/utils/Log.java
@@ -37,7 +37,6 @@ public final class Log {
/**
* Save a copy of the debug flag from the settings for performance reasons.
*
- * @param isDebug
*/
public static void setDebug(final boolean isDebug) {
Log.isDebug = isDebug;
diff --git a/main/src/cgeo/geocaching/utils/MatcherWrapper.java b/main/src/cgeo/geocaching/utils/MatcherWrapper.java
index e116269..733a18e 100644
--- a/main/src/cgeo/geocaching/utils/MatcherWrapper.java
+++ b/main/src/cgeo/geocaching/utils/MatcherWrapper.java
@@ -45,8 +45,6 @@ public class MatcherWrapper {
* <p>
* Do not change this method, even if Findbugs and other tools will report a violation for that line!
*
- * @param input
- * @return
*/
@SuppressFBWarnings("DM_STRING_CTOR")
private static String newString(final String input) {
diff --git a/main/src/cgeo/geocaching/utils/ProcessUtils.java b/main/src/cgeo/geocaching/utils/ProcessUtils.java
index 45e80d1..d04c1fe 100644
--- a/main/src/cgeo/geocaching/utils/ProcessUtils.java
+++ b/main/src/cgeo/geocaching/utils/ProcessUtils.java
@@ -24,8 +24,6 @@ public final class ProcessUtils {
/**
* Preferred method to detect the availability of an external app
*
- * @param packageName
- * @return
*/
public static boolean isLaunchable(@Nullable final String packageName) {
return getLaunchIntent(packageName) != null;
@@ -36,8 +34,6 @@ public final class ProcessUtils {
* This function is relatively costly, so if you know that the package in question has
* a launch intent, use isLaunchable() instead.
*
- * @param packageName
- * @return
*/
public static boolean isInstalled(@NonNull final String packageName) {
return isLaunchable(packageName) || hasPackageInstalled(packageName);
diff --git a/main/src/cgeo/geocaching/utils/TextUtils.java b/main/src/cgeo/geocaching/utils/TextUtils.java
index 9fc960c..1f14f8d 100644
--- a/main/src/cgeo/geocaching/utils/TextUtils.java
+++ b/main/src/cgeo/geocaching/utils/TextUtils.java
@@ -106,8 +106,6 @@ public final class TextUtils {
/**
* Searches for the pattern pattern in the data.
*
- * @param data
- * @param pattern
* @return true if data contains the pattern pattern
*/
public static boolean matches(final String data, final Pattern pattern) {
@@ -164,8 +162,6 @@ public final class TextUtils {
* Remove all control characters (which are not valid in XML or HTML), as those should not appear in cache texts
* anyway
*
- * @param input
- * @return
*/
public static String removeControlCharacters(final String input) {
final Matcher remover = PATTERN_REMOVE_NONPRINTABLE.matcher(input);