silverstripe / silverstripe-cms

code/controllers/ContentController.php

Doc Comments +2 added lines

@@ -212,6 +212,7 @@ 
 
 	/**
 	 * @uses ErrorPage::response_for()
+	 * @param integer $code
 	 */
 	public function httpError($code, $message = null) {
 		// Don't use the HTML response for media requests
@@ -232,6 +233,7 @@ 
 
 	/**
 	 * Returns the associated database record
+	 * @return SiteTree
 	 */
 	public function data() {
 		return $this->dataRecord;

code/model/VirtualPage.php

Doc Comments +1 added lines

@@ -374,6 +374,7 @@
 	
 	/**
 	 * Ensure we have an up-to-date version of everything.
+	 * @param DataObject $source
 	 */
 	public function copyFrom($source, $updateImageTracking = true) {
 		if($source) {

code/controllers/AssetAdmin.php

Doc Comments +5 added lines

@@ -48,6 +48,7 @@ 
 
 	/**
 	 * Return fake-ID "root" if no ID is found (needed to upload files into the root-folder)
+	 * @return integer
 	 */
 	public function currentPageID() {
 		if(is_numeric($this->getRequest()->requestVar('ID')))	{
@@ -528,6 +529,10 @@ 
 		return new Folder();
 	}
 
+	/**
+	 * @param string $childrenMethod
+	 * @param string $numChildrenMethod
+	 */
 	public function getSiteTreeFor($className, $rootID = null, $childrenMethod = null, $numChildrenMethod = null, $filterFunction = null, $minNodeCount = 30) {
 		if (!$childrenMethod) $childrenMethod = 'ChildFolders';
 		if (!$numChildrenMethod) $numChildrenMethod = 'numChildFolders';

code/controllers/CMSMain.php

Doc Comments +2 added lines, -2 removed lines

@@ -669,7 +669,7 @@ 
 
 	/**
 	 * @param SS_HTTPRequest $request
-	 * @return String HTML
+	 * @return HTMLText HTML
 	 */
 	public function treeview($request) {
 		return $this->renderWith($this->getTemplatesWithSuffix('_TreeView'));
@@ -677,7 +677,7 @@ 
 
 	/**
 	 * @param SS_HTTPRequest $request
-	 * @return String HTML
+	 * @return HTMLText HTML
 	 */
 	public function listview($request) {
 		return $this->renderWith($this->getTemplatesWithSuffix('_ListView'));

code/controllers/CMSPageHistoryController.php

Doc Comments +4 added lines, -4 removed lines

@@ -40,7 +40,7 @@ 
 	
 	/**
 	 * @param SS_HTTPRequest $request
-	 * @return array
+	 * @return SS_HTTPResponse
 	 */
 	public function show($request) {
 		$form = $this->ShowVersionForm($request->param('VersionID'));
@@ -59,7 +59,7 @@ 
 	
 	/**
 	 * @param SS_HTTPRequest $request
-	 * @return array
+	 * @return SS_HTTPResponse
 	 */
 	public function compare($request) {
 		$form = $this->CompareVersionsForm(
@@ -278,7 +278,7 @@ 
 	 * @param array
 	 * @param Form
 	 *
-	 * @return html
+	 * @return null|HTMLText
 	 */
 	public function doCompare($data, $form) {
 		$versions = $data['Versions'];
@@ -315,7 +315,7 @@ 
 	 * @param array
 	 * @param Form
 	 *
-	 * @return html
+	 * @return null|HTMLText
 	 */	
 	public function doShowVersion($data, $form) {
 		$versionID = null;

code/controllers/CMSSettingsController.php

Doc Comments +2 added lines, -2 removed lines

@@ -63,7 +63,7 @@ 
 	/**
 	 * Used for preview controls, mainly links which switch between different states of the page.
 	 *
-	 * @return ArrayData
+	 * @return HTMLText
 	 */
 	public function getSilverStripeNavigator() {
 		return $this->renderWith('CMSSettingsController_SilverStripeNavigator');
@@ -74,7 +74,7 @@ 
 	 *
 	 * @param array $data 
 	 * @param Form $form 
-	 * @return String
+	 * @return SS_HTTPResponse
 	 */
 	public function save_siteconfig($data, $form) {
 		$siteConfig = SiteConfig::current_site_config();

code/controllers/ReportAdmin.php

Doc Comments +1 added lines, -1 removed lines

@@ -80,7 +80,7 @@
 	 * Return a SS_List of SS_Report subclasses
 	 * that are available for use.
 	 *
-	 * @return SS_List
+	 * @return null|SS_List
 	 */
 	public function Reports() {
  		$output = new ArrayList();

code/forms/SiteTreeURLSegmentField.php

Doc Comments +2 added lines, -1 removed lines

@@ -87,13 +87,14 @@
 	
 	/**
 	 * @param the url that prefixes the page url segment field
+	 * @param string $url
 	 */
 	public function setURLPrefix($url){
 		$this->urlPrefix = $url;
 	}
 	
 	/**
-	 * @return the url prefixes the page url segment field to show in template
+	 * @return string url prefixes the page url segment field to show in template
 	 */
 	public function getURLPrefix(){
 		return $this->urlPrefix;

code/model/SiteTree.php

Doc Comments +4 added lines, -7 removed lines

@@ -932,7 +932,7 @@ 
 	 * 
 	 * @param string $stage
 	 * @param Member $member
-	 * @return bool
+	 * @return boolean|string
 	 */
 	public function canViewStage($stage = 'Live', $member = null) {
 		$oldMode = Versioned::get_reading_mode();
@@ -994,9 +994,6 @@ 
 	 * @uses DataExtension->canCreate()
 	 *
 	 * @param Member $member
-	 * @param array $context Optional array which may contain array('Parent' => $parentObj)
-	 *                       If a parent page is known, it will be checked for validity.
-	 *                       If omitted, it will be assumed this is to be created as a top level page.
 	 * @return bool True if the current user can create pages on this class.
 	 */
 	public function canCreate($member = null) {
@@ -1291,7 +1288,7 @@ 
 	/**
 	 * Get the 'can edit' information for a number of SiteTree pages.
 	 *
-	 * @param array $ids       An array of IDs of the SiteTree pages to look up
+	 * @param integer[] $ids       An array of IDs of the SiteTree pages to look up
 	 * @param int   $memberID  ID of member
 	 * @param bool  $useCached Return values from the permission cache if they exist
 	 * @return array
@@ -1362,7 +1359,7 @@ 
 	 *
 	 * @param string $condition The PHP condition to be evaluated. The page will be called $item
 	 * @param array  $collator  An array, passed by reference, to collect all of the matching descendants.
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public function collateDescendants($condition, &$collator) {
 		if($children = $this->Children()) {
@@ -1813,7 +1810,7 @@ 
 	 * @deprecated 3.1 Use DependentPages()->Count() instead.
 	 *
 	 * @param bool $includeVirtuals Set to false to exlcude virtual pages.
-	 * @return ArrayList
+	 * @return integer
 	 */
 	public function DependentPagesCount($includeVirtuals = true) {
 		Deprecation::notice('3.1', 'Use SiteTree->DependentPages()->Count() instead.');