I have a lot of documentation done using 1.6.3.  In attempting to upgrade to 1.7.x, I discovered that both 1.7.3 and 1.7.5 handle whitespace around conditional @if statements and @endif statements differently.  The difference can be illustrated by writing text like the following:

   some text in front @if clike middle@endif tail text

1.7.5 eats the space before @if and after @endif, mangling the output and producing the following in the formatted output:

  some text in frontmiddletail text

Among the consequences is that if "middle" contained a reference to an object like a class name, the result won't be hyperlinked (because it's mangled and Doxygen itself fails to recognize it).  Here is an example of where it causes problems.  Suppose your code has this comment:

  /** 
   * Blah blah blah.
   *
   * Use the method @if java Compartment::setId(String id)@else setId()@endif. 
   */

The result in the formatted output will be:

  Blah blah blah.

  Use the methodsetId().

Doxygen 1.6.3 does not behave this way, and leaves the spaces in the final output.  I cannot find this change listed in the ChangeLog. I also don't know how to work around this behavior.

If I'm missing something obvious, or an explanation or a workaround, I apologize, and would appreciate it if someone could explain it to me.

Thanks.  BTW, Doxygen has been just a fantastic tool for us.  We use it to produce the documentation for our open-source library, libSBML.