2013-08-08 18 views
5

Mam pewne magiczne metody, ale wciąż mam funkcje automatycznego uzupełniania w netbeans. używam przede wszystkim klas blok jak:Doxygen ignores @ method

/** 
* @method int getEavConfigId() get object id 
* @method Model_DbTable_EavConfig setEntityType(string $entity_type) set entity_type possible values site, user, pc, ticket, alarm ; eav field is realted to this table 
* @method string getEntityType() get entity_type possible values site, user, pc, ticket, alarm ; eav field is realted to this table 
* @method Model_DbTable_EavConfig setCompanyId(integer $company_id) set company_id 
* @method integer getCompanyId() get company_id 
* @method Model_DbTable_EavConfig setType(string $type) set type possible values textfield, textarea, radio, checkbox, select ; eav field type 
* @method string getType() get type possible values textfield, textarea, radio, checkbox, select ; eav field type 
*/ 

dla NetBeans to działa całkiem dobrze. Ale szwy doxygen ignorują to totalnie.

Czy ktoś ma pomysł, aby umożliwić doxygenowi przyjęcie tagu @method?

Wiem, że phpDocumentator może sobie z tym poradzić. Ale przechowuję dokumentacje doxygen, spowodowane kilkoma przyczynami.

+1

* Można przedstawić propozycje udoskonaleń w [bug tracker] (http://www.stack.nl/~dimitri/doxygen/). Upewnij się, że powaga raportu o błędzie jest ustawiona na "ulepszenie". * ([Przez] (http://www.stack.nl/~dimitri/doxygen/)) - oraz w przypadku, gdy czytanie źródeł pomaga: https: // github.com/doxygen/doxygen – hakre

+0

@hakre thx, otwieram i nowy problem z wykrywaniem błędów. Mam nadzieję, że nie zostanie to zignorowane: https://bugzilla.gnome.org/show_bug.cgi?id=706099 – GreenRover

+0

Fajny raport, który powiedziałbym! Również poniższa odpowiedź nie wygląda zbyt źle. – hakre

Odpowiedz

3

Doxygen już wdrożył Twoje rozwiązanie problemu i jest znane jako ALIASES. Definicja aliasu powinna zostać określona w pliku konfiguracyjnym za pomocą znacznika konfiguracji ALIASES.

Proste aliasy

Najprostszą formą aliasu jest proste podstawienie postaci

name=value 

Na przykład definiując następujące Alias:

ALIASES += sideeffect="\par Side Effects:\n" 

pozwoli Ci umieścić command \ sideeffect (lub @sideeffect) w dokumentacji, co spowoduje, że zdefiniowany przez użytkownika akapit z nagłówkiem Skutki uboczne :.

Uwaga, w której można wstawić \ n w części wartości aliasu, aby wstawić znaki nowej linii.

Należy również pamiętać o tym, że można ponownie zdefiniować istniejące polecenia specjalne, jeśli chcesz.

Niektóre polecenia, takie jak \ xrefitem, są przeznaczone do użycia w połączeniu z aliasami.

Nadzieja to rozwiązać problem i uzyskać więcej informacji odwiedź DOXYGEN

+0

thx za odpowiedź. Ale jeśli dobrze zrozumiałem dokumentację, alias nie poradzi sobie z tym, czego szukam. Ponieważ z aliasami nie może być mowy o rzeczywistym zdefiniowaniu takich metod jak: 'public function setXyz()' i virtual (magic) metody takie jak '@metod int getEavConfigId() get id obiektu' połączone razem w bloku" Public Member Functions " . – GreenRover

+1

Tak, z powodzeniem generuje dokumenty, ponieważ zmieniłem metodę atrybutu jako \ fn w pliku konfiguracyjnym ALIASES = method = "\ fn" – Vineet1982

+0

Przepraszam, ale to nie zadziała. Ponieważ \ fn jego jaźń też nie będzie działać. Próbowałem następujący przykład: '/ *! \ fn ciąg Model_DbTable_EavConfig :: testTest (ciąg c, int n) * \ brief Funkcja członka. * * \ parametr ciąg znaków. * \ parametr n to liczba całkowita. * \ zwraca wskaźnik znaku. */' – GreenRover