Add javadoc.

[demoscenemusic.git] / src / main / java / net / pterodactylus / demoscenemusic / data / Track.java

diff --git a/src/main/java/net/pterodactylus/demoscenemusic/data/Track.java b/src/main/java/net/pterodactylus/demoscenemusic/data/Track.java
index ace6bd3..204cb77 100644 (file)
--- a/src/main/java/net/pterodactylus/demoscenemusic/data/Track.java
+++ b/src/main/java/net/pterodactylus/demoscenemusic/data/Track.java
@@ -21,22 +21,58 @@ import java.util.Collection;
 import java.util.List;
 
 /**
- * TODO
+ * Data interface for tracks.
  *
  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
 public interface Track extends Base {
 
+       /**
+        * Returns the name of this track.
+        *
+        * @return The name of this track
+        */
        public String getName();
 
+       /**
+        * Sets the name of this track.
+        *
+        * @param name
+        *            The name of this track
+        * @return This track
+        */
        public Track setName(String name);
 
+       /**
+        * Returns all artists involved in this track.
+        *
+        * @return All involved artists in preferred order
+        */
        public List<Artist> getArtists();
 
+       /**
+        * Sets all artists involved in this track.
+        *
+        * @param artists
+        *            All involved artists in preferred order
+        * @return This track
+        */
        public Track setArtists(List<Artist> artists);
 
+       /**
+        * Returns all styles of this track.
+        *
+        * @return All styles of this track
+        */
        public Collection<Style> getStyles();
 
+       /**
+        * Sets all styles of this track.
+        *
+        * @param styles
+        *            All styles of this track
+        * @return This track
+        */
        public Track setStyles(Collection<? extends Style> styles);
 
 }