I think there's bug in creating new action in controller with class php doc. Zend tools mangles controller code.

For example, i have class:

<?php
/**
 * For manipulating files.
 * 
 * @author Karol Ciba
 */
class Admin_FileController extends Zend_Controller_Action
{

    public function init()
    {
    }

    public function indexAction()
    {
        // action body
    }
}

when i try to create new action with: zf create action list file 1 admin, then controller class looks like this:

/**
 * For manipulating files.
 *
 * @author Karol Ciba
 *
 */


/**
 * For manipulating files.
 *
 * @author Karol Ciba
 *
 */
class Admin_FileController extends Zend_Controller_Action
{

    public function init()
    {
    }

    public function indexAction()
    {
        // action body
    }

    public function listAction()
    {
        // action body
    }


}

<?php
/* Zend_CodeGenerator_Php_File-DocblockMarker */