lechimp-p / dicto.php

src/Definition/AST/Factory.php

Doc Comments +2 added lines, -5 removed lines

@@ -40,7 +40,7 @@ 
 
     /**
      * @param   string  $atom
-     * @return  Name
+     * @return  Atom
      */
     public function atom($atom) {
         return new Atom($atom);
@@ -113,11 +113,8 @@ 
     }
 
     /**
-     * @param   Definition  $left
      * @param   Qualifier   $qualifier
-     * @param   Atom        $id
-     * @param   Parameter[] $parameters
-     * @return  Property
+     * @return  Rule
      */
     public function rule(Qualifier $qualifier, Definition $definition) {
         return new Rule($qualifier, $definition);

src/Definition/ASTParser.php

Doc Comments +8 added lines, -7 removed lines

@@ -159,7 +159,7 @@ 
     // IMPLEMENTATION OF Parser
 
     /**
-     * @return  Ruleset
+     * @return  AST\Root
      */
     public function parse($source) {
         $this->variables = array();
@@ -171,7 +171,7 @@ 
      * Root expression for the parser is some whitespace or comment where a
      * top level statement is in the middle.
      *
-     * @return  Ruleset 
+     * @return  AST\Root 
      */
     protected function root() {
         $lines = [];
@@ -232,6 +232,7 @@ 
 
     /**
      * @param   string
+     * @param string $content
      * @return  string
      */
     protected function trim_explanation($content) {
@@ -257,7 +258,7 @@ 
     /**
      * Fetch a string from the stream.
      *
-     * @return  string
+     * @return  AST\StringValue
      */
     protected function string() {
         $m = $this->current_match();
@@ -271,7 +272,7 @@ 
     /**
      * Fetch a variable from the stream.
      *
-     * @return  V\Variable
+     * @return  AST\Definition
      */
     protected function variable($right_binding_power = 0) {
         $t = $this->current_symbol();
@@ -326,7 +327,7 @@ 
     /**
      * Fetch a rule schema and its arguments from the stream.
      *
-     * @return  array   (R\Schema, array)
+     * @return  AST\Atom   (R\Schema, array)
      */
     protected function schema() {
         $t = $this->current_symbol();
@@ -344,7 +345,7 @@ 
     /**
      * Process a variable assignment.
      *
-     * @return  null
+     * @return  AST\Assignment
      */
     protected function variable_assignment() {
         $m = $this->current_match(); 
@@ -357,7 +358,7 @@ 
     /**
      * Process a rule declaration.
      *
-     * @return  null
+     * @return  AST\Rule
      */
     protected function rule_declaration() {
         if ($this->is_current_token_matched_by("only")) {

src/Definition/Compiler.php

Doc Comments +7 added lines, -4 removed lines

@@ -80,7 +80,7 @@ 
      * Compile an AST to an according entity.
      *
      * @param   AST\Node    $node
-     * @return  mixed
+     * @return  Ruleset
      */
     public function compile(AST\Root $node) {
         $this->variables = array();
@@ -203,6 +203,9 @@ 
         return $parameters;
     }
 
+    /**
+     * @return string
+     */
     protected function compile_qualifier(AST\Qualifier $node) {
         $which = $node->which();
         if ($which === AST\Qualifier::MUST) {
@@ -237,7 +240,7 @@ 
      * Get a predefined variable.
      *
      * @param   string  $name
-     * @return  V\Variable
+     * @return  V\Variable[]
      */
     protected function get_variable($name) {
         if (!array_key_exists($name, $this->variables)) {
@@ -250,7 +253,7 @@ 
      * Get a property. Yes. Really.
      *
      * @param   string  $name
-     * @return  V\Property
+     * @return  R\Property[]
      */
     protected function get_property($name) {
         if (!array_key_exists($name, $this->properties)) {
@@ -263,7 +266,7 @@ 
      * Get a schema. By name.
      *
      * @param   string  $name
-     * @return  V\Schema
+     * @return  R\Schema
      */
     protected function get_schema($name) {
         if (!array_key_exists($name, $this->schemas)) {

src/Report/Queries.php

Doc Comments +1 added lines, -1 removed lines

@@ -111,7 +111,7 @@
      * Get information about a run.
      *
      * @param   int $run
-     * @return  array<string,string>     with keys 'commit_hash'
+     * @return  integer     with keys 'commit_hash'
      */
     public function run_info($run) {
         $b = $this->result_db->builder();