[Bug web/50642] New: onlinedocs formated text too small to read

[Bug web/50642] New: onlinedocs formated text too small to read

[jg at jguk dot org]

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

             Bug #: 50642
           Summary: onlinedocs formated text too small to read
    Classification: Unclassified
           Product: gcc
           Version: unknown
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: web
        AssignedTo: unassigned@gcc.gnu.org
        ReportedBy: jg@jguk.org


Discussed on the mailing list:

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

8 Jul 2011:

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

[Bug web/50642] onlinedocs formated text too small to read

[paolo.carlini at oracle dot com]

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

--- Comment #1 from Paolo Carlini <paolo.carlini at oracle dot com> 2011-10-07 00:21:00 UTC ---
I must say, I have been using Firefox on Linux exclusively for years, and
years, and never had this issue with my normal setup in terms of font size (the
same I use for, I don't know, Slashdot or online newspapers). I guess it's
largely matter of personal taste (my sight is absolutely average, for sure)

[Bug web/50642] onlinedocs formated text too small to read

[redi at gcc dot gnu.org]

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

--- Comment #2 from Jonathan Wakely <redi at gcc dot gnu.org> 2011-10-07 00:49:31 UTC ---
I think this PR is valid, I don't see why the fixed-width text has to be so
small. I *can* read it at that size, but I'd prefer if it was the same size as
the text in a proportional font.

[Bug web/50642] onlinedocs formated text too small to read

[gjl at gcc dot gnu.org]

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

Georg-Johann Lay <gjl at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |documentation
             Status|UNCONFIRMED                 |NEW
   Last reconfirmed|                            |2011-10-07
                 CC|                            |gjl at gcc dot gnu.org
     Ever Confirmed|0                           |1

--- Comment #3 from Georg-Johann Lay <gjl at gcc dot gnu.org> 2011-10-07 08:23:48 UTC ---
Agree. I don't see why fixed withs fonts should be smaller. I am using FireFox
and Opera where the normal font is easy to read but the examples are hardly
readable.

It's no big dead to change this and most examples are small, anyway, i.e. just
a few lines of code. So it won't hurt to print them normal sized.

[Bug web/50642] onlinedocs formated text too small to read

[schwab@linux-m68k.org]

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

--- Comment #4 from Andreas Schwab <schwab@linux-m68k.org> 2011-10-07 16:33:46 UTC ---
A @smallexample is supposed to be smaller than an @example.

[Bug web/50642] onlinedocs formated text too small to read

[gjl at gcc dot gnu.org]

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

--- Comment #5 from Georg-Johann Lay <gjl at gcc dot gnu.org> 2011-10-07 17:17:30 UTC ---
Legibility first. There is no need to be more catholic than the pope ;-)

[Bug web/50642] onlinedocs formated text too small to read

[jg at jguk dot org]

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

--- Comment #6 from Jon Grant <jg at jguk dot org> 2011-11-12 22:15:36 UTC ---
Could this be followed up with the proposed change implemented?

pre.smallexample { font-size:normal }

Thanks, Jon

[Bug web/50642] onlinedocs formated text too small to read

[skannan at redhat dot com]

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

Shakthi Kannan <skannan at redhat dot com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |skannan at redhat dot com

--- Comment #7 from Shakthi Kannan <skannan at redhat dot com> 2013-04-18 09:40:36 UTC ---
'Small' can mean different things depending on the context. It can refer to a
simple example, or something that is tiny.

On Mozilla Firefox 16.0.2, the 'smallexample' is indeed difficult to read. 

Please change the font size to normal. If it appears similar to the text, a
different font family can be used.

[Bug web/50642] onlinedocs formated text too small to read

[manu at gcc dot gnu.org]

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

Manuel López-Ibáñez <manu at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |manu at gcc dot gnu.org

