Tcl Source Code

View Ticket
Login
Ticket UUID: 472756c2bd71f0567b8821969f7a41d8e35c06c7
Title: Tcl manuals are hard to read on mobile devices
Type: Patch Version: 8.6
Submitter: nat-418 Created on: 2021-11-29 18:15:23
Subsystem: 69. Other Assigned To: nobody
Priority: 5 Medium Severity: Cosmetic
Status: Open Last Modified: 2021-12-04 23:24:36
Resolution: None Closed By: nobody
    Closed on:
Description:
The Tcl manual found at https://www.tcl-lang.org/man/tcl8.6/
use a stylesheet (https://www.tcl-lang.org/man/tcl8.6/docs.css)
that does not respond well to various screen sizes.

For example, I would like to read the manual on the train
with my smartphone, but to do so requires excessive zooming
and panning around.

There are a number of issues with the manual but I think I can
make surgical changes to fix the most glaring problems with this
CSS file. Specifically the following:

1. Changing absolute measurements like px to relative measurements like em.
2. Setting font-family to us native font stacks.
3. Calibrating color hues to be less garish.

I do not know how the HTML for these manual pages is generated.
There are some issues with non-semantic markup. For now I propose
to fix only the CSS.

I will attach a patch soon unless anyone objects to changing docs.css.
User Comments: nat-418 added on 2021-12-04 20:32:44:
I have attached an updated docs.css and single HTML meta tag that if applied would make the manual pages responsive.

Attachments: