# HG changeset patch # User Ingo Weinzierl # Date 1271065050 0 # Node ID 3f447e92024a6bbf3a15c803c55fc2b77ad1830d # Parent cda3bede32f880595f6c7312e3fba3dc0516574f Added JavaDoc package descriptions. gnv-artifacts/trunk@902 c6561f87-3c4e-4783-a992-168aeb5c3f6f diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/ChangeLog --- a/gnv-artifacts/ChangeLog Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/ChangeLog Mon Apr 12 09:37:30 2010 +0000 @@ -1,3 +1,42 @@ +2010-04-12 Ingo Weinzierl + + * src/main/java/de/intevation/gnv/artifacts/fis/product/package.html, + src/main/java/de/intevation/gnv/artifacts/fis/package.html, + src/main/java/de/intevation/gnv/artifacts/cache/package.html, + src/main/java/de/intevation/gnv/artifacts/context/package.html, + src/main/java/de/intevation/gnv/artifacts/ressource/package.html, + src/main/java/de/intevation/gnv/artifacts/package.html, + src/main/java/de/intevation/gnv/state/exception/package.html, + src/main/java/de/intevation/gnv/state/package.html, + src/main/java/de/intevation/gnv/state/profile/horizontalcrosssection/package.html, + src/main/java/de/intevation/gnv/state/profile/verticalcrosssection/package.html, + src/main/java/de/intevation/gnv/state/profile/horizontal/package.html, + src/main/java/de/intevation/gnv/state/profile/vertical/package.html, + src/main/java/de/intevation/gnv/state/timeseries/package.html, + src/main/java/de/intevation/gnv/state/describedata/package.html, + src/main/java/de/intevation/gnv/statistics/exception/package.html, + src/main/java/de/intevation/gnv/statistics/package.html, + src/main/java/de/intevation/gnv/histogram/package.html, + src/main/java/de/intevation/gnv/profile/horizontalcrosssection/package.html, + src/main/java/de/intevation/gnv/profile/verticalcrosssection/package.html, + src/main/java/de/intevation/gnv/profile/horizontal/package.html, + src/main/java/de/intevation/gnv/profile/vertical/package.html, + src/main/java/de/intevation/gnv/utils/exception/package.html, + src/main/java/de/intevation/gnv/utils/package.html, + src/main/java/de/intevation/gnv/chart/exception/package.html + src/main/java/de/intevation/gnv/chart/package.html, + src/main/java/de/intevation/gnv/exports/package.html, + src/main/java/de/intevation/gnv/wms/package.html, + src/main/java/de/intevation/gnv/timeseries/gap/package.html, + src/main/java/de/intevation/gnv/timeseries/package.html, + src/main/java/de/intevation/gnv/jfreechart/package.html: Added package + descriptions for the different packages. + + * src/main/java/de/intevation/gnv/artifacts/GNVArtifactFactory.java, + src/main/java/de/intevation/gnv/chart/VerticalCrossSectionChart.java, + src/main/java/de/intevation/gnv/chart/ChartLabels.java: Added missing + class descriptions. + 2010-04-12 Tim Englich ISSUE 215 msg1189 diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/GNVArtifactFactory.java --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/GNVArtifactFactory.java Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/GNVArtifactFactory.java Mon Apr 12 09:37:30 2010 +0000 @@ -9,6 +9,8 @@ /** + * The GNV default implementation of DefaultArtifactFactory. + * * @author Ingo Weinzierl */ public class GNVArtifactFactory extends DefaultArtifactFactory { diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/cache/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/cache/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/cache/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +This package contains classes used for data caching. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/context/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/context/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/context/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +Support for context objects that store data items used in the GNV in different +places across the whole application. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes providing a special artifact used after a fis is +selected and the user needs to choose a concrete product. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/product/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/product/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/fis/product/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +Classes and interfaces representing a product (eg 'Horizontalschnitt', +'Horizontalprofil', 'Vertikalprofil', 'Profilschnitt', 'Zeitserien'). diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +Map user workflows to software components using classes and interfaces in this +package. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/ressource/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/ressource/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/artifacts/ressource/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Classes to handle working with resources. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/chart/ChartLabels.java --- a/gnv-artifacts/src/main/java/de/intevation/gnv/chart/ChartLabels.java Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/chart/ChartLabels.java Mon Apr 12 09:37:30 2010 +0000 @@ -13,6 +13,9 @@ package de.intevation.gnv.chart; /** + * This class stores some strings used for decorating charts (e.g. title, + * subtitle, etc). + * * @author drewnak * @author Tim Englich Changes and codecleanup * @author Ingo Weinzierl diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/chart/VerticalCrossSectionChart.java --- a/gnv-artifacts/src/main/java/de/intevation/gnv/chart/VerticalCrossSectionChart.java Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/chart/VerticalCrossSectionChart.java Mon Apr 12 09:37:30 2010 +0000 @@ -35,6 +35,8 @@ import org.jfree.ui.RectangleInsets; /** + * This class represents a 2D chart containing polygon data. + * * @author Ingo Weinzierl * @author Sascha L. Teichmann */ diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/chart/exception/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/chart/exception/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/chart/exception/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Exceptions that are used to be thrown if an error occured while chart generation. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/chart/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/chart/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/chart/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Classes and interfaces to support creation of different chart types. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/exports/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/exports/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/exports/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Handle different types of data exports (e.g. chart, csv, odv). diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/histogram/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/histogram/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/histogram/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Helper classes used while histogram creation. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/jfreechart/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/jfreechart/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/jfreechart/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +This package contains classes and interfaces used to create 2D charts. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontal/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontal/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontal/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes providing specific artifacts representing +'Horizontalprofile'. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontalcrosssection/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontalcrosssection/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/profile/horizontalcrosssection/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes providing specific artifacts representing +'Horizontalschnitte'. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/profile/vertical/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/profile/vertical/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/profile/vertical/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes that provide specific artifacts representing +'Vertikalprofile'. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/profile/verticalcrosssection/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/profile/verticalcrosssection/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/profile/verticalcrosssection/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes that provide specific artifacts representing +'Profilschnitte'. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/describedata/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/describedata/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/describedata/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Classes and interfaces to handle user input. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/exception/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/exception/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/exception/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Exception classes to be thrown if error occur in state objects. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +Classes in this package handle specific input/output of artifacts and even play a +decisive role for creating describe-documents of the current artifact's state. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontal/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontal/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontal/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +State classes used by artifacts representing 'Horizontalprofile' to handle input +and output. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontalcrosssection/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontalcrosssection/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/horizontalcrosssection/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +State classes used by artifacts representing 'Horizontalschnitte' to handle input +and output. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/vertical/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/vertical/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/vertical/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +State classes used by artifacts representing 'Vertikalprofile' to handle input +and output. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/verticalcrosssection/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/verticalcrosssection/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/profile/verticalcrosssection/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +State classes used by artifacts representing 'Profilschnitte' to handle input and +output. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/state/timeseries/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/state/timeseries/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/state/timeseries/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +State classes used by artifacts representing 'Zeitserien' to handle input and +output. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/statistics/exception/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/statistics/exception/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/statistics/exception/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains exception classes used to be thrown if error occur while +generating statistics. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/statistics/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/statistics/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/statistics/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes and interfaces used to create statistics for the +different types of artifacts. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/gap/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/gap/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/gap/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package provides classes and interfaces representing time gaps used in +timerseries charts. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/timeseries/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,7 @@ -DOCUMENT ME! +This package contains classes providing specific artifacts representing +'Zeitserien'. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/utils/exception/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/utils/exception/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/utils/exception/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Exception classes used by helper classes in the utils package. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/utils/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/utils/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/utils/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +This package provides some helper classes used across the whole software. diff -r cda3bede32f8 -r 3f447e92024a gnv-artifacts/src/main/java/de/intevation/gnv/wms/package.html --- a/gnv-artifacts/src/main/java/de/intevation/gnv/wms/package.html Mon Apr 12 09:26:26 2010 +0000 +++ b/gnv-artifacts/src/main/java/de/intevation/gnv/wms/package.html Mon Apr 12 09:37:30 2010 +0000 @@ -3,6 +3,6 @@ -DOCUMENT ME! +Classes used while generating mapfiles.