--- Comment #8 from Manuel López-Ibáñez <manu at gcc dot gnu.org> 2013-04-18 10:02:13 UTC ---
(In reply to comment #7)
> 
> Please change the font size to normal. If it appears similar to the text, a
> different font family can be used.

Please send a patch to gcc-patches with [wwwdocs] in the subsject. My guess is
that nobody cares enough to bother to submit a patch. If someone submitted a
patch, Gerald most likely will approve it.
>From gcc-bugs-return-420527-listarch-gcc-bugs=gcc.gnu.org@gcc.gnu.org Thu Apr 18 10:06:21 2013
Return-Path: <gcc-bugs-return-420527-listarch-gcc-bugs=gcc.gnu.org@gcc.gnu.org>
Delivered-To: listarch-gcc-bugs@gcc.gnu.org
Received: (qmail 8322 invoked by alias); 18 Apr 2013 10:06:20 -0000
Mailing-List: contact gcc-bugs-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Id: <gcc-bugs.gcc.gnu.org>
List-Archive: <http://gcc.gnu.org/ml/gcc-bugs/>
List-Post: <mailto:gcc-bugs@gcc.gnu.org>
List-Help: <mailto:gcc-bugs-help@gcc.gnu.org>
Sender: gcc-bugs-owner@gcc.gnu.org
Delivered-To: mailing list gcc-bugs@gcc.gnu.org
Received: (qmail 8276 invoked by uid 48); 18 Apr 2013 10:06:18 -0000
From: "skannan at redhat dot com" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug web/53632] [bugzilla] Bugzilla being very slow to submit changes, sending duplicate emails
Date: Thu, 18 Apr 2013 10:06:00 -0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: web
X-Bugzilla-Keywords:
X-Bugzilla-Severity: normal
X-Bugzilla-Who: skannan at redhat dot com
X-Bugzilla-Status: NEW
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Changed-Fields: CC
Message-ID: <bug-53632-4-H2xN9rpgef@http.gcc.gnu.org/bugzilla/>
In-Reply-To: <bug-53632-4@http.gcc.gnu.org/bugzilla/>
References: <bug-53632-4@http.gcc.gnu.org/bugzilla/>
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
Content-Type: text/plain; charset="UTF-8"
MIME-Version: 1.0
X-SW-Source: 2013-04/txt/msg01672.txt.bz2
Content-length: 501


http://gcc.gnu.org/bugzilla/show_bug.cgi?idS632

Shakthi Kannan <skannan at redhat dot com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |skannan at redhat dot com

--- Comment #12 from Shakthi Kannan <skannan at redhat dot com> 2013-04-18 10:06:16 UTC ---
Is there a tool deployed to monitor Bugzilla? Perhaps, Piwik?

  http://piwik.org/

[Bug web/50642] onlinedocs formated text too small to read

[skannan at redhat dot com]

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

--- Comment #10 from Shakthi Kannan <skannan at redhat dot com> 2013-05-06 10:33:33 UTC ---
Created attachment 30037
  --> http://gcc.gnu.org/bugzilla/attachment.cgi?id=30037
Normal font for smallexample using update_web_docs_svn script

As mentioned in the gcc-patches list, the online docs are updated using
maintainer-scripts/update_web_docs_svn script. The attached patch runs makeinfo
from this script with html.css to override @smallexample attributes.

[Bug web/50642] onlinedocs formated text too small to read

[jg at jguk dot org]

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

--- Comment #11 from Jon Grant <jg at jguk dot org> ---
Hi

The problem is still visible for me with default new Firefox profile:

Screenshot:
http://justpaste.it/2zap

Who can re-generate the website?

Regards

[Bug web/50642] onlinedocs formated text too small to read

[skannan at redhat dot com]

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

--- Comment #12 from Shakthi Kannan <skannan at redhat dot com> ---
Hi,

----- Original Message -----
| From: "jg at jguk dot org" <gcc-bugzilla@gcc.gnu.org>
|
| The problem is still visible for me with default new Firefox profile:
\--

The patch has not yet been committed to the trunk.

SK