[ECOS] [porting] web page widths

[ECOS] [porting] web page widths

[Grant Edwards]

First I'd like to compliment you guys on the nice clean HTML
used on your web pages.  That said, there is one minor thing
thing that bugs me -- but from what I know about HTML there
isn't much that can be done about it:

I've notced that the minimum width of the right hand column of
the web pages (white background with text) is set by the width
of any <pre></pre> sections (usually containing souce code
examples). On some pages those examples contain long lines,
resulting in tables where the normal (non-preformatted)
paragraphs have very long lines that don't wrap to fit
reasonable window widths. The user has to scroll left/right to
read the text.

I don't mind scrolling back and forth to see pre-formatted
source examples, but it would be nice if the normal paragaphs
wrapped to fit inside the browser window. Unfortunately, I
can't think of any suggestions on how to generate HTML that
would act that way, since the min column width is determined by
the widest object it contains. Arbitrarily wrapping source code
examples would be a bad idea, since it would make them harder
to understand. Changing to a smaller font size for fixed-width
text helps somewhat.

Like I said it's a minor problem, and I don't think there's
much that can be done about it...

-- 
Grant Edwards
grante@visi.com

Re: [ECOS] [porting] web page widths

[Grant Edwards]

> I've notced that the minimum width of the right hand column of
> the web pages (white background with text) is set by the width
> of any <pre></pre> sections (usually containing souce code
> examples). On some pages those examples contain long lines,
> resulting in tables where the normal (non-preformatted)
> paragraphs have very long lines that don't wrap to fit
> reasonable window widths. The user has to scroll left/right to
> read the text.

Unfortunately, this makes it impossible to print many of the
pages.  Are there PDF versions of the porting documentation
available?

-- 
Grant Edwards
grante@visi.com

Re: [ECOS] [porting] web page widths

[Jesper Skov]

>>>>> "Grant" == Grant Edwards <grante@visi.com> writes:

Grant> I've notced that the minimum width of the right hand column of
Grant> the web pages (white background with text) is set by the width
Grant> of any <pre></pre> sections (usually containing souce code
Grant> examples). On some pages those examples contain long lines,
Grant> resulting in tables where the normal (non-preformatted)
Grant> paragraphs have very long lines that don't wrap to fit
Grant> reasonable window widths. The user has to scroll left/right to
Grant> read the text.

Presumably this is the redboot-timer.h page you are referring to? I'll
break the line.

Jesper

Re: [ECOS] [porting] web page widths

[Grant Edwards]

On Mon, Jan 08, 2001 at 09:14:14AM +0100, Jesper Skov wrote:

> Grant> I've notced that the minimum width of the right hand column of
> Grant> the web pages (white background with text) is set by the width
> Grant> of any <pre></pre> sections (usually containing souce code
> Grant> examples). On some pages those examples contain long lines,
> Grant> resulting in tables where the normal (non-preformatted)
> Grant> paragraphs have very long lines that don't wrap to fit
> Grant> reasonable window widths. The user has to scroll left/right to
> Grant> read the text.
> 
> Presumably this is the redboot-timer.h page you are referring to? I'll
> break the line.

I don't remember.  I noticed it on several of the porting
pages. I printed out 4-5 of them and they all were chopped off
on the right hand side because the width of <pre></pre>
sections were wider than the page, and all of the other <p></p>
sections wrap to the same width as the widest <pre></pre>.

-- 
Grant Edwards
grante@visi.com