You are on page 1of 4

�w�b�_�R�����g�u���b�N

PEAR ���|�W�g��� ‫�܂܂‬邷�ׂẴ\�[�X�R�[�h�ɂ́A �e�t�@�C���̐擪�� "�y�[�W���x��"

�̃R�����g�u���b�N��A �e�N���X�̒��O�� "�N���X���x��" �̃R�����g�u���b�N��L�q���‫��܂‬B

�ȉ��ɂ����̗� �� ‫��܂‬B

<?php

/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */

/**
* Short description for file
*
* Long description for file (if any)...
*
* PHP versions 4 and 5
*
* LICENSE: This source file is subject to version 3.0 of the PHP license
* that is available through the world-wide-web at the following URI:
* http://www.php.net/license/3_0.txt. If you did not receive a copy of
* the PHP License and are unable to obtain it through the web, please
* send a note to license@php.net so we can mail you a copy immediately.
*
* @category CategoryName
* @package PackageName
* @author Original Author <author@example.com>
* @author Another Author <another@example.com>
* @copyright 1997-2005 The PHP Group
* @license http://www.php.net/license/3_0.txt PHP License 3.0
* @version CVS: $Id:$
* @link http://pear.php.net/package/PackageName
* @see NetOther, Net_Sample::Net_Sample()
* @since File available since Release 1.2.0
* @deprecated File deprecated in Release 2.0.0
*/

/*
* Place includes, constant defines and $_GLOBAL settings here.
* Make sure they have appropriate docblocks to avoid phpDocumentor
* construing they are documented by the page-level docblock.
*/

/**
* Short description for class
*
* Long description for class (if any)...
*
* @category CategoryName
* @package PackageName
* @author Original Author <author@example.com>
* @author Another Author <another@example.com>
* @copyright 1997-2005 The PHP Group
* @license http://www.php.net/license/3_0.txt PHP License 3.0
* @version Release: @package_version@
* @link http://pear.php.net/package/PackageName
* @see NetOther, Net_Sample::Net_Sample()
* @since Class available since Release 1.2.0
* @deprecated Class deprecated in Release 2.0.0
*/
class foo
{
}

?>

��e��ύX����K�v�̂���K�{�^�O

Short Descriptions
�R�����g�u���b�N���ׂĂɁAShort descriptions �i�Z���‫���־‬j��L�q���‫��܂‬B

�v�f�̖��O�ł͂Ȃ��A�Ȍ��ȕ��͂ŋL���‫��܂‬B�ǂ��‫�����̏���־‬ɂ‚��ĂA �T���v���t�@�C��
��Q�Ƃ��Ă��������B

PHP Versions
PHP �̃o�[�W�����ɂ‚��ĂA�y�[�W���x���̃R�����g�u���b�N�� �ȉ��̂�� ��L���‫�܂‬

.
* PHP version 4
* PHP version 5
* PHP versions 4 and 5

@license
PEAR �ŗ��p�ł��郉�C�Z���X� ɂ͉ ���
‫�� �����܂‬B �ȉ��̂��Â

��I� A�y�[�W���x���µ���̓N���X���x���̃R�����g�u���b�N�� �L�q���‫��܂‬B

.
* @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
* @license http://www.freebsd.org/copyright/freebsd-license.html BSD License
(2 Clause)
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @license http://www.freebsd.org/copyright/license.html BSD License (4
Clause)
* @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1
* @license http://www.php.net/license/3_0.txt PHP License 3.0

�ׂ‫ڍ‬ɂ‚��ĂAPEAR �O���[�v�ɂ��A�i�E���X Licensing Announcement


�i�p��j��Q�Ƃ��Ă��������B

@link
�y�[�W���x���A�N���X���x���ǂ���ɂ�g�p�ł��‫��܂‬B �¿���A"PackageName"

�͎����̃p�b�P�[�W���ɒu�������‫��܂‬B ���̃^�O��g�����ƂŁA�������
�h�L�������g�������̃p�b�P�[�W�Ƀ����N���� ���Ƃ��ł���悤�ɂȂ�‫��܂‬B

.
* @link http://pear.php.net/package/PackageName

@author
�\�[�X�t�@�C���̍�҃��X�g�ɁA�R�[�h� ҂̖��O��ljB���ׂ����ǂ��� ���`���閾�m�ȋK���͂���

‫���܂‬B��ʓI� ɂA
́ "������" �����i10%����20%�̃R�[�h�ύX��Ӗ����‫��܂‬j�̕ύX�� �s�B�� �ɁA��҂Ƃ���

悤�ł��B � ���
̃ ���C�g��V���ȃ��W�b�N�̒ ̏ �ɂ́A��O� �肦�‫��܂‬B

�ȒP�ȃR�[�h�̐�����o�O�C���́A��҃��X�g�ɐV���ɐl��ljB��� �‫܂‬ł̗��R� ɂ͂ Ȃ�
‫���܂‬B

@since
�t�@�C����N���X���A�p�b�P�[�W�̏������[�X�̌�ʼnB��� � �A ���̃^�O��g�p���‫��܂‬B�������[�X�

‫��ۂ‬Ă͎g�p���‫���܂‬B

@deprecated
�t�@�C����N���X���A��͂�g���Ȃ��ȂBĂ��邪�A �����
݊ ̂�� c����Ă��� �ɂ��̃^�O��g�p���‫��܂‬B

�C�Ӄ^�O

@copyright
�R�s�[���C�g�͎��R�ɋL�q���Ă��������B �`���Ƃ��ĂA�N� ���
� 4 �� ŁA�����N�ɂ킽�� ��

�n�C�t����p���Ďn�‫�܂‬N
̔ �ƏI���̔N�싂 т‫��܂‬B ���쌠�҂́A�l�łա���l�ł��Ж��ł� PHP Group ���ł©�

‫���܂��܂‬B �� ��‫��܂‬B

.
* @copyright 2003 John Doe and Jennifer Buck
* @copyright 2001-2004 John Doe
* @copyright 1997-2004 The PHP Group
* @copyright 2001-2004 XYZ Corporation

���C�Z���X�̊T�v
PHP ���C�Z���X��g�p���� �A
́ ��L�Ɏ������T�v����g�BĂ��������B

���̃��C�Z���X��g�p���� �APHP
́ ���C�Z���X�̊T�v����폜���A �g�p���郉

�C�Z���X�ɑΉ������̂ɒu�������‫��܂‬B �������A�L�q�͊Ȍ��ɂƂǂ A�‫ �܂‬LICENSE: �Ƃ���

�e�L�X�g��O�ɂ‚��‫��܂‬B

@see
���[�U�Ƀp�b�P�[�W�̃h�L�������g�̑��̃Z�N�V������Q�Ƃ��Ă�炤� �� @see �^�O��p���
‫��܂‬B�����̎Q�ƍ��‫�ڂ‬L�q���� �ɂ́A@see �^�O� ������̂ł͂Ȃ��A �R���}�ŋ�‫؂‬BċL�q���

‫��܂‬B�B

�����Ԋu�‫�ق‬

PEAR �̃\�[�X�R�[�h��ǂ݂ �����邽� A

�e�L�X�g��^�O�̏����╶���Ԋu�́A��Ɏ�������ɂ��������K�v������‫��܂‬B ����́AJavaDoc

�W����̗p������̂ɂȂBĂ��‫��܂‬B

@package_version@ �̎g�p�@
@package_version@ �u���́A2�‚̕�@�Ŏs���邱�Ƃ � � ł � � ‫��܂‬B package.xml � ��Ă��邩

�APackageFileManager ��g�BĂ��邩�� �˂�‫��܂‬B

package.xml ��쐬����ɂ����BāA<replace> �v�f�� �e�t�@�C���ɑ ��ĒljB��

‫��܂‬B�ȉ��̂悤�� XML �ƂȂ�‫��܂‬B

<file name="Class.php">
<replace from="@package_version@" to="version" type="package-info" />
</file>

�����e�i�� PackageFileManager ��g�B��� �A


́ �e�t�@�C���ɑ ���

addReplacement() �� �R�[������悤�ɂ��‫��܂‬B

$pkg->addReplacement('filename.php', 'package-info',
'@package_version@', 'version');

�‫ڍ‬s�|���V�[

��̏��K�͂ȃp�b�P�[�W
���‚t
̃ �@�C������Ȃ��̃p�b�P�[�W�́A ���̃����[�X�‫܂‬łɏ�L�� docblocks �ɑΉ�����B

��̑�K�͂ȃp�b�P�[�W
�����̃t�@�C������\��������̃p�b�P�[�W�́A �ł��邾��������L�̐V�w�b�_�ɑΉ����邱�Ƃ � � ] � ‫��܂‬B

���W���[�o�[�W������グ��悤�ȍX�V�ⷂ� �ɂ́A ��L�� docblocks �ɕK���Ή�����B

�������[�X�̃p�b�P�[�W
�V�����p�b�P�[�W��A��ł �����[�X�̃p�b�P�[�W�́A �������[�X�‫܂‬łɏ�L�� docblocks
�ɑΉ�����B