From a30ac8c6d66ac501cf8a7ca321cac461bb59f37c Mon Sep 17 00:00:00 2001
From: Oliver Sanders <oliver.sanders@metoffice.gov.uk>
Date: Tue, 31 May 2016 16:43:06 +0100
Subject: [PATCH] Improved docs.

---
 doc/cug.tex | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/doc/cug.tex b/doc/cug.tex
index ff03b7b5a12..7cc0e02bdd1 100644
--- a/doc/cug.tex
+++ b/doc/cug.tex
@@ -2822,6 +2822,10 @@ \subsubsection{Graph Types}
             graph = "delayed_cold_corge => corge"
 
         # Repeat once at the final cycle point
+        [[[ R1/P0Y ]]]
+            graph = "end_garply"
+
+        # Repeat once at the final cycle point (alternative form)
         [[[ R1/$ ]]]
             graph = "end_garply"
 
@@ -2953,20 +2957,31 @@ \subsubsection{Graph Types}
     [[dependencies]]
         # Repeat once 12 hours after the initial cycle point
         # Equivalent to [[[ R1/T12 ]]]
-        [[[ R1/^+PT12H ]]]
+        [[[ R1/^+PT12H ]]]  # R[limit]/[date-time]
             graph = "foo_check"
 
         # Repeat once at the final cycle point
         # Equivalent to [[[ R1//+P0D ]]]
-        [[[ R1/$ ]]]
+        [[[ R1/$ ]]]  # R[limit]/[date-time]
             graph = "foo => end"
 
         # Repeat 3 hourly starting two days before the final cycle point
-        [[[ $-P2D/PT3H ]]]
+        [[[ $-P2D/PT3H ]]]  # [date-time]/[interval]
             graph = "foo => bar"
 \end{lstlisting}
 \lstset{language=transcript}
 
+Note that there can be multiple ways to write the same headings, for instance
+the following all repeat once at the final cycle point:
+
+\lstset{language=suiterc}
+\begin{lstlisting}
+[[[ R1/P0Y ]]]    # R[limit]/[interval]
+[[[ R1/P0Y/$ ]]]  # R[limit]/[interval]/[date-time]
+[[[ R1/$ ]]]      # R[limit]/[date-time]
+\end{lstlisting}
+\lstset{language=transcript}
+
 
 
 \subparagraph{How Multiple Graph Strings Combine}