Add a bit of documentation

src/Psalm/Codebase/Analyzer.php

@@ -11,6 +11,11 @@ use Psalm\IssueBuffer;
 use Psalm\Provider\FileProvider;
 use Psalm\Provider\FileReferenceProvider;
 
+/**
+ * @internal
+ *
+ * Called in the analysis phase of Psalm's execution
+ */
 class Analyzer
 {
     /**

src/Psalm/Codebase/CallMap.php

@@ -4,6 +4,11 @@ namespace Psalm\Codebase;
 use Psalm\Type;
 use Psalm\FunctionLikeParameter;
 
+/**
+ * @internal
+ *
+ * Gets values from the call map array, which stores data about native functions and methods
+ */
 class CallMap
 {
     /**

src/Psalm/Codebase/ClassLikes.php

@@ -18,6 +18,11 @@ use Psalm\Storage\ClassLikeStorage;
 use Psalm\Type;
 use ReflectionProperty;
 
+/**
+ * @internal
+ *
+ * Handles information about classes, interfaces and traits
+ */
 class ClassLikes
 {
     /**

src/Psalm/Codebase/Methods.php

@@ -7,6 +7,11 @@ use Psalm\Provider\ClassLikeStorageProvider;
 use Psalm\Storage\MethodStorage;
 use Psalm\Type;
 
+/**
+ * @internal
+ *
+ * Handles information about class methods
+ */
 class Methods
 {
     /**

src/Psalm/Codebase/Populator.php

@@ -12,6 +12,11 @@ use Psalm\Storage\ClassLikeStorage;
 use Psalm\Storage\FileStorage;
 use Psalm\Type;
 
+/**
+ * @internal
+ *
+ * Populates file and class information so that analysis can work properly
+ */
 class Populator
 {
     /**

src/Psalm/Codebase/Properties.php

@@ -4,6 +4,11 @@ namespace Psalm\Codebase;
 use Psalm\CodeLocation;
 use Psalm\Provider\ClassLikeStorageProvider;
 
+/**
+ * @internal
+ *
+ * Handles information about class properties
+ */
 class Properties
 {
     /**

src/Psalm/Codebase/Reflection.php

@@ -11,6 +11,11 @@ use Psalm\Storage\MethodStorage;
 use Psalm\Storage\PropertyStorage;
 use Psalm\Type;
 
+/**
+ * @internal
+ *
+ * Handles information gleaned from class and function reflection
+ */
 class Reflection
 {
     /**

src/Psalm/Codebase/Scanner.php

@@ -8,6 +8,11 @@ use Psalm\Provider\FileStorageProvider;
 use Psalm\Provider\StatementsProvider;
 use Psalm\Scanner\FileScanner;
 
+/**
+ * @internal
+ *
+ * Contains methods that aid in the scanning of Psalm's codebase
+ */
 class Scanner
 {
     /**

src/Psalm/Type/Atomic/GetClassT.php

@@ -1,6 +1,9 @@
 <?php
 namespace Psalm\Type\Atomic;
 
+/**
+ * Represents a string whose value is a fully-qualified class found by get_class($var)
+ */
 class GetClassT extends T
 {
 }

src/Psalm/Type/Atomic/GetTypeT.php

@@ -1,6 +1,9 @@
 <?php
 namespace Psalm\Type\Atomic;
 
+/**
+ * Represents a string whose value is that of a type found by gettype($var)
+ */
 class GetTypeT extends T
 {
 }

src/Psalm/Type/Atomic/ObjectLike.php

@@ -4,6 +4,9 @@ namespace Psalm\Type\Atomic;
 use Psalm\Type;
 use Psalm\Type\Union;
 
+/**
+ * Represents an array where we know its key values
+ */
 class ObjectLike extends \Psalm\Type\Atomic
 {
     /**

src/Psalm/Type/Atomic/T.php

@@ -1,6 +1,10 @@
 <?php
 namespace Psalm\Type\Atomic;
 
+/**
+ * Represents a string that we know holds some type information about another variable,
+ * specified in the $typeof property
+ */
 abstract class T extends TString
 {
     /**

src/Psalm/Type/Atomic/TArray.php

@@ -1,6 +1,9 @@
 <?php
 namespace Psalm\Type\Atomic;
 
+/**
+ * Represents an array with generic type parameters.
+ */
 class TArray extends \Psalm\Type\Atomic
 {
     use GenericTrait;