-
Notifications
You must be signed in to change notification settings - Fork 58
/
xdiff-file-diff.xml
150 lines (142 loc) · 4.51 KB
/
xdiff-file-diff.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: takagi Status: ready -->
<!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
<refentry xml:id="function.xdiff-file-diff" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>xdiff_file_diff</refname>
<refpurpose>2 つのファイルの unified diff を作成する</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>xdiff_file_diff</methodname>
<methodparam><type>string</type><parameter>old_file</parameter></methodparam>
<methodparam><type>string</type><parameter>new_file</parameter></methodparam>
<methodparam><type>string</type><parameter>dest</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>context</parameter><initializer>3</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>minimal</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<parameter>old_file</parameter> と
<parameter>new_file</parameter> の差分を含む unified diff を作成し、ファイル
<parameter>dest</parameter> に保存します。結果は可読形式のファイルとなります。
オプションのパラメータ <parameter>context</parameter> で、
変更部分の前後にどれだけの行を含めるかを指定します。
パラメータ <parameter>minimal</parameter> を true にすると、
できる限り短い長さのパッチファイルを出力します (長い時間がかかります)。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>old_file</parameter></term>
<listitem>
<para>
最初のファイルへのパス。"旧" ファイルです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>new_file</parameter></term>
<listitem>
<para>
2 番目のファイルへのパス。"新" ファイルです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dest</parameter></term>
<listitem>
<para>
結果のパッチファイルへのパス。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<para>
diff の結果の前後に含める行の数を指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>minimal</parameter></term>
<listitem>
<para>
このパラメータを &true; にすると、結果のファイルが最小になります
(長い時間がかかります)。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>xdiff_file_diff</function> の例</title>
<para>
以下のコードは 2 つの php ファイルの unified diff を context length 2 で作成します。
</para>
<programlisting role="php">
<![CDATA[
<?php
$old_version = 'my_script.php';
$new_version = 'my_new_script.php';
xdiff_file_diff($old_version, $new_version, 'my_script.diff', 2);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
この関数はバイナリファイルに対しては動作しません。バイナリファイルの
差分を作成するには <function>xdiff_file_bdiff</function>/<function>xdiff_file_rabdiff</function>
関数を使用してください。
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>xdiff_file_patch</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->