[bug #33056] Incorrect GSDoc output if #import is omitted in a header

[Quentin Mathé]

Follow-up Comment #2, bug #33056 (project gnustep):

The mail address '<qmathe@club-internet.fr>' belongs to 'Author:' in
ETFragment.h, so this should be ok. Autosgdoc documentation states:

"Any line of the form ' Author : name <email-address>', or ' By : name
<email-address>', or ' Author : name' or ' By : name' will be recognised and
converted to an author element, possibly containing an email element."

This is from the Extra markup section of
http://www.gnustep.org/resources/documentation/Developer/Tools/Reference/index.html

You can take look at ETFragment.h, it's a reduced test case.

The issue could be that AGSParser gets into an invalid state when no
#import/include is parsed. Given that all ObjC files include an
#import/include usually, the problem almost never arises.

It looks like AGSParser parses the top comment twice, as the ETFragment
protocol comment and as the main header comment. That's could be due to the
fact, it relies on parsing #import or some preprocessor directive to reset the
ivar 'comment' that acts a documentation accumulator.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?33056>

_______________________________________________
  Message posté via/par Savannah
  http://savannah.gnu.org/