SemanticMediaWiki / SemanticMediaWiki

includes/storage/SMW_SQLHelpers.php

Doc Comments +2 added lines, -5 removed lines

@@ -63,8 +63,7 @@ 
 	 * @note The function partly ignores the order in which fields are set up.
 	 * Only if the type of some field changes will its order be adjusted explicitly.
 	 *
-	 * @param string $tableName The table name. Does not need to have been passed to DatabaseBase->tableName yet.
-	 * @param array $columns The fields and their types the table should have.
+	 * @param string $rawTableName The table name. Does not need to have been passed to DatabaseBase->tableName yet.
 	 * @param DatabaseBase or Database $db
 	 * @param object $reportTo Object to report back to.
 	 */
@@ -88,7 +87,6 @@ 
 	 * Creates a new database table with the specified fields.
 	 *
 	 * @param string $tableName The table name.
-	 * @param array $columns The fields and their types the table should have.
 	 * @param DatabaseBase|Database $db
 	 */
 	private static function createTable( $tableName, array $fields, $db ) {
@@ -116,7 +114,6 @@ 
 	 * Update a table given an array of field names and field types.
 	 *
 	 * @param string $tableName The table name.
-	 * @param array $columns The fields and their types the table should have.
 	 * @param DatabaseBase|Database $db
 	 * @param object $reportTo Object to report back to.
 	 */
@@ -344,7 +341,7 @@ 
 	 * Make sure that each of the column descriptions in the given array is
 	 * indexed by *one* index in the given DB table.
 	 *
-	 * @param string $tableName table name. Does not need to have been passed to DatabaseBase->tableName yet.
+	 * @param string $rawTableName table name. Does not need to have been passed to DatabaseBase->tableName yet.
 	 * @param array $indexes array of strings, each a comma separated list with column names to index
 	 * @param DatabaseBase|Database $db DatabaseBase or Database
 	 * @param object $reportTo object to report messages to; since 1.8

includes/storage/SQLStore/SMW_Sql3SmwIds.php

Doc Comments +2 added lines, -3 removed lines

@@ -637,7 +637,7 @@ 
 	 *
 	 * @param integer $sid
 	 * @param DIWikiPage $subject
-	 * @param integer|string|null $interWiki
+	 * @param string $interWiki
 	 */
 	public function updateInterwikiField( $sid, DIWikiPage $subject, $interWiki = null ) {
 
@@ -891,9 +891,8 @@ 
 	/**
 	 * @since 2.3
 	 *
-	 * @param integer $id
 	 *
-	 * @return string[]
+	 * @return DIWikiPage[]
 	 */
 	public function getDataItemPoolHashListFor( array $idlist ) {
 		return $this->byIdDataItemFinder->getDataItemPoolHashListFor( $idlist );

includes/storage/SQLStore/SMW_Sql3StubSemanticData.php

Doc Comments +2 added lines, -1 removed lines

@@ -75,7 +75,7 @@ 
 	 *
 	 * @since 2.3
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function __sleep() {
 		return array( 'mSubject', 'mPropVals', 'mProperties', 'subSemanticData', 'mStubPropVals' );
@@ -203,6 +203,7 @@ 
 	 * yet to ensure data consistency
 	 *
 	 * @since 2.0
+	 * @param string $subobjectName
 	 */
 	public function hasSubSemanticData( $subobjectName = null ) {
 

includes/storage/SQLStore/SMW_SQLStore3.php

Doc Comments +10 added lines, -7 removed lines

@@ -236,6 +236,9 @@ 
 		return $this->reader;
 	}
 
+	/**
+	 * @return SemanticData
+	 */
 	public function getSemanticData( DIWikiPage $subject, $filter = false ) {
 
 		$result = $this->cachedValueLookupStore->getSemanticData(
@@ -247,9 +250,9 @@ 
 	}
 
 	/**
-	 * @param mixed $subject
+	 * @param DIWikiPage $subject
 	 * @param DIProperty $property
-	 * @param null $requestoptions
+	 * @param null $requestOptions
 	 *
 	 * @return SMWDataItem[]
 	 */
@@ -386,7 +389,7 @@ 
 	/**
 	 * @param RequestOptions|null $requestOptions
 	 *
-	 * @return CachedListLookup
+	 * @return SMW\SQLStore\Lookup\CachedListLookup
 	 */
 	public function getPropertiesSpecial( $requestOptions = null ) {
 		return $this->factory->newPropertyUsageCachedListLookup( $requestOptions );
@@ -395,7 +398,7 @@ 
 	/**
 	 * @param RequestOptions|null $requestOptions
 	 *
-	 * @return CachedListLookup
+	 * @return SMW\SQLStore\Lookup\CachedListLookup
 	 */
 	public function getUnusedPropertiesSpecial( $requestOptions = null ) {
 		return $this->factory->newUnusedPropertyCachedListLookup( $requestOptions );
@@ -404,7 +407,7 @@ 
 	/**
 	 * @param RequestOptions|null $requestOptions
 	 *
-	 * @return CachedListLookup
+	 * @return SMW\SQLStore\Lookup\CachedListLookup
 	 */
 	public function getWantedPropertiesSpecial( $requestOptions = null ) {
 		return $this->factory->newUndeclaredPropertyCachedListLookup( $requestOptions );
@@ -452,7 +455,7 @@ 
 	 *
 	 * @since 1.8
 	 * @param Title $concept
-	 * @return array of error strings (empty if no errors occurred)
+	 * @return string[] of error strings (empty if no errors occurred)
 	 */
 	public function refreshConceptCache( Title $concept ) {
 		return $this->factory->newMasterConceptCache()->refreshConceptCache( $concept );
@@ -494,7 +497,7 @@ 
 	 * @since 1.8
 	 *
 	 * @param SMWRequestOptions|null $requestOptions
-	 * @param string $valuecol
+	 * @param string $valueCol
 	 *
 	 * @return array
 	 */

includes/storage/SQLStore/SMW_SQLStore3_SetupHandlers.php

Doc Comments +1 added lines

@@ -243,6 +243,7 @@
 	 * Create some initial DB entries for important built-in properties. Having the DB contents predefined
 	 * allows us to safe DB calls when certain data is needed. At the same time, the entries in the DB
 	 * make sure that DB-based functions work as with all other properties.
+	 * @param boolean $verbose
 	 */
 	protected function setupPredefinedProperties( $verbose, DatabaseBase $db ) {
 		global $wgDBtype;

src/Deserializers/DVDescriptionDeserializer/RecordValueDescriptionDeserializer.php

Doc Comments +3 added lines

@@ -93,6 +93,9 @@
 		}
 	}
 
+	/**
+	 * @param integer $propertyIndex
+	 */
 	private function getDescriptionForProperty( $diProperty, $values, &$valueIndex, $propertyIndex ) {
 
 		$values[$valueIndex] = str_replace( "-3B", ";", $values[$valueIndex] );

src/Deserializers/DVDescriptionDeserializer/TimeValueDescriptionDeserializer.php

Doc Comments +3 added lines

@@ -91,6 +91,9 @@
 		return $description;
 	}
 
+	/**
+	 * @param \SMWDataItem $dataItem
+	 */
 	private function getUpperLimit( $dataItem ) {
 
 		$prec = $dataItem->getPrecision();

src/Deserializers/ExpDataDeserializer.php

Doc Comments +3 added lines

@@ -50,6 +50,9 @@
 		return new ExpData( ExpElement::newFromSerialization( $subject ) );
 	}
 
+	/**
+	 * @param ExpData $expData
+	 */
 	private function doDeserialize( $serialization, $expData ) {
 
 		foreach ( $serialization['data'] as $data ) {

src/Deserializers/SemanticDataDeserializer.php

Doc Comments +2 added lines

@@ -95,6 +95,7 @@ 
 	}
 
 	/**
+	 * @param DIProperty $property
 	 * @return DataItem
 	 */
 	private function doDeserializeDataItem( $property, $data, $value, $semanticData ) {
@@ -154,6 +155,7 @@ 
 	 * otherwise the subobject is neglected (of course one could set an error
 	 * value to the DIContainer but as of now that seems unnecessary)
 	 *
+	 * @param SMWContainerSemanticData $semanticData
 	 * @return DIContainer|null
 	 */
 	private function unserializeSubobject( $data, $id, $semanticData ) {