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
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)
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.
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.
A @smallexample is supposed to be smaller than an @example.
Legibility first. There is no need to be more catholic than the pope ;-)
Could this be followed up with the proposed change implemented? pre.smallexample { font-size:normal } Thanks, Jon
'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.
(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.
Created attachment 29978 [details] Override @smallexample attributes The attached patch overrides the default @smallexample attributes defined by makeinfo. It includes a html.css file where the smallexample attributes are defined to use a medium font size with a light blue background for readability and clarity. The patch has also been sent to the gcc-patches mailing list: http://gcc.gnu.org/ml/gcc-patches/2013-04/msg01766.html
Created attachment 30037 [details] 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.
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
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
Hello Could this be committed to the trunk please?
(In reply to Jon Grant from comment #13) > Hello > Could this be committed to the trunk please? Not everybody reads all messages in bugzilla. Patches go to gcc-patches. See comment #8. CC Gerald (see MAINTAINERS for email address).
I'm working on this. First I will have the online documentation reference our global CSS style ( https://gcc.gnu.org/gcc.css ), then we can easily tweak that.
Author: gerald Date: Sun Sep 4 19:38:05 2016 New Revision: 239981 URL: https://gcc.gnu.org/viewcvs?rev=239981&root=gcc&view=rev Log: PR documentation/50642 * update_web_docs_svn (CSS): Introduce. Have generated files refer to it. Modified: trunk/maintainer-scripts/ChangeLog
I believe this should be fixed now, cf. https://gcc.gnu.org/ml/gcc-patches/2016-09/msg00171.html https://gcc.gnu.org/ml/gcc-patches/2016-09/msg00172.html for the two patches to a script and our stylesheet, respectively. If anything requires (or desires) further tweaking, we can now easily do so.
Just looking at this page: https://gcc.gnu.org/onlinedocs/gcc/Enumerator-Attributes.html#Enumerator-Attributes The "deprecated" word appears to be smaller (like 9pt, compared to 11pt regular I estimate). I', using a default Firefox install and profile. Latest version of Ubuntu. I'll attach a screenshot
Created attachment 39552 [details] Firefox screenshot 4 September 2016 Shows the small text visible still.
Created attachment 39553 [details] Firefox font configuratoin (In reply to Jon Grant from comment #18) > Just looking at this page: > > https://gcc.gnu.org/onlinedocs/gcc/Enumerator-Attributes.html#Enumerator- > Attributes > > The "deprecated" word appears to be smaller (like 9pt, compared to 11pt > regular I estimate). I', using a default Firefox install and profile. Latest > version of Ubuntu. I'll attach a screenshot Thanks for sharing that. I confirm the same with Firefox on openSUSE Tumbleweed, and bet your font config dialog looks similar to mine. At this point this is not a GCC issue any longer, if Firefox deliberately uses a smaller font size for fixed width text, I guess.
Hi Gerald Thank you for replying. Ok, good its ok on GCC side. Thank you for checking on your machine. Well done for sorting this! Regards, Jonny