diff --git a/src/orc/ResourceCompiler.h b/src/orc/ResourceCompiler.h
index 5daf8aac13fd42ebc8b57888f06f1b7a4ff42e2f..a1cecd1f2b0c226a40a6ead9e2f589267752b43b 100644
--- a/src/orc/ResourceCompiler.h
+++ b/src/orc/ResourceCompiler.h
@@ -38,11 +38,13 @@ using namespace std;
  * This "compiler" takes a resource specification file, opens and loads the physical
  * files and converts their contents into normal C/C++ source code. The source code
  * comprises three arrays which can be subsequently compiled into object code which is
- * then referenced by ResourceFactory using external linkage.
+ * then referenced by ResourceFactory using external linkage.\n
  * \n
  * %Resource specification file format:
+ * - Simple text file (*.orc)
  * - Each line describes one resource
- * - The descriptor has to look like this: LogicalResourceName|PhysicalResourceName
+ * - The descriptor has to look like this: <code>LogicalResourceName|PhysicalResourceName</code>
+ * - <code>PhysicalResourceName</code> is the actual file name of the resource
  * - Lines starting with # are treated as comments
  * - Empty lines are ignored
  * 
diff --git a/src/starsphere/Starsphere.cpp b/src/starsphere/Starsphere.cpp
index b6525adc8685486d6bd23c080a2d79b7b4bceda1..c5c334895e70525d267a0940a1c1b8057840f456 100644
--- a/src/starsphere/Starsphere.cpp
+++ b/src/starsphere/Starsphere.cpp
@@ -217,7 +217,7 @@ void Starsphere::make_constellations()
 }
 
 /**
- * Create markers on sky sphere for LLO, LHO, and GEO
+ * Create markers on sky sphere for LLO, LHO, GEO and VIRGO
  * IFO corner positions are from Myers' personal GPS and are +/- 100m
  */
 
diff --git a/src/starsphere/Starsphere.h b/src/starsphere/Starsphere.h
index 8c884a2ac3badd39c79662a12d629ebce2f7a863..fe536f54f9e3ef51cd822deaf4aa6d765591073a 100644
--- a/src/starsphere/Starsphere.h
+++ b/src/starsphere/Starsphere.h
@@ -75,8 +75,7 @@ using namespace std;
  * of this engine.
  * 
  * \todo The code of this implementaion is based on the former version of %Starsphere
- * by Bruce Allen, David Hammer and Eric Myers. Due to this there's still
- * some refactoring and code cleanup left to be done.
+ * and there's still some refactoring, code cleanup and documenting left to be done.
  * 
  * \author Oliver Bock\n
  * Max-Planck-Institute for Gravitational Physics\n