sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-17 01:18:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Change <filename> to <command> for ext_skel (more appropriate)

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@259906 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Gwynne Raskind 2008-05-18 10:54:32 +00:00
parent 72c4bc638d
commit fd8e60ae7e
1 changed files with 6 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
internals2/buildsys/skeleton.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<sect1 xml:id="internals2.buildsys.skeleton" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>The ext_skel script</title>
<para>
@ -7,11 +7,11 @@
the details of many of those files are similar from extension to extension,
it can be laborous to duplicate the content for each one. Fortunately, there
is a script which can do all of the initial setup for you. It's called
<filename>ext_skel</filename>, and it's been distributed with PHP since 4.0.
<command>ext_skel</command>, and it's been distributed with PHP since 4.0.
</para>
<para>
Running <filename>ext_skel</filename> with no parameters produces this
Running <command>ext_skel</command> with no parameters produces this
output in PHP 5.2.2:
<screen>
<![CDATA[
@ -34,13 +34,13 @@ php-5.2.2/ext$ ./ext_skel
<literal>--no-help</literal>. Unless you are already experienced with the
structure of an extension, you will <emphasis>not</emphasis> want to use
<literal>--no-help</literal>; specifying it causes
<filename>ext_skel</filename> to leave out many helpful comments in the
<command>ext_skel</command> to leave out many helpful comments in the
files it generates.
</para>
<para>
This leaves you with <literal>--extname</literal>, which tells
<filename>ext_skel</filename> what the name of your extension is. This
<command>ext_skel</command> what the name of your extension is. This
"name" is an all-lowercase identifier containing only letters and
underscores which is unique among everything in the
<filename>ext/</filename> folder of your PHP distribution.
@ -52,7 +52,7 @@ php-5.2.2/ext$ ./ext_skel
ostensibly for the purpose of developing an extension based on a library,
but it often functions poorly with most modern header files. A test run on
the <filename>zlib.h</filename> header resulted in a very large number of
empty and nonsense prototypes in the <filename>ext_skel</filename> output
empty and nonsense prototypes in the <command>ext_skel</command> output
files. The <literal>--xml</literal> and <literal>--full-xml</literal>
options are entirely nonfunctional thus far. The <literal>--skel</literal>
option can be used to specify a modified set of skeleton files to work from,