small font in gcc online docs
Hello
I noticed that in the default Firefox3 configuration on my 1280x1024 display
your code samples on this page are tiny, and v.hard to read:
http://gcc.gnu.org/onlinedocs/gcc/Inline.html
I see in the HTML this is the code causing the small font:
pre.smallexample { font-size:smaller }
Would you consider just using regular sized text?
The CSS for inline doesn't have this problem, so you could even
display it that way?
Kind regards, Jon
RE: [help-texinfo] Re: small font in gcc online docs
Hello Karl,
Thanks for your reply.
> >> I see in the HTML this is the code causing the small font:
> >>
> >> pre.smallexample { font-size:smaller }
>
> I don't know of any way to say "use a slightly smaller font" in
> HTML/CSS. That is, this is what CSS provides, afaik.
>
> The reason that the above css exists at all is because users requested
> that @smallexample (the Texinfo command in question) produce smaller
> output than the regular @example, including in HTML. (Like
> @smalldisplay, @smallformat, @smallisp, and now @smallquotation.)
> Personally I don't have strong feelings about it.
Perhaps GCC could use @example rather than @smallexample ?
Does @smallexample come out as 8pt or so? It definitely looks smaller than
10pt on my screen.
Kind regards, Jon
RE: [help-texinfo] Re: small font in gcc online docs
Hi Karl, Thanks for your reply. > Does @smallexample come out as 8pt or so? It definitely looks > smaller than 10pt on my screen. > > It comes out as whatever your browser tells it to, hopefully depending > on what font size you have set. This is why different users see > different things. The effect should be similar to using > ..., although I expect there are browser(s) and > version(s) which don't implement any of this properly in the first > place. > > As for using @example instead of @smallexample, I suspect some of the > examples would then become too wide for the printed manual. http://gcc.gnu.org/onlinedocs/gcc/Inline.html In the printed manual, is text smaller or the same size as text? I suspect they will be the same, in which case they should both be the same readable size in the HTML version. Definitely each user can change the default browser settings, but I would hope pages would be readable without browser modification. See what it looks like at present for me with default Firefox3: http://img219.imageshack.us/my.php?image=firefox3inlineub4.png > I'm sorry, but I just don't see anything to do here. Every option will > displease someone. Let's see if the manual really does look different. Perhaps GCC could just use the as that works fine? Regards, Jon
RE: [help-texinfo] Re: small font in gcc online docs
Hi Karl, Thank you for your reply [..] > If some examples use @example and some examples use @smallexample, the > resulting inconsistency looks quite bad as well (in both printed manuals > and HTML). > > I doubt the GCC folks want to research and rewrite their examples to use > shorter lines (so @example could be used). > > Sorry, I am still stuck for any positive action. I think you are right, and Firefox3 should be configured with some sensible font sizes. However I've never been able to successfully get them to change anything in the past after filing a bug report.. so we may be stuck with this. Thank you again for working though this problem with us. Regards, Jon
RE: [help-texinfo] Re: small font in gcc online docs
Hi Manuel, Karl, Thank you for your replies. [...] > You are expecting that the CSS large/small/x-small/etc match those of > TeX. They are not matched. I don't know what formula TeX uses but > Firefox uses a lookup table that is available here: > > http://mxr.mozilla.org/mozilla/source/layout/style/nsStyleUtil.cpp#165 > > As you can see, for a medium font of 12 or 13 (which is the default > size in Firefox), the small font is 10. There is a bug opened about > this, but it doesn't seem to have attracted much interest. Perhaps you > could explain the issue there and give them some motivation to fix > this once and for all: > > https://bugzilla.mozilla.org/show_bug.cgi?id=187256 Ok, I've added a comment to the bug. It's already been open for six years, so I hope for a Firefox fix in due course.. I had to post the mail-archive link to the thread, as the gcc.gnu.org one doesn’t have any way to see the conversation tree, or even "[Next reply]" links atm, not sure if the InResponseToID changed or something. http://gcc.gnu.org/ml/gcc/2008-10/msg00391.html Kind regards, Jon
