Pkg exim4 users - May 2012 - Home URLs at exim4-doc-html/spec_html/*.html should not point to exim.org

Package: exim4-doc-html
Version: 4.77-1
Files:   /usr/share/doc/exim4-doc-html/spec_html/*.html

  Regarding exim4-doc-html/spec_html/*.html:
The next and previous URL at each spec_html/*.html file points to
an appropriate spec_html file.  In contrast, the Home URL at the
beginning of each file leads to www.exim.org/index.html.
  I think that the same reasoning that led to having the
next/prevoius point to a spec_html file should be applied to
having the Home URL point to spec_html/index.html or filter.html.
  Will the maintainers consider a patch if I will submit one?

On Mon, May 28, 2012 at 06:59:26PM -0700, Regid Ichira
wrote:
>   Regarding exim4-doc-html/spec_html/*.html:
> The next and previous URL at each spec_html/*.html file points to
> an appropriate spec_html file.  In contrast, the Home URL at the
> beginning of each file leads to www.exim.org/index.html.
>   I think that the same reasoning that led to having the
> next/prevoius point to a spec_html file should be applied to
> having the Home URL point to spec_html/index.html or filter.html.
>   Will the maintainers consider a patch if I will submit one?
If things are the same in the upstream package, please report the
issue upstream.

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don''t trust Computers. They | Mailadresse
im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 31958061
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 31958062

--- On Tue, 5/29/12, Marc Haber wrote:
> On Mon, May 28, 2012 at 06:59:26PM -0700, Regid Ichira wrote:
> >???Regarding exim4-doc-html/spec_html/*.html:
> > The next and previous URL at each spec_html/*.html file points to
> > an appropriate spec_html file.? In contrast, the Home URL at the
> > beginning of each file leads to www.exim.org/index.html.
> >???I think that the same reasoning that led to having the
> > next/prevoius point to a spec_html file should be applied to
> > having the Home URL point to spec_html/index.html or filter.html.
> >???Will the maintainers consider a patch
> if I will submit one?
> 
> If things are the same in the upstream package, please
> report the issue upstream.
> 

  Asked 24h ago at
https://lists.exim.org/lurker/thread/20120530.205053.37e57f55.en.html#i20120530.205053.37e57f55

On Thu, May 31, 2012 at 11:07:12AM -0700, Regid Ichira
wrote:
>   Asked 24h ago at
>  
https://lists.exim.org/lurker/thread/20120530.205053.37e57f55.en.html#i20120530.205053.37e57f55
Thanks. Upstream is better in remembering bug reports when they are
reported via their bugzilla though.

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don''t trust Computers. They | Mailadresse
im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 31958061
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 31958062

--- On Fri, 6/1/12, Marc Haber wrote:
> Thanks. Upstream is better in remembering bug reports when
> they are reported via their bugzilla though.
> 

  I have created http://bugs.exim.org/show_bug.cgi?id=1257

Somewhat related:
I think the exim4-doc-html used to ship the upstream table of contents
to the whole html documentation.  I mean the page with links to the
local spec.html and filter.html.  Why have you stopped doing that? 
Can''t
the omission of that page make users not notice filter.html ?

On Fri, Jun 01, 2012 at 05:56:37AM -0700, Regid Ichira
wrote:
> I think the exim4-doc-html used to ship the upstream table of contents
> to the whole html documentation.  I mean the page with links to the
> local spec.html and filter.html.  Why have you stopped doing that? 
Can''t
> the omission of that page make users not notice filter.html ?
I don''t remember. Maybe it was inadvertently. What exactly is missing?

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don''t trust Computers. They | Mailadresse
im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 31958061
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 31958062

Regid Ichira wrote:
> I think the exim4-doc-html used to ship the upstream table of contents
> to the whole html documentation.  I mean the page with links to the
> local spec.html and filter.html.  Why have you stopped doing that? 
Can''t
> the omission of that page make users not notice filter.html ?
Not sure the ToC above the spec/filter would have made much sense to
ship as it contained linked to several different versions.

This may have changed since we did do an awful lot of damage or possibly
improvement with the doc/website revamp in 2010 - it also made the
generation tools sane, repeatable and relatively fast & compact.

I was going to look at putting a per chapter ToC into the footer when I
got the chance - it should be relatively easy (although may need a css
change too).  I suspect its not there currently because we added the
pop-out ToC (but that probably fails without javascript support and may
have issues working from local filestore).

	Nigel.
-- 
[ Nigel Metheringham ------------------------------ nigel at dotdot.it ]
[                 Ellipsis Intangible Technologies                  ]

--- On Fri, 6/1/12, Nigel Metheringham wrote:
> Regid Ichira wrote:
> > I think the exim4-doc-html used to ship the upstream
> table of contents
> > to the whole html documentation.? I mean the page
> with links to the
> > local spec.html and filter.html.? Why have you
> stopped doing that?? Can''t
> > the omission of that page make users not notice
> filter.html ?
> 
> Not sure the ToC above the spec/filter would have made much
> sense to
> ship as it contained linked to several different versions.
> 
  eximdoc4-4.77/doc-docbook/index.html has only 2 links: 1 to 
spec.html and the other to filter.html.  I think debian used to
ship a similar file somewhere in /usr/share/doc/exim4-doc-html/.
> I was going to look at putting a per chapter ToC into the
> footer when I
> got the chance - it should be relatively easy (although may
> need a css
> change too).? I suspect its not there currently because
> we added the
> pop-out ToC (but that probably fails without javascript
> support and may
> have issues working from local filestore).
> 
  The local spec.html that I got from Debian and the one I see
on exim.org have the same format.  I don''t see any pop-out ToC.  
Is it because I am using various firefox add-ons? 
  On what circumstances do the pop-out ToC pops out?  I mean,
should it pop out when the mouse is over some word?  Does it
makes the reader wait a short time until it disappears?  Does
it constantly occupies valuable screen area?
  My preference is a per chapter ToC in the footer, and as less
javascript as possible.

I''ve modded the generation scripts to add a TOC link to the bottom of
each chapter, and make the title of each chapter a link to the TOC.  I
can see no open bug for this, so have not linked it to the bug report.

This change will be in 4.81 when it is released, which I suspect will be
a relatively short turn round.

There is a bug report - http://bugs.exim.org/show_bug.cgi?id=1114 - for
missing items from the html docs tarballs.  This explains the other
issues discussed within this thread.
I''m currently discussing this with some of the other maintainers.

	Nigel.

-- 
[ Nigel Metheringham ------------------------------ nigel at dotdot.it ]
[                 Ellipsis Intangible Technologies                  ]

--- On Sat, 6/9/12, Nigel Metheringham wrote:
> I''ve modded the generation scripts to add a TOC link to the bottom
of
> each chapter, and make the title of each chapter a link to the TOC.? I
> can see no open bug for this, so have not linked it to the bug report.
> 
Does that address http://bugs.exim.org/show_bug.cgi?id=1257 ?