cvs: functable /lib about.php
| From: | Hartmut Holzgraefe | Date: | Tue, 28 May 2002 11:31:33 +0000 |
| Subject: | cvs: functable /lib about.php | ||
| Groups: | php.cvs | ||
| Request: | Send a blank email to php-cvs+get-12132@lists.php.net to get a copy of this message | ||
hholzgra Tue May 28 07:31:33 2002 EDT
Added files:
/functable/lib about.php
Log:
initial checkin
Index: functable/lib/about.php
+++ functable/lib/about.php
<?php
echo "about\n";
head(false,false,"","About this Functiontable");
?>
<hr>
This is a reference table that shows for each function (and alias)
<ul>
<li>in which version it is available</li>
<li>where its definition currently lives in the source</li>
<li>if it is documented</li>
<li>translation status for the supported documentation languages</li>
</ul>
<p>
The Information is gathered into a mysql database
from checkouts of all tagged CVS release versions from the past
plus the latest CVS version
by modified versions of the funclist and quickref tools from phpdoc.
</p>
<p>
I created this overview after finding more than one function that
had been introduced into PHP 3 and documented after the code split
but not brought into the PHP 4 repository yet.
</p>
<p>
The pages are available as a tarball (<a
href=php-reftab.tar.gz>php-reftab.tar.gz</a>)
for offline reading (~430KB packed, ~13MB(!) unpacked).
</p>
Note:
<ul>
<li>
Translation status is checked by comparing the <refpurpose>
entries against the english version. This may lead to
wrong results if the english version changed without
the not-yet-translated file being updated.
<br>
Take this field as a hint only!
</li>
<li>
Alias information is taken from php 4 source only, in php 3 source
there is no difference between function and alias entries in the
function tables.
</li>
</ul>
ToDo:
<ul>
<li>
create a style with
reduced markup for faster table rendering
</li>
<li>
statistics need further improvements,
for example protection against multiple
entries
</li>
<li>
protection against broken links when
documentation sites are not up-to-date
with latest phpdoc cvs (prepared but didn't work)
</li>
<li>
implementation links for php 3
</li>
<li>
switch to some sort of XML output
</li>
</ul>
What's new:
<ul>
<li> 23.11.2000
<ul>
<li> will no longer report object member functions as aliases
</ul>
<p>
<li> 11.10.2000
<ul>
<li> the source to generate theese pages is now available
on <a href="http://cvs.php.net">cvs.php.net</a>
as module <a href="http://cvs.php.net/viewcvs.cgi/functable/">functable</a>
<li> i slightly reformated the function detail page and added line number
information to the XML source links
</ul>
<p>
<li> 22.8.2000
<ul>
<li> improved output for HTML compatibility
<li> language identifiers may now have more than two characters
<p></ul>
<p>
<li> 14.8.2000
<ul>
<li> statistics imporovements
<li> seperate tables for php 3 and 4
<li> auto-detects new languages
<li> internal generation speedups and styleability
</ul>
<p>
<li> 13.6.2000
<ul>
<li> no more dead links?
<li> links to german manual pages updated
<li> links to xml documentation source files added in function details
</ul>
<p>
<li> 6.6.2000
<ul>
<li> <a href="notpub.<?php echo $ext ?>">function implemented
in PHP 4 but not made available</a>
</ul>
<p>
<li> 22.5.2000
<ul>
<li> updated to include php 4.0.0 release
<li> see also: <a href="http://www.zugeschaut-und-mitgebaut.de/php/a2ps">a2ps
stylesheet for pretty-printed php code</a>
</ul>
<p>
<li> 19.5.2000 (#2)
<ul>
<li> functions grouped by extension extension
<li> minor markup changes for better print output
</ul>
<p>
<li> 19.5.2000
<ul>
<li> prototype-column for php 3
<li> filename columns removed from the table
<li> reference links to bonsai.php.net include line numbers
<li> for php 4 there are now links to function table entry _and_ implementation
</ul>
<p>
<li> 17.5.2000
<ul>
<li> prototype-column (latest php 4 only)
<li> what's missing pages under statistics
<ul>
<li> <a href="noproto.<?php echo $ext ?>">functions
without a prototype</a> in the PHP 4 source (PHP 3 proto is shown if available)
<li> <a href="nodoku.<?php echo $ext ?>">undocumented
functions</a> overview
<li> <a href="nodoku_alias.<?php echo $ext
?>">undocumented aliases</a> overview
<li> functions available <a href="notin4.<?php echo $ext ?>">in
PHP 3 but not in PHP 4</a>
</ul>
</ul>
</ul>
<hr>
<? foot("$outdir/about.$ext"); ?>