|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Bug #80946 Doc build instructions incomplete
Submitted: 2021-04-09 16:03 UTC Modified: 2021-04-12 12:19 UTC
From: php-bugs at allenjb dot me dot uk Assigned:
Status: Verified Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
Have you experienced this issue?
Rate the importance of this bug to you:

 [2021-04-09 16:03 UTC] php-bugs at allenjb dot me dot uk
The same or very similar instructions appear in 3 places I found: (

This is the actual sequence of commands I ended up running:
mkdir phpdoc
cd phpdoc
git clone
git clone
git clone
php phd/render.php --help
php doc-base/configure.php
cd doc-en
php ../doc-base/configure.php

Both times I ran doc-base/configure.php resulted in a "No language directory found" error.

After scanning configure.php to see what it was looking for, to fix the issue I created 'en' in the phpdoc directory, then ran doc-base/configure.php from there.

The instructions should be updated with the missing step to create the language directory.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2021-04-09 16:12 UTC]
-Status: Open +Status: Verified -Assigned To: +Assigned To: cmb
 [2021-04-09 16:12 UTC]

    git clone

should actually be

    git clone en

After ./configure there should be a file doc-base/.manual.xml
(~40MB) which is the full PHP manual in DocBook format.  This file
can then be fed to PhD for rendering.
 [2021-04-12 12:19 UTC]
-Package: Doc Build problem +Package: Documentation problem -Assigned To: cmb +Assigned To:
 [2021-04-12 12:19 UTC]
I've just fixed the description in doc-base\[1].  Not
sure what to do with the other places; probably a good idea to
unify and link to a canonical source.

[1] <>
 [2021-04-17 10:08 UTC] php-bugs at allenjb dot me dot uk
Not sure if this should maybe be a separate issue, but I just found via a google search, which refers to installing phd from the (as far as I can tell) no longer present svn repo
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Jul 25 11:01:30 2024 UTC