onlinedocs formated text too small to read

onlinedocs formated text too small to read

[Jon Grant]

Hello

I'm using latest Firefox looking at the onlinedocs with a default
Firefox install, default font sizes, no change in zoom level.

http://gcc.gnu.org/onlinedocs/gcc/Variable-Attributes.html


The monospace text is tiny, e.g.:

<pre class="smallexample">          struct foo { int x[2]
__attribute__ ((aligned (8))); };
     </pre>


The fix is pretty easy, just change the embedded CSS that is generated:

  pre.smallexample { font-size:smaller }

I propose this be changed to:

  pre.smallexample { font-size:normal }


Note: There are some other CSS tags with "smaller", but they are
unused on that page, perhaps worth checking if the others are used in
other files and can be changed to "normal" as well.

I'm not on the mailing list, so please keep my email address in any replies.

Thanks, Jon

Re: onlinedocs formated text too small to read

[Andrew Pinski]

On Fri, Jul 8, 2011 at 10:50 AM, Jon Grant <jg@jguk.org> wrote:
> Hello
>
> I'm using latest Firefox looking at the onlinedocs with a default
> Firefox install, default font sizes, no change in zoom level.

Are you sure that this is not a bug in Firefox?  I think it is the
correct size for me with the version I am using.

Thanks,
Andrew Pinski

Re: onlinedocs formated text too small to read

[Paul Koning]

On Jul 8, 2011, at 1:54 PM, Andrew Pinski wrote:

> On Fri, Jul 8, 2011 at 10:50 AM, Jon Grant <jg@jguk.org> wrote:
>> Hello
>> 
>> I'm using latest Firefox looking at the onlinedocs with a default
>> Firefox install, default font sizes, no change in zoom level.
> 
> Are you sure that this is not a bug in Firefox?  I think it is the
> correct size for me with the version I am using.

It depends on what is viewed as correct.  I see a readable page in Safari, but it certainly is true that the examples are in rather small typeface and the fact that they are readable at all is partly due to the fact that I have a high resolution display.

Page layout and typographic design is very much a matter of opinion.  My opinion is that I can see no good reason at all for the examples to be in a smaller type size than the body text.  So I agree with Jon's change.  Smaller type should be used (if ever) for things like footnotes, but not in the body of the page.

	paul

Re: onlinedocs formated text too small to read

[Georg-Johann Lay]

Andrew Pinski wrote:
> On Fri, Jul 8, 2011 at 10:50 AM, Jon Grant <jg@jguk.org> wrote:
>> Hello
>>
>> I'm using latest Firefox looking at the onlinedocs with a default
>> Firefox install, default font sizes, no change in zoom level.
> 
> Are you sure that this is not a bug in Firefox?  I think it is the
> correct size for me with the version I am using.
> 
> Thanks,
> Andrew Pinski

I can confirm that it's hardly readable on some systems.
I use Opera and several FF versions, some worse, some a bit less worse.

IMO it's definitely to small, I already thought about complaining, too.

Johann

Re: onlinedocs formated text too small to read

[Georg-Johann Lay]

Jon Grant wrote:
> Hello
> 
> Georg-Johann Lay wrote, On 08/07/11 19:08:
> [.]
>> I can confirm that it's hardly readable on some systems.
>> I use Opera and several FF versions, some worse, some a bit less worse.
>>
>> IMO it's definitely to small, I already thought about complaining, too.
>>
>> Johann
> 
> Could I ask, what would be the best way to progress this request? e.g.
> Should I create a bugzilla ticket.
> 
> Best regards, Jon

http://gcc.gnu.org/ml/gcc/2011-07/msg00106.html

CCed Gerald, I think he cares for that kind of things.

If he does not answer (it's vacation time) file a PR so that it won't be forgotten.

Johann

Re: onlinedocs formated text too small to read

[Jon Grant]

Georg-Johann Lay wrote, On 01/08/11 09:40:
> Jon Grant wrote:
[.]
> http://gcc.gnu.org/ml/gcc/2011-07/msg00106.html
>
> CCed Gerald, I think he cares for that kind of things.
>
> If he does not answer (it's vacation time) file a PR so that it won't be forgotten.
>
> Johann

Thank you. I filled a PR now:

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=50642

Best regards, Jon

Re: onlinedocs formated text too small to read

[Gerald Pfeifer]

On Thu, 6 Oct 2011, Jon Grant wrote:
> Thank you. I filled a PR now:
> 
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=50642

Thanks you!  And sorry that this somehow fell through the cracks.

I have now adjusted our web site to use our global CSS for the
online documentation (and we can hence easily tweak things going
forward), cf. https://gcc.gnu.org/ml/gcc-patches/2016-09/msg00171.html
and https://gcc.gnu.org/ml/gcc-patches/2016-09/msg00172.html .

Gerald