logo       

Re: how to end the effect at the middle of a phrase: msg#00047

text.doxygen.general

Subject: Re: how to end the effect at the middle of a phrase

I have also been thinking about this, since I am running into the same problems. I would be in favor of introducing a '\ ' escape sequence (backslash followed by a space) which terminates a command without introducing a space.

For example "(bla \a x and \a y\ )" would give "(bla x and y)" with only x and y in a special font.
And "\link object_reference Object\endlink\ s" would give "Objects" with only the word "Object" as link.

If you really need a '\' followed by a space this is already catered for by escaping the '\' with '\\ '.

Would this be a possible solution or would it break something I have overlooked?

Regards,
Sander Niemeijer

On woensdag, feb 12, 2003, at 12:48 Europe/Amsterdam, Thomas Vesper wrote:

Ling Li wrote:
Hi, I have a very simple question but could not find the answer either
from the manual or the FAQ.
The problem is, /** blah (blah @a x and @a y) blah */
will not only italicize x and y, but also the closing parenthesis. I
could not find a simple way to tell Doxygen to "end the effect of @a"
just after y. Though /** blah (blah @a x and <em>y</em>) blah */
could work but it is not consistent (since most of the time I would use
@a).
Any thoughts?

Afaik, there's currently no solution for this.
(except the above mentioned and an additional and ugly space)
But there are some similiar problems.
E.g. you want to say "Objects" in a sentence but you want "Object" (w/o "s")
to be a link to the doc of "Object".
"Object s" is ugly and "Object's" is wrong.

Some kind of TeX-like {} might be useful.
Something that doesn't appear in the output but works as a delimiter for
doxygen.


Thomas




-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com
_______________________________________________
Doxygen-users mailing list
Doxygen-users@xxxxxxxxxxxxxxxxxxxxx
https://lists.sourceforge.net/lists/listinfo/doxygen-users




-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com


<Prev in Thread] Current Thread [Next in Thread>
Google Custom Search

News | FAQ | advertise