Làm thế nào để vô hiệu hóa cú pháp lệnh cắt giảm trong Doxygen

Question

Tôi đã gặp sự cố với PHP 5.3 không gian tên và nhận xét Doxygen.

Ví dụ:

/** 
* Sample Method 
* 
* @param string $output 
* @return \Project\Lib\Rest 
*/ 

Doxygen mang lại cho tôi những lời cảnh báo sau đây:

warning: Found unknown command `\Project' 
warning: Found unknown command `\Lib' 
warning: Found unknown command `\Rest' 

Những gì tôi có thể làm gì để khắc phục điều này hoặc tắt \ lệnh và chỉ sử dụng @commands

Answer 1

Cố gắng thoát dấu gạch chéo ngược của bạn, tức là sử dụng

/** 
* Sample Method 
* 
* @param string $output 
* @return \\Project\\Lib\\Rest 
*/ 

\\ thực sự là lệnh doxygen chỉ in dấu gạch chéo ngược.

Xem thêm Documenting PHP with Doxygen: The Pros and Cons:

/** 
* Sample Method 
* 
* @param string $output 
* @return Project::Lib::Rest 
*/