From 8e006d8d526880e38ea3cbf27cd19c4e4ca1a1b9 Mon Sep 17 00:00:00 2001
From: Bernhard Posselt <nukeawhale@gmail.com>
Date: Tue, 30 Oct 2012 18:52:02 +0100
Subject: [PATCH] added todos

---
 .../themes/owncloud/static/style.css          |  8 +++++
 developer_manual/conf.py                      |  2 +-
 developer_manual/templates.rst                | 36 ++++++-------------
 3 files changed, 19 insertions(+), 27 deletions(-)

diff --git a/_shared_assets/themes/owncloud/static/style.css b/_shared_assets/themes/owncloud/static/style.css
index 0b80c3f7e..84f1dc734 100644
--- a/_shared_assets/themes/owncloud/static/style.css
+++ b/_shared_assets/themes/owncloud/static/style.css
@@ -1064,6 +1064,14 @@ img.alignleft{ margin-right: 20px; }
 		padding-left: 50px;
 	}
 
+	.admonition-todo .first {
+		background-color: #edd400;
+	}
+
+	.admonition-todo .last {
+		background-image: url('img/icon.svg');
+	}
+	
 	.note .first {
 		background-color: #f5f5f5;
 	}
diff --git a/developer_manual/conf.py b/developer_manual/conf.py
index 7534ee08f..7cda832b7 100644
--- a/developer_manual/conf.py
+++ b/developer_manual/conf.py
@@ -25,7 +25,7 @@ import sys, os
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinxcontrib.phpdomain']
+extensions = ['sphinxcontrib.phpdomain', 'sphinx.ext.todo']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['../_shared_assets/templates']
diff --git a/developer_manual/templates.rst b/developer_manual/templates.rst
index 23cd4d6be..605179c5d 100644
--- a/developer_manual/templates.rst
+++ b/developer_manual/templates.rst
@@ -163,11 +163,7 @@ OC_Template
 
    **Example:**
 
-   .. code-block:: php
-
-     <?php 
-     // FIXME: provide an example please
-     ?>
+   .. todo:: provide example
 
 
   .. php:method:: getFormFactorExtension()
@@ -225,16 +221,12 @@ OC_Template
    :param array $parameters: Parameters for the template
    :returns: bool
 
+   Shortcut to print a simple page for admin
+	
    **Example:**
 
-   .. code-block:: php
-
-     <?php 
-     // FIXME: provide an example please
-     ?>
-
-   Shortcut to print a simple page for admin
-
+   .. todo:: provide example
+	
 
   .. php:method:: printGuestPage($application, $name[, $parameters])
 
@@ -243,15 +235,11 @@ OC_Template
    :param array $parameters: Parameters for the template
    :returns: bool
 
+   Shortcut to print a simple page for guests
+
    **Example:**
 
-   .. code-block:: php
-
-     <?php 
-     // FIXME: provide an example please
-     ?>
-
-   Shortcut to print a simple page for guests
+   .. todo:: provide example
 
 
   .. php:method:: printUserPage($application, $name[, $parameters])
@@ -265,11 +253,7 @@ OC_Template
 
    **Example:**
 
-   .. code-block:: php
-
-     <?php 
-     // FIXME: provide an example please
-     ?>
+   .. todo:: provide example
 
 
 
@@ -287,7 +271,7 @@ html_select_options
   :param array $params: optional parameters that are done in key => value
   :returns: the html as string of preset <option> tags
 
-FIXME: explain parameters
+.. todo:: Fix parameters and add example