php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #66316 HTML is malformed
Submitted: 2013-12-18 12:04 UTC Modified: 2014-01-01 19:29 UTC
From: ivan dot enderlin at hoa-project dot net Assigned: salathe (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: ivan dot enderlin at hoa-project dot net
New email:
PHP Version: OS:

 

 [2013-12-18 12:04 UTC] ivan dot enderlin at hoa-project dot net 
Description:
------------
The HTML markup is not well-formed. For example, on the page http://http://php.net/reserved.constants#constant.php-version-id, in the list of constants, we open a `dt`, we open a `dd`, we close a `dd`, and we close the `dt`. The `dt` closing tags are not in the right place, they should be place before the `dd` opening tag.

Expected result:
----------------
  <dt id="constant.php-version-id">
   <span class="term">
    <strong><code>PHP_VERSION_ID</code></strong>
    (<a href="language.types.integer.php" class="link">entier</a>)
   </span>
  </dt>

  <dd>
   <span class="simpara">
    La version courante de PHP sous la forme d&#039;un
    entier, utile pour la comparaison de versions
    (i.e., int(50207) depuis la version &quot;5.2.7-extra&quot;).
    Disponible depuis PHP 5.2.7.
   </span>
  </dd>

Actual result:
--------------
  <dt id="constant.php-version-id">
   <span class="term">
    <strong><code>PHP_VERSION_ID</code></strong>
    (<a href="language.types.integer.php" class="link">entier</a>)
   </span>
   <dd>

    <span class="simpara">
     La version courante de PHP sous la forme d&#039;un
     entier, utile pour la comparaison de versions
     (i.e., int(50207) depuis la version &quot;5.2.7-extra&quot;).
     Disponible depuis PHP 5.2.7.
    </span>
   </dd>

  </dt>

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2013-12-29 12:03 UTC] salathe@php.net
-Summary: HTML is malformed (dt, dd, +Summary: HTML is malformed -Package: Documentation problem +Package: Doc Build problem
 [2013-12-29 12:03 UTC] salathe@php.net 
The cited example (dd within dt) should be a small, simple fix in phd.

However, there is a wider problem of "malformed" HTML markup being generated; for example we wrap many, many block-level elements in <p> tags because we use lots of <para> in DocBook.  An example of this is surrounding the <dl> cited in the bug report.
 [2014-01-01 19:15 UTC] bjori@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: salathe
 [2014-01-01 19:15 UTC] bjori@php.net 
The fix for this bug has been committed. Since the websites are not directly
updated from the repository, the fix might need some time to spread
across the globe to all mirror sites, including PHP.net itself.

Thank you for the report, and for helping us make PHP.net better.
 [2014-01-01 19:29 UTC] bjori@php.net 
Fixing <p> wrapping other block level tags would have to be a structural change to PhD. Not something that is going to happen any time soon considering development of PhD has been very minimal in the past 18 months :)
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Thu Nov 21 15:01:30 2024 UTC