added info on control macros on syntax page

darcs-hash:20071204222503-7ad00-219aa343f2ccef71179827cd2546955fc2bcb847.gz

1 files changed, 9 insertions, 0 deletions

diff --git a/data/pages/wiki/syntax.txt b/data/pages/wiki/syntax.txt
index acf99c8de..0b4f5fa70 100644
--- a/data/pages/wiki/syntax.txt
+++ b/data/pages/wiki/syntax.txt
@@ -359,6 +359,7 @@ The refresh period defaults to 4 hours. Any value below 10 minutes will be treat
 
 {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 
+
 ===== Embedding HTML and PHP =====
 
 You can embed raw HTML or PHP code into your documents by using the ''html'' or ''php'' tags like this:
@@ -404,6 +405,14 @@ echo '</tr></table>';
 
 **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.
 
+===== Control Macros =====
+
+Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
+
+^ Macro           ^ Description |
+| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created |
+| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
+
 ===== Syntax Plugins =====
 
 DokuWiki's syntax can be extended by [[doku>wiki:plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation: