Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Source files and a setup for converting PHP's XML documentation into presentation formats like HTML.
PHP JavaScript HTML CSS C++ Smarty Other
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
RFC Fix double declaration of the docbook namespace
chm - Add norwegian.
docbook/docbook-xml Add XInclude and xpointer to the docbook DTD so we don't have to hide…
entities Change sakila and world db links to docs instead of direct downloads
htmlhelp fixed properties
images Add an explanatory diagram for crypt() and password_hash() output.
phpbook/phpbook-xml Allow empty work-in-progress section.
scripts - debugging message tweaks.
LICENSE 2011 -> 2014
README Update doc-base/README
TODO Update doc-base/TODO
build.chms.bat We need to sync build-chms-config.php here too
configure.php changed leading tabs to 4 spaces for consistency with the rest of the…
contacts.txt Updated SVN contact information for Turkish
developer.template.xml.in We no longer use that entity
funcindex.xml Let PhD generate the function listing (which we always forget to upda…
funclist.txt Whoops, I forgot to update functions list after unexisting extensions…
funcsummary.txt Whoops, I forgot to update functions list after unexisting extensions…
install-unix.xml.in These paths need to be generated
install-win.xml.in These paths need to be generated
manual.xml.in Add errors section.
quickref.txt Whoops, I forgot to update functions list after unexisting extensions…

README

---------------------------------------------------------------------------   
READ THIS FIRST
---------------------------------------------------------------------------   
    This directory contains source files and a setup for converting
    PHP's XML documentation into presentation formats like HTML and
    RTF. You should not have to bother with this unless you are
    writing documentation yourself, or if you simply are curious
    about how the XML stuff works.

    If you just want to read the documentation, look at:
        http://www.php.net/docs.php

---------------------------------------------------------------------------   
HOW TO WRITE PHPDOC FILES
---------------------------------------------------------------------------   
    If you are interested in information about how to
    set up the tools needed, how to work with SVN and
    DocBook on Linux or Windows, or what conventions you
    should follow when writing phpdoc files, please refer
    to the PHP Documentation HOWTO.
     
    You can read the HOWTO online at:
        http://doc.php.net/tutorial/
    
    If you are already working with the phpdoc module,
    then you can find its XML source in the howto directory
    of the module, and build it yourself with:

        phd -d .manual.xml

    However, PhD is a separate project which can be read about here:

        http://wiki.php.net/doc/phd

---------------------------------------------------------------------------
QUICK REFERENCE
---------------------------------------------------------------------------
  [[source checkout]]
  
    a) Check out the source
    
         svn checkout http://svn.php.net/repository/phpdoc/modules/doc-en phpdoc
      
       Change 'doc-en' if you would like to check out a different language. 
       The 'modules' directory contains 'svn externals' references, so the
       above actually checks out:
       
         svn checkout http://svn.php.net/repository/phpdoc/en/trunk phpdoc/en
         svn checkout http://svn.php.net/repository/phpdoc/doc-base/trunk phpdoc/doc-base
         
      Where en/ is contains the DocBook source files, and doc-base/ contains tools
      and resources used in all languages.
  
  [[edits]]
    
    a) Make the change.  Use spaces not tabs.  Be sure to carefully 
       watch your whitespace!

    b) Look at your unified diff, make sure it looks right and that 
       whitespace changes aren't mixed in:
	 
           svn diff path/to/file.xml
	 
    c) Make sure no errors are present, so at the command line in your 
       phpdoc source directory run:

           php doc-base/configure.php
	   
       Always 'php configure.php' before commit!

    d) Commit your changes
      
           svn commit path/to/file.xml
	 
    Read the HOWTO for more information.  After reading the HOWTO,
    email the phpdoc mailing list (phpdoc@lists.php.net) with questions 
    and concerns.

  [[new functions]]
  
    a) Copy an existing xml file or use a skeleton from the HOWTO.
       Rename and place it into the appropriate directory.

    b) Edit.  Be sure no leftover text exists.  No tabs either.

    c) Now test locally before commit by first running
       (php configure.php)
    
    d) svn add path/to/yourfile.xml
    
    e) svn commit path/to/yourfile.xml
  
    Note that the version numbers are taken care of elsewhere (don't worry 
    about them)

   [[some popular tags and entities]]
   
    <filename>          filenames
    <constant>          constants
    <varname>           variables
    <parameter>         a function's parameter/argument
    <function>          functions, this links to function pages or bolds if 
                        already on the function's page.  it also adds ().
    
    <literal>           teletype/mono-space font <tt>
    <emphasis>          italics
    <example>           see HOWTO, includes many other tags.
    <link>              internal manual links
                        <link linkend="language.variables">variables</link>
    
    <link>              external links via global.ent
                        <link xlink:href="&spec.cookies;">mmm cookies</link>                        
    
    <type>              types, this links to the given types manual
                        page: <type>object</type> -> php.net/types.object
    

    &return.success;    see: language-snippets.ent
    &true;              <constant>TRUE</constant>
    &false;             <constant>FALSE</constant>
    &php.ini;           <filename>php.ini</filename>

    Be sure to check out globals.ent and language-snippets.ent for
    more information for entities and urls.

---------------------------------------------------------------------------
Something went wrong with that request. Please try again.