This is the mail archive of the libstdc++@gcc.gnu.org mailing list for the libstdc++ project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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)


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]