This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: [v3] doxygen style tweaks
On Wed, Jul 21, 2004 at 01:08:09AM -0400, Phil Edwards wrote:
> On Tue, Jul 20, 2004 at 11:45:46PM -0500, Benjamin Kosnik wrote:
> > ! A.el { text-decoration: none; font-size: x-small; font-weight: normal }
> > ! A.elRef { text-decoration: none; font-size: x-small; font-weight: normal }
>
> The only problem with this is that the generated links in the middle of
> other sentences now looks really strange, e.g., in
>
> const string &str
>
> the "string" is teensy. I'd vote for different font styles, different
> colors, band music playing on mouse-hover, or something else less visually
> jarring. Just my opinion though.
I agree, it looks odd. Particularly when you have some functions that
link to docs and some that don't.
e.g.
fill_n specialisations are big'n'bold, default fill_n template is
small'n'blue:
http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a305
That page is laid out nicer than it used to be though.
It's easier to read with everything left-aligned. I liked having the
function names all on the same column, but it was just impractical
without a really small font or a huge display.
As an aside, the std::find() entries just below those std::fill_n() ones
include the overloads used for despatching on the iterator_type tags;
should those overloads be in __gnu_cxx rather than std ?
jon
--
"Malt does more than Milton can
To justify God's ways to man."
- Housman, A. E. (1859 - 1936)