Inline reference {@see mymethod()} is not correctly resolved to FQSEN

[oschildt]

Description:

Inline reference {@see mymethod()} is not correctly resolved to FQSEN. When using @see as the tag, it is OK.

• Version used: master-dev
• Install method: composer
• php version: 7.2
• Operating system and version: Windows 10

Use this code and generate the doc using clean template:

<?php
/**
 * This file contains the implementation of the interface IRecordsetManager 
 * in the class RecordsetManager for working with record sets.
 *
 * @package Database
 */
 
namespace SmartFactory;

use SmartFactory\Interfaces\IRecordsetManager;
use SmartFactory\DatabaseWorkers\DBWorker;

/**
 * Class for working with record sets.
 */
class RecordsetManager implements IRecordsetManager
{
  /**
   * This is internal auxiliary function for saving a record set from an array
   * with key field values as array dimensions.
   *
   * It expand this multidimensional
   * array into the set of flat records suitable for call {@see saveRecord()}.
   *
   * @return boolean
   * Returns true if the subarray has been processed successfully, otherwise false.
   *
   * @see saveRecord()
   */
  protected function process_subarray()
  {
    return true;
  } // process_subarray

  /**
   * Saves a record from an array in the form "field_name" => "value" into the table.
   *
   * @return boolean
   * Returns true if the record has been successfully saved, otherwise false.
   */
  public function saveRecord()
  {
    return true;
  } // saveRecord
} // RecordsetManager

Expected Behavior

There is the doc block for the method process_subarray(). This block contains the reference @see saveRecord() - both as inline one and as a separate tag.

Both references should be resolved as:

\SmartFactory\RecordsetManager::saveRecord()

Actual Behavior

The tag reference @see saveRecord() is correctly resolved as:

\SmartFactory\RecordsetManager::saveRecord()

The inline reference {@see saveRecord()} is resolved wrong as:

\SmartFactory\saveRecord().

[jaapio]

I think this behavior is as intented. when you want to reference the current class you will need to add @see self::mymethod other wise phpdocumentor will assume that there is a function mymethod in your namespace. Since we are processing each file separate we cannot detect if this is really the case.

@ashnazg I'm missing this description in psr-5. Should we add that?