Re: [exim] Documentation: Options Index

Top Page
Delete this message
Reply to this message
Author: Always Learning
Date:  
To: exim-users
Subject: Re: [exim] Documentation: Options Index
> > The Options Index page at
> >

http://www.exim.org/exim-html-current/doc/html/spec_html/ch-option_index.html
> > doesn't display correctly in either Firefox or Safari. In three

places, the
> > paragraphs are shifted to the left and not displayed fully.



========================================

Look at the differences ......


<dt>-ex</dt>
<dd><p><a href="ch-the_exim_command_line.html#SECID39"
title="5. The Exim command line">The Exim command line<small>
[Command line options]</small></a></p></dd>


<dt>-f</dt>
<dd>
<p><a href="ch-the_exim_command_line.html#SECID39"
title="5. The Exim command line">The Exim command line<small>
[Command line options]</small></a>,
<a href="ch-security_considerations.html#SECID274"
title="54. Security considerations">Security considerations<small>
[Privileged users]</small></a></p>

********** NO CLOSING </dd> ******************

<dl>

<dt>for address testing</dt>
<dd><p><a href="ch-the_exim_command_line.html#SECID39"
title="5. The Exim command line">The Exim command line<small>
[Command line options]</small></a></p></dd>


<dt>for filter testing</dt>
<dd><p><a href="ch-the_exim_command_line.html#SECID39"
title="5. The Exim command line">The Exim command line<small>
[Command line options]</small></a></p></dd>


<dt>overriding From line</dt>
<dd><p><a href="ch-the_exim_command_line.html#SECID39"
title="5. The Exim command line">The Exim command line<small>
[Command line options]</small></a></p></dd>

</dl>

</dd>

************** IS THIS THE MISSING </dd> ??? ********


Good luck :-)






On Sat, 2014-02-15 at 21:52 -0800, Phil Pennock wrote:
> On 2014-02-14 at 12:12 -0800, Todd Lyons wrote:
> > On Fri, Feb 14, 2014 at 12:00 PM, Terry <tech@???> wrote:
> > >
> > > The Options Index page at
> > > http://www.exim.org/exim-html-current/doc/html/spec_html/ch-option_index.html
> > > doesn't display correctly in either Firefox or Safari. In three places, the
> > > paragraphs are shifted to the left and not displayed fully.
> >
> > Thanks for the report.
> >
> > > I took a quick look at the code and seems that these are nested <dl> tags.
> > > From what I've googled, nesting <dl> tags can cause problems.
> >
> > I've never used a <dl> tag in my life. Time for some googling.
>
> DL = Data List (IIRC), holds DT & DD in pairs, tag and definition. I'm
> not a web programmer, but the HTML looks well-formed, with a DL inside a
> DD. ISTR that I've even done this in the past, with hand-written HTML,
> back in the mid-nineties.
>
> Looking at the source, then at the referenced style sheet, I see this:
>
> dl dd dl{margin-left:-180px}
>
> That explains the left-shift, so the only question is _why_ is that
> there.
>
> I've looked with, on MacOS, all of Chrome, Firefox, Safari and Opera.
> In all four, all of the content can be fully viewed; it's an index, so
> the text is brief, I can't spot anything missing. Everything's off to
> the left, so the layout/typesetting is unsound and this is certainly a
> bug, but I'm not seeing anything inaccessible.
>
> > > For future reference, should bug reports be filed for the documentation?
> >
> > Yes please.
>
> What Todd said. :) Flaws in Exim's documentation are bugs, just like
> C level code bugs, just hopefully with fewer ramifications.
>
> -Phil
>

--
Paul.
England,
EU.

Our systems are exclusively Centos. No Micro$oft Windoze here.