Code formatting.

git-svn-id: http://joomlacode.org/svn/joomla/development/trunk@16327 6f6e1ebd-4c2b-0410-823f-f34bde69bce9

components/com_contact/models/categories.php

@@ -40,6 +40,8 @@ class ContactModelCategories extends JModel
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_contact/models/category.php

@@ -114,11 +114,8 @@ protected function getListQuery()
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * This method should only be called once per instantiation and is designed
-	 * to be called on the first call to the getState() method unless the model
-	 * configuration flag to ignore the request is set.
+	 * Note. Calling getState in this method will result in recursion.
 	 *
-	 * @return	void
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_contact/models/contact.php

@@ -28,7 +28,9 @@ class ContactModelContact extends JModelItem
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * @return	void
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
 	 */
 	protected function populateState()
 	{

components/com_content/models/archive.php

@@ -31,6 +31,8 @@ class ContentModelArchive extends ContentModelArticles
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_content/models/article.php

@@ -31,7 +31,9 @@ class ContentModelArticle extends JModelItem
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * @return	void
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
 	 */
 	protected function populateState()
 	{

components/com_content/models/articles.php

@@ -22,6 +22,8 @@ class ContentModelArticles extends JModelList
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_content/models/categories.php

@@ -40,6 +40,8 @@ class ContentModelCategories extends JModel
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_content/models/category.php

@@ -61,7 +61,9 @@ class ContentModelCategory extends JModelItem
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * @return	void
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
 	 */
 	protected function populateState()
 	{

components/com_content/models/featured.php

@@ -31,6 +31,8 @@ class ContentModelFeatured extends ContentModelArticles
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_content/models/form.php

@@ -31,7 +31,9 @@ class ContentModelForm extends JModelForm
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * @return	void
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
 	 */
 	protected function populateState()
 	{

components/com_newsfeeds/models/categories.php

@@ -40,9 +40,10 @@ class NewsfeedsModelCategories extends JModel
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
-
 	protected function populateState()
 	{
 		$app = &JFactory::getApplication();

components/com_newsfeeds/models/category.php

@@ -117,11 +117,8 @@ protected function getListQuery()
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * This method should only be called once per instantiation and is designed
-	 * to be called on the first call to the getState() method unless the model
-	 * configuration flag to ignore the request is set.
+	 * Note. Calling getState in this method will result in recursion.
 	 *
-	 * @return	void
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_users/models/login.php

@@ -21,6 +21,13 @@
  */
 class UsersModelLogin extends JModelForm
 {
+	/**
+	 * Method to auto-populate the model state.
+	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
+	 */
 	protected function populateState()
 	{
 		// Get the application object.
@@ -30,7 +37,8 @@ protected function populateState()
 		// Load the parameters.
 		$this->setState('params', $params);
 	}
-		/**
+
+	/**
 	 * Method to get the login form.
 	 *
 	 * The base form is loaded from XML and then an event is fired

components/com_users/models/profile.php

@@ -25,9 +25,11 @@ class UsersModelProfile extends JModelForm
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
-	protected function populateState($property = null, $default = null)
+	protected function populateState()
 	{
 		// Get the application object.
 		$app	= &JFactory::getApplication();

components/com_users/models/registration.php

@@ -25,6 +25,8 @@ class UsersModelRegistration extends JModelForm
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_users/models/remind.php

@@ -22,6 +22,13 @@
 
 class UsersModelRemind extends JModelForm
 {
+	/**
+	 * Method to auto-populate the model state.
+	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
+	 */
 	protected function populateState()
 	{
 		// Get the application object.

components/com_users/models/reset.php

@@ -21,6 +21,13 @@
 
 class UsersModelReset extends JModelForm
 {
+	/**
+	 * Method to auto-populate the model state.
+	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
+	 */
 	protected function populateState()
 	{
 		// Get the application object.

components/com_weblinks/models/categories.php

@@ -40,6 +40,8 @@ class WeblinksModelCategories extends JModel
 	/**
 	 * Method to auto-populate the model state.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_weblinks/models/category.php

@@ -121,11 +121,8 @@ protected function getListQuery()
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * This method should only be called once per instantiation and is designed
-	 * to be called on the first call to the getState() method unless the model
-	 * configuration flag to ignore the request is set.
+	 * Note. Calling getState in this method will result in recursion.
 	 *
-	 * @return	void
 	 * @since	1.6
 	 */
 	protected function populateState()

components/com_weblinks/models/form.php

@@ -31,7 +31,9 @@ class WeblinksModelForm extends JModelForm
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * @return	void
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @since	1.6
 	 */
 	protected function populateState()
 	{

components/com_weblinks/models/weblink.php

@@ -30,11 +30,8 @@ class WeblinksModelWeblink extends JModelItem
 	/**
 	 * Method to auto-populate the model state.
 	 *
-	 * This method should only be called once per instantiation and is designed
-	 * to be called on the first call to the getState() method unless the model
-	 * configuration flag to ignore the request is set.
+	 * Note. Calling getState in this method will result in recursion.
 	 *
-	 * @return	void
 	 * @since	1.6
 	 */
 	public function populateState()

libraries/joomla/application/component/model.php

@@ -336,6 +336,8 @@ public function getTable($name='', $prefix='Table', $options = array())
 	 * to be called on the first call to the getState() method unless the model
 	 * configuration flag to ignore the request is set.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @return	void
 	 * @since	1.6
 	 */

libraries/joomla/application/component/modellist.php

@@ -185,6 +185,8 @@ public function getTotal()
 	 * to be called on the first call to the getState() method unless the model
 	 * configuration flag to ignore the request is set.
 	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
 	 * @param	string	An optional ordering field.
 	 * @param	string	An optional direction (asc|desc).
 	 * @since	1.6