保存功能订购PHPDoc的

Question

我跑我的项目phpdoc，有一个文件（唯一有意义的文件），其中的方法的顺序是分组方法很重要。如何在生成的文档中使用与源文件中相同的函数顺序？

其实，我已经准备好改变DOC框架下，如果有帮助。

Answer 1

我认为不可能声明特定的顺序。

这是不可能建立@package小号寿，这是在PHP意味着命名空间（据我所知..）。

如果你已经声明了一个@package，你可以定义@subpackage s到组方法/函数。

<?php 
namespace Stackexchange\Stackoverflow; 
/** 
* My Answer 
* @package Stackexchange\Stackoverflow 
* @see http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.subpackage.pkg.html 
*/ 

class Answer 
{ 
    /** 
    * @subpackage SomeSubGroup 
    * @return $this 
    */ 
    public function doSomething { 
     return $this; 
    } 

    /** 
    * @subpackage SomeOtherSubGroup 
    * @return $this 
    */ 
    public function doSomethingDifferent { 
     return $this; 
    } 
} 

除了分组功能，你应该尝试通过语义和逻辑分割大类成更小，商业部分，以提高你的编程。

Answer 2

检查以下网址的步骤，记录一个PHP程序，

http://pear.php.net/manual/en/package.php.phpdocumentor.intro.php

Answer 3

不幸的是，它不会出现有一种方法来告诉记录器什么顺序列出的方法。

但是，@see可能会有助于您提请注意相关功能。加上关于所需订单的完整描述中的说明，或者一些不按规定的例外可能是该工具当前可以提供的最佳方式。