GNOME Bugzilla – Bug 557564
Generated perlmod contains syntax error.
Last modified: 2018-07-30 10:11:41 UTC
I have a header file containing : ///@brief Return satellite Id. ///@details used by TPDBStorageManager template class. ///@see TPDBStorageManager. ///@return unsigned int satellite Id. unsigned int getId( void ); And the generated perlmod contains : detailed => { doc => [ { type => 'text', content => 'used by TPDBStorageManager template class. , see => [TPDBStorageManager. ' } ], return => [ { type => 'text', content => 'unsigned int satellite Id.' } ] ] }, Adding a blank line between @details and @see, i.e. ///@brief Return satellite Id. ///@details used by TPDBStorageManager template class. /// ///@see TPDBStorageManager. ///@return unsigned int satellite Id. unsigned int getId( void ); Fixes the problem, and the generated perlmod is : detailed => { doc => [ { type => 'text', content => 'used by TPDBStorageManager template class.' }, { type => 'parbreak' }, see => [ { type => 'text', content => 'TPDBStorageManager. ' } ], return => [ { type => 'text', content => 'unsigned int satellite Id.' } ] ] },
Incorrect doxygen formatting with the \struct tag also generates bad perl : /*! \struct CA system ID list \brief This struct give the header of CA system ID array and length of it \remarks pu16Ca_SystemID - CA system ID header u16Ca_SystemIDNum - length of CA system ID array */ typedef struct { unsigned short int* pu16CaSystemID; unsigned short int u16CaSystemIDNum; } CA_SYSID_LIST; Changing the \struct line to \struct CA_SYSID_LIST generates good perl results.
*** Bug 596813 has been marked as a duplicate of this bug. ***
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!