diff --git a/core/SSViewer.php b/core/SSViewer.php
index 317f0bdb0..8e73515e7 100755
--- a/core/SSViewer.php
+++ b/core/SSViewer.php
@@ -4,10 +4,14 @@
* The SSViewer class handles rendering of .ss templates. In addition to a full template in
* the views folder, a template in views/Content or views/Layout will be rendered into $Content and
* $Layout, respectively.
+ *
+ * Caching
*
* Compiled templates are cached. If you put ?flush=1 on your URL, it will force the template to be recompiled. This
* is a hack; the system should really detect when a page needs re-fetching.
*
+ * Manifest File and Structure
+ *
* Works with the global $_TEMPLATE_MANIFEST which is compiled by {@link ManifestBuilder->getTemplateManifest()}.
* This associative array lists all template filepaths by "identifier", meaning the name
* of the template without its path or extension.
@@ -43,7 +47,9 @@
* )
*
*
- * @todo Fix the broken caching.
+ * @see http://doc.silverstripe.org/themes
+ * @see http://doc.silverstripe.org/themes:developing
+ *
* @package sapphire
* @subpackage view
*/
@@ -102,7 +108,7 @@ class SSViewer {
}
/**
- * @param string $theme
+ * @param string $theme The "base theme" name (without underscores).
*/
static function set_theme($theme) {
self::$current_theme = $theme;