Re: [Doxygen-users] Doxygen creates unnecessary (unwanted) paragraphs.

[Christoph L. <chr...@li...>]

Hi Julian,

you probably have set JAVADOC_AUTOBRIEF=YES; to quote from the manual:

"If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret
the first line (until the first dot) of a Javadoc-style comment as the
brief description. If set to NO, the Javadoc-style will behave just like
regular Qt-style comments (thus requiring an explicit @brief command for
a brief description.)"

The brief description is always placed in a separate paragraph.


Am 02.06.2016 um 09:43 schrieb Julian:
> Hello everyone!
> 
> I recently started with doxygen and immediately ran into a problem.
> I wanted to document a method with a small paragraph of text, but for 
> some reason, Doxygen keeps splitting the paragraph into two.
> 
> This is the documentation in code:
> 
>      /**
>       * Returns the next character in the file without actually 
> consuming it.
>       * Once the end of the file is reached, this method returns the char
>       * equivalent of -1.
>       */
>      char look();
> 
> I expect Doxygen to create a documentation in a single paragraph, which 
> would look like this:
> 
> Returns the next character in the file without actually consuming it. 
> Once the end of the file is reached, this method returns the char 
> equivalent of -1.
> 
> However, I get this instead:
> 
> Returns the next character in the file without actually consuming it.
> 
> Once the end of the file is reached, this method returns the char 
> equivalent of -1.
> 
> This also persists if I put the in-code documentation in one single line.
> Could you maybe point me in the right direction what I am doing wrong or 
> what option I may have set wrongly in the configuration file?
> 
> Thanks in advance!
> 
> ------------------------------------------------------------------------------
> What NetFlow Analyzer can do for you? Monitors network bandwidth and traffic
> patterns at an interface-level. Reveals which users, apps, and protocols are 
> consuming the most bandwidth. Provides multi-vendor support for NetFlow, 
> J-Flow, sFlow and other flows. Make informed decisions using capacity 
> planning reports. https://ad.doubleclick.net/ddm/clk/305295220;132659582;e
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>