php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Bug #54693 Some example pages are inaccessible
Submitted: 2011-05-09 14:17 UTC Modified: 2011-05-09 16:13 UTC
From: RQuadling at GMail dot com Assigned: rquadling (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: n/a
Private report: No CVE-ID: None
 [2011-05-09 14:17 UTC] 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.




Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2011-05-09 14:45 UTC] rquadling@php.net
-Assigned To: +Assigned To: rquadling
 [2011-05-09 14:45 UTC] rquadling@php.net
Seems to be a missing <title> tag for the <section>.
 [2011-05-09 14:52 UTC] 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 15:11 UTC] 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 16:13 UTC] rquadling@php.net
Automatic comment from SVN on behalf of rquadling
Revision: http://svn.php.net/viewvc/?view=revision&amp;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 16:13 UTC] rquadling@php.net
-Status: Assigned +Status: Closed
 [2020-02-07 06:08 UTC] phpdocbot@php.net
Automatic comment on behalf of rquadling
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=79dcbe011fb254dcd92c597064571fe313362a09
Log: Provide title to example sections which are currently missing their title and are not accessible via links. Fix #54693
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Tue Apr 23 19:01:31 2024 UTC