php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #25913 Update for global entities and PHP history (patch included)
Submitted: 2003-10-19 17:10 UTC Modified: 2003-10-20 04:42 UTC
From: mj@php.net Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
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: mj@php.net
New email:
PHP Version: OS:

 

 [2003-10-19 17:10 UTC] mj@php.net
Description:
------------
The following diff changes the global entities that refer to PEAR packages so that they conform to PEAR's new URL scheme. (The old links will work as well, but it's cleaner that way.) Additionally it adds links to PEAR, PHP QA and PHP-GTK in the PHP history. I have phpdoc karma myself, but I'm not sure if the history patch conforms with what you expect.

? en/reference/cybermut/functions.xml
? en/reference/monetra/functions.xml
Index: en/appendices/history.xml
===================================================================
RCS file: /repository/phpdoc/en/appendices/history.xml,v
retrieving revision 1.21
diff -u -r1.21 history.xml
--- en/appendices/history.xml	16 Jul 2003 18:30:49 -0000	1.21
+++ en/appendices/history.xml	19 Oct 2003 21:07:47 -0000
@@ -168,11 +168,11 @@
   <sect2 id="history.pear">
    <title>PEAR</title>
    <para>
-    PEAR, the PHP Extension and Application Repository (originally,
-    PHP Extension and Add-on Repository) is PHP's version of
-    foundation classes, and may grow in the future to be one
-    of the key ways to distribute both PHP and C-based PHP
-    extensions among developers.
+    <ulink url="&url.php.pear;">PEAR</ulink>, the PHP Extension and
+    Application Repository (originally, PHP Extension and Add-on
+    Repository) is PHP's version of foundation classes, and may grow in
+    the future to be one of the key ways to distribute both PHP and
+    C-based PHP extensions among developers.
    </para>
    <para>
     PEAR was born in discussions held in the PHP Developers'
@@ -189,15 +189,19 @@
     for database access, content caching, mathematical
     calculations, eCommerce and much more.
    </para>
+   <para>
+    More information about PEAR can be found in <ulink
+    url="&url.php.pear.manual;">the manual</ulink>.
+   </para>
   </sect2>
 
   <sect2 id="history.phpqa">
    <title>PHP Quality Assurance Initiative</title>
    <para>
-    The PHP Quality Assurance Initiative was set up in the
-    summer of 2000 in response to criticism that PHP releases
-    were not being tested well enough for production
-    environments. The team now consists of a core group of
+    The <ulink url="&url.php.prerelease;">PHP Quality Assurance
+    Initiative</ulink> was set up in the summer of 2000 in response to
+    criticism that PHP releases were not being tested well enough for
+    production environments. The team now consists of a core group of
     developers with a good understanding of the PHP code
     base. These developers spend a lot of their time
     localizing and fixing bugs within PHP. In addition
@@ -210,9 +214,9 @@
   <sect2 id="history.phpgtk">
    <title>PHP-GTK</title>
    <para>
-    PHP-GTK is the PHP solution for writing client side
-    GUI applications. Andrei Zmievski remembers the planing
-    and creation process of PHP-GTK:
+    <ulink url="&url.php.gtk;">PHP-GTK</ulink> is the PHP solution for
+    writing client side GUI applications. Andrei Zmievski remembers the
+    planing and creation process of PHP-GTK:
    </para>
    <blockquote>
     <para>
Index: entities/global.ent
===================================================================
RCS file: /repository/phpdoc/entities/global.ent,v
retrieving revision 1.133
diff -u -r1.133 global.ent
--- entities/global.ent	14 Oct 2003 05:12:44 -0000	1.133
+++ entities/global.ent	19 Oct 2003 21:07:55 -0000
@@ -66,7 +66,7 @@
 <!ENTITY url.echo-print "http://www.faqts.com/knowledge_base/view.phtml/aid/1/fid/40">
 <!ENTITY url.emacs-src "ftp://ftp.gnu.org/pub/gnu/emacs/">
 <!ENTITY url.emacs-nt "http://www.gnu.org/software/emacs/windows/">
-<!ENTITY url.email.mime.pear "http://pear.php.net/Mail_Mime">
+<!ENTITY url.email.mime.pear "http://pear.php.net/package/Mail_Mime">
 <!ENTITY url.email.mime.zend "http://www.zend.com/zend/spotlight/sendmimeemailpart1.php">
 <!ENTITY url.email.book "http://www.oreilly.com/catalog/progintemail/noframes.html">
 <!ENTITY url.example "www.example.com">
@@ -187,7 +187,7 @@
 <!ENTITY url.pdf.phppdflib "http://www.potentialtech.com/ppl.php">
 <!ENTITY url.pdf.ros "http://www.ros.co.nz/pdf/">
 <!ENTITY url.pdflib.merz "http://www.pdflib.com/corporate/tm.html">
-<!ENTITY url.pear.net-dns "http://pear.php.net/Net_DNS">
+<!ENTITY url.pear.net-dns "http://pear.php.net/package/Net_DNS">
 <!ENTITY url.pecl.get.win "http://snaps.php.net/win32/PECL_STABLE/">
 <!ENTITY url.pfpro "http://www.verisign.com/products/payflow/pro/index.html">
 <!ENTITY url.pfpro.download "https://manager.verisign.com/">
@@ -215,6 +215,7 @@
 <!ENTITY url.php.museum "http://museum.php.net/">
 <!ENTITY url.php.news "news://news.php.net/">
 <!ENTITY url.php.newsweb "http://news.php.net/">
+<!ENTITY url.php.pear.manual "http://pear.php.net/manual/">
 <!ENTITY url.php.pear "http://pear.php.net/">
 <!ENTITY url.php.prerelease "http://qa.php.net/">
 <!ENTITY url.php.release1.0.0 "http://groups.google.com/groups?selm=3r7pgp$aa1@ionews.io.org">



Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2003-10-19 17:19 UTC] didou at nexen dot net
Not sure that a bug report is a good place to propose a patch for the documentation (as there's _no_ bug), but I'm +1 with you commit if make test succeed :)

didou
 [2003-10-20 03:24 UTC] goba@php.net
I am also fine with Martin committing the patch :)
 [2003-10-20 04:16 UTC] betz@php.net
me too ;-) 
In addition one suggestion: 
linking to pear packeges could be done by one generic entry: 
<!ENTITY url.pear.package "http://pear.php.net/package"> 
For example:  &url.pear.packe;Net_DNS  
 
Like we already do with rfc's. 
 
Friedhelm 
 [2003-10-20 04:42 UTC] mj@php.net
This bug has been fixed in CVS.

In case this was a PHP problem, snapshots of the sources are packaged
every three hours; this change will be in the next snapshot. You can
grab the snapshot at http://snaps.php.net/.
 
In case this was a documentation problem, the fix will show up soon at
http://www.php.net/manual/.

In case this was a PHP.net website problem, the change will show
up on the PHP.net site and on the mirror sites in short time.
 
Thank you for the report, and for helping us make PHP better.


 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved.
Last updated: Mon Nov 10 19:00:01 2025 UTC