Index: orxonox/trunk/src/lib/sound/ogg_player.cc
===================================================================
--- orxonox/trunk/src/lib/sound/ogg_player.cc	(revision 4960)
+++ orxonox/trunk/src/lib/sound/ogg_player.cc	(revision 4961)
@@ -23,9 +23,28 @@
 #include "debug.h"
 
-void OggStream::open(string path)
+
+/**
+ * initializes an Ogg-player from a file
+ * @param fileName the file to load
+ */
+OggPlayer::OggPlayer(const char* fileName)
+{
+  this->setClassID(CL_SOUND_OGG_PLAYER, "OggPlayer");
+  if (fileName != NULL)
+  {
+    this->open(fileName);
+    this->setName(fileName);
+  }
+}
+
+/**
+ * opens a file for playback
+ * @param fileName the file to open
+ */
+void OggPlayer::open(const char* fileName)
 {
     int result;
 
-    if(!(oggFile = fopen(path.c_str(), "rb")))
+    if(!(oggFile = fopen(fileName, "rb")))
         PRINTF(2)("Could not open Ogg file.");
 
@@ -58,8 +77,8 @@
 }
 
-
-
-
-void OggStream::release()
+/**
+ * releases a stream
+ */
+void OggPlayer::release()
 {
     alSourceStop(source);
@@ -73,8 +92,8 @@
 }
 
-
-
-
-void OggStream::display()
+/**
+ * displays some info about the ogg-file
+ */
+void OggPlayer::display()
 {
     cout
@@ -96,7 +115,9 @@
 
 
-
-
-bool OggStream::playback()
+/**
+ * plays back the sound
+ * @return true if running, false otherwise
+ */
+bool OggPlayer::playback()
 {
     if(playing())
@@ -115,8 +136,9 @@
 }
 
-
-
-
-bool OggStream::playing()
+/**
+ *
+ * @returns true if the file is playing
+ */
+bool OggPlayer::playing()
 {
     ALenum state;
@@ -127,8 +149,9 @@
 }
 
-
-
-
-bool OggStream::update()
+/**
+ * updates the stream, this has to be done every few parts of a second, for sound-consistency
+ * @returns true, if the Sound is playing flawlessly
+ */
+bool OggPlayer::update()
 {
     int processed;
@@ -153,8 +176,10 @@
 }
 
-
-
-
-bool OggStream::stream(ALuint buffer)
+/**
+ * gets a new Stream from buffer
+ * @param buffer the buffer to get the stream from
+ * @return true, if everything worked as planed
+ */
+bool OggPlayer::stream(ALuint buffer)
 {
     char pcm[BUFFER_SIZE];
@@ -186,7 +211,8 @@
 
 
-
-
-void OggStream::empty()
+/**
+ * empties the buffers
+ */
+void OggPlayer::empty()
 {
     int queued;
@@ -203,8 +229,8 @@
 }
 
-
-
-
-void OggStream::check()
+/**
+ * checks for errors
+ */
+void OggPlayer::check()
 {
         int error = alGetError();
@@ -214,7 +240,10 @@
 }
 
-
-
-const char* OggStream::errorString(int code)
+/**
+ * returns errors
+ * @param code the error-code
+ * @return the error as a String
+ */
+const char* OggPlayer::errorString(int code)
 {
      switch(code)
Index: orxonox/trunk/src/lib/sound/ogg_player.h
===================================================================
--- orxonox/trunk/src/lib/sound/ogg_player.h	(revision 4960)
+++ orxonox/trunk/src/lib/sound/ogg_player.h	(revision 4961)
@@ -1,5 +1,5 @@
 /*!
  * @file ogg_player.h
- *  Ogg-Player definition
+ * Ogg-Player definition
  */
 
@@ -8,7 +8,8 @@
 #define _OGG_PLAYER_H
 
-#include <string>
 #include <iostream>
 using namespace std;
+
+#include "base_object.h"
 
 #include <AL/al.h>
@@ -21,34 +22,35 @@
 
 
+// the definition of a Ogg-Player
+class OggPlayer : public BaseObject
+  {
+  public:
+    OggPlayer(const char* fileName = NULL);
 
-class OggStream
-{
-    public:
+    void open(const char* fileName);
+    void release();
+    void display();
+    bool playback();
+    bool playing();
+    bool update();
 
-        void open(string path);
-        void release();
-        void display();
-        bool playback();
-        bool playing();
-        bool update();
+  protected:
 
-    protected:
+    bool stream(ALuint buffer);
+    void empty();
+    void check();
+    const char* errorString(int code);
 
-        bool stream(ALuint buffer);
-        void empty();
-        void check();
-        const char* errorString(int code);
+  private:
 
-    private:
+    FILE*               oggFile;              //!< general file-handler, to open the sound-file
+    OggVorbis_File      oggStream;            //!< The stream this Ogg-player is playing back
+    vorbis_info*        vorbisInfo;           //!< The information held in the opened ogg-file
+    vorbis_comment*     vorbisComment;        //!< Comments about the ogg-file
 
-        FILE*             oggFile;
-        OggVorbis_File    oggStream;
-        vorbis_info*      vorbisInfo;
-        vorbis_comment*   vorbisComment;
-
-        ALuint            buffers[2];
-        ALuint            source;
-        ALenum            format;
-};
+    ALuint              buffers[2];           //!< buffers that handle sequentially buffering of the audio
+    ALuint              source;               //!< The source we play back on
+    ALenum              format;               //!< The format we play back
+  };
 
 
Index: orxonox/trunk/src/lib/sound/sound_engine.cc
===================================================================
--- orxonox/trunk/src/lib/sound/sound_engine.cc	(revision 4960)
+++ orxonox/trunk/src/lib/sound/sound_engine.cc	(revision 4961)
@@ -250,13 +250,4 @@
 {
   return new SoundSource(sourceNode, (SoundBuffer*)ResourceManager::getInstance()->load(fileName, WAV, RP_LEVEL));
-}
-
-
-/**
- *  sets The listener (normaly the Camera)
-*/
-void SoundEngine::setListener(PNode* listener)
-{
-  this->listener = listener;
 }
 
Index: orxonox/trunk/src/lib/sound/sound_engine.h
===================================================================
--- orxonox/trunk/src/lib/sound/sound_engine.h	(revision 4960)
+++ orxonox/trunk/src/lib/sound/sound_engine.h	(revision 4961)
@@ -77,15 +77,16 @@
     SoundSource* createSource(const char* fileName, PNode* sourceNode = NULL);
 
-    void setListener(PNode* listener);
+    /** @param listener the listener in the scene */
+    void setListener(PNode* listener) { this->listener = listener; };
     void setDopplerValues(ALfloat dopplerFactor, ALfloat dopplerVelocity);
 
 
+    void update();
+
+  // administrative
     void addBuffer(SoundBuffer* buffer);
     void removeBuffer(SoundBuffer* buffer);
     void addSource(SoundSource* source);
 
-    void update();
-
-  // administrative
     void flushUnusedBuffers();
     void flushAllBuffers();
