RE: [Doxygen-users] Resetting indent after \param etc.?

[Prikryl,Petr <PRI...@sk...>]

You probably use some specific output format
(like HTML, LaTeX, RTF, etc.).  Could you post more details?

Generally, the problem is that some visual attributes of 
the generated text are related to the meaning of the text.
The text rendering is related to the generated output, and
can be also related to the expected output media (like paper
or screen).  For example, there are some typographic
rules that LaTeX tries to follow (say) implicitly.  Indenting
rules may be the example.  Another example, <li> elements
of HTML lists are rendered in some way.  They are the parts
of some list.  To typeset one paragraph so as if it was not
the part of the list, or you have to break the list around the
paragraph to two lists, or you have to do some really weird
things (read it "not recommended").

While there are some attributes that can be set on the level
of the chosen output format, they may be very different for
each of the format.  For example, it may be better to 
produce \param descriptions as the table in HTML.  In LaTeX
generator, other constructs may be prefered.

As a rule of thumb, you should never try to adjust visual
appearance by doing some special things inside your sources.
In my opinion, doxygen should not even allow this.  All the 
formating information should be related only to the meaning
of the text while allowing possible style changes on the 
generator level (i.e. by adding some Doxyfile configuration
options), or by changing the style of rendering of the generated
output later by (e.g.) modifying doxygen.css for the HTML
output, by adding some special style package or commands to
the LaTeX output, etc.

So, your request should be reformulated from the "formating
style" point of view.  

With regards, 
  Petr
-- 
Petr Prikryl, SKIL, spol. s r.o., pri...@sk...

> -----Original Message-----
> From:	Christopher Brewster [SMTP:bre...@ya...]
> Sent:	Friday, October 05, 2001 4:31 PM
> To:	dox...@li...
> Subject:	[Doxygen-users] Resetting indent after \param etc.?
> 
> I often need to put normal (unindented) \par text
> after indented paragraphs such as \param and \li. I
> finally noticed that those \par's are indented. (Sure
> enough, that's what the manual says it does!) The only
> way I've found to resume the unindented \par's is to
> have a "heading" consisting of "." only, on the first
> unindented \par following a \param. The dot is pretty
> unnoticeable but still a kluge. Is there a better way
> to reset the indent?
> 
> Christopher Brewster
> 
> __________________________________________________
> Do You Yahoo!?
> NEW from Yahoo! GeoCities - quick and easy web site hosting, just
> $8.95/month.
> http://geocities.yahoo.com/ps/info1
> 
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users