From 4a5f5b952535b574836e3d63b3021561fb3aba22 Mon Sep 17 00:00:00 2001
From: Ingo Schommer <ingo@silverstripe.com>
Date: Thu, 22 Jul 2010 23:18:40 +0000
Subject: [PATCH] MINOR Cross-referencing some documentation

git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/branches/2.4@108375 467b73ca-7a2a-4603-9d3b-597d59a354a9
---
 forms/DropdownField.php        | 4 ++++
 forms/ListboxField.php         | 5 +++++
 forms/OptionsetField.php       | 4 ++++
 forms/TreeDropdownField.php    | 5 +++++
 forms/TreeMultiselectField.php | 2 ++
 5 files changed, 20 insertions(+)

diff --git a/forms/DropdownField.php b/forms/DropdownField.php
index 6994f7bf9..8f0a43a6d 100755
--- a/forms/DropdownField.php
+++ b/forms/DropdownField.php
@@ -68,6 +68,10 @@
  * );
  * </code>
  * 
+ * @see CheckboxSetField for multiple selections through checkboxes instead.
+ * @see ListboxField for a single <select> box (with single or multiple selections).
+ * @see TreeDropdownField for a rich and customizeable UI that can visualize a tree of selectable elements
+ * 
  * @package forms
  * @subpackage fields-basic
  */
diff --git a/forms/ListboxField.php b/forms/ListboxField.php
index 772e9ad8a..8d45b1b8d 100755
--- a/forms/ListboxField.php
+++ b/forms/ListboxField.php
@@ -17,6 +17,11 @@
  * )
  * </code> 
  * 
+ * @see DropdownField for a simple <select> field with a single element.
+ * @see CheckboxSetField for multiple selections through checkboxes.
+ * @see OptionsetField for single selections via radiobuttons.
+ * @see TreeDropdownField for a rich and customizeable UI that can visualize a tree of selectable elements
+ * 
  * @package forms
  * @subpackage fields-basic
  */
diff --git a/forms/OptionsetField.php b/forms/OptionsetField.php
index 9b675ab33..8c80eb048 100755
--- a/forms/OptionsetField.php
+++ b/forms/OptionsetField.php
@@ -47,6 +47,10 @@
  * // Pass the fields to the form constructor. etc
  * </code>
  * 
+ * @see CheckboxSetField for multiple selections through checkboxes instead.
+ * @see DropdownField for a simple <select> field with a single element.
+ * @see TreeDropdownField for a rich and customizeable UI that can visualize a tree of selectable elements
+ * 
  * @package forms
  * @subpackage fields-basic
  */
diff --git a/forms/TreeDropdownField.php b/forms/TreeDropdownField.php
index 1cfd9fbfb..b336c71ce 100755
--- a/forms/TreeDropdownField.php
+++ b/forms/TreeDropdownField.php
@@ -23,6 +23,11 @@
  * </code>
  * 
  * This will generate a tree allowing the user to expand and contract subsections to find the appropriate page to save to the field.
+ * 
+ * @see TreeMultiselectField for the same implementation allowing multiple selections
+ * @see DropdownField for a simple <select> field with a single element.
+ * @see CheckboxSetField for multiple selections through checkboxes.
+ * @see OptionsetField for single selections via radiobuttons.
  *
  * @package forms
  * @subpackage fields-relational
diff --git a/forms/TreeMultiselectField.php b/forms/TreeMultiselectField.php
index b1c186693..a177e4677 100755
--- a/forms/TreeMultiselectField.php
+++ b/forms/TreeMultiselectField.php
@@ -30,6 +30,8 @@
  * }
  * </code> 
  * 
+ * @see TreeDropdownField for the sample implementation, but only allowing single selects
+ * 
  * @package forms
  * @subpackage fields-relational
  */