Bug #54693 [Asn->Csd]: Some example pages are inaccessible
| From: | rquadling@php.net | Date: | Mon, 09 May 2011 14:13:57 +0000 |
| Subject: | Bug #54693 [Asn->Csd]: Some example pages are inaccessible | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-6375@lists.php.net to get a copy of this message | ||
Edit report at http://bugs.php.net/bug.php?id=54693&edit=1
ID: 54693
Updated by: rquadling@php.net
Reported by: RQuadling at GMail dot com
Summary: Some example pages are inaccessible
-Status: Assigned
+Status: Closed
Type: Bug
Package: Doc Build problem
Operating System: n/a
PHP Version: Irrelevant
Assigned To: rquadling
Block user comment: N
Private report: N
Previous Comments:
------------------------------------------------------------------------
[2011-05-09 16:13:33] rquadling@php.net
Automatic comment from SVN on behalf of rquadling
Revision: http://svn.php.net/viewvc/?view=revision&revision=310851
Log: Provide title to example sections which are currently missing their
title and are not accessible via links. Fix #54693
------------------------------------------------------------------------
[2011-05-09 15:11:53] RQuadling at GMail dot com
I don't know if this is a new thing or not. There are user notes against
these
inaccessible pages, so, that suggest that they were accessible at one
time.
I'm not sure what the best solution here is. Many of the TOCs on the
parent
pages are only a 1 liner TOC entry to the example-basic.html sort of
page.
Though for consistency sake, maybe it is easier to keep all examples in
2 layers
(toc + actual examples). I've seen 1 page where there is more than 1 toc
entry
and many without a TOC.
As there is already a separate page, adding the <title> is the fast fix
and
preserves the user notes.
------------------------------------------------------------------------
[2011-05-09 14:52:46] salathe@php.net
Hmm, I should have checked elsewhere when r310790 was committed. Was
there some
PhD change causing this, or have those always been missing in the
rendered manual?
------------------------------------------------------------------------
[2011-05-09 14:45:12] rquadling@php.net
Seems to be a missing <title> tag for the <section>.
------------------------------------------------------------------------
[2011-05-09 14:17:42] RQuadling at GMail dot com
Description:
------------
Inaccessible example pages.
No title for curl.examples-basic.html
No title for ftp.examples-basic.html
No title for gearman.examples-reverse.html
No title for gearman.examples-reverse-bg.html
No title for gearman.examples-reverse-task.html
No title for image.examples.merged-watermark.html
No title for image.examples-png.html
No title for image.examples-watermark.html
No title for ingres.examples-basic.html
No title for java.examples-basic.html
No title for kadm5.examples-connect.html
No title for ldap.examples-basic.html
No title for maxdb.examples-basic.html
No title for memcache.examples-overview.html
No title for memtrack.examples.basic.html
No title for msql.examples-basic.html
No title for overload.examples.basic.html
No title for ovrimos.examples-basic.html
No title for pcntl.example.html
No title for pgsql.examples-basic.html
No title for session.examples.basic.html
No title for shmop.examples-basic.html
No title for w32api.examples-uptime.html
No title for wddx.examples-serialize.html
No title for win32ps.examples-process.html
No title for xsl.examples-collection.html
So, looking at http://www.php.net/manual/en/curl.examples.php?beta=0,
you can see the place holder for the link, but there is no link to
http://www.php.net/manual/en/curl.examples-basic.php?beta=0
This may not be an exhaustive list as the tool that found them was the
old xCHM build routine which I'm just hacking around with.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/bug.php?id=54693&edit=1