Please describe the problem:
While running doxygen over a python module, some portions of files were missing 
from the generated output.

Some experimentation revealed that a ## comment with an apostrophe in it like 
this:
## A comment with a ' in it
Meant that all subsequent code was skipped by the doxygen parser until another 
matching apostrophe was found like this:
## Another comment with a ' in it


Steps to reproduce:
1. Try to document this:

"""Problems with apostrophes"""
class Included(object):
    """I get included in doxygen"""
    pass

##This following apostrophe ' really messes things up for subsequent code

class NotIncluded(object):
    """I do not get included in doxygen"""
    pass

#This following apostrophe ' makes doxygen happy again

class IncludedAgain(object):
    """I get included in doxygen thanks to the apostrophe above"""
    pass


Actual results:
The "Included" class and the "IncludedAgain" class appear in the generated 
documentation. The "NotIncluded" class does not

Expected results:
The "Included" class, the "NotIncluded" class, and the "IncludedAgain" class 
should all appear in the documentation

Does this happen every time?
Yes

Other information: