誤字・文法の修正などを原文の変更に追従 (53ファイル)

appendices/migration71/windows-support.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3cd337b4dc91c827399961b9b45524ae4f2b50c9 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: f4fe9d5bb597e4f3dc205e8052b1c005700ea9fc Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="migration71.windows-support" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Windows のサポート</title>
@@ -109,23 +109,23 @@
   <para>
     ストリームで UTF-8 がサポートされたことによって、
     PHP スクリプトは ASCII や ANSI のファイル名にもはや縛られなくなりました。
-    これは CLI の枠を越えたサポートです。他の SAPI については、
+    CLI では、追加の設定なしでそのまま利用できます。他の SAPI については、
     対応するサーバーのドキュメントを見ると有益でしょう。
   </para>
   <para>
     長いパス名のサポートは透過的です。
     260バイトより長いパス名には、
     自動的に <literal>\\?\</literal> という prefix が付きます。
     パス名の最大の長さは、2048バイトに制限されています。
-    パスセグメントの長さの制限 (basepath の長さ) はまだ続いていることも知っておいてください。
+    パスセグメントの長さの制限 (basename の長さ) はまだ続いていることも知っておいてください。
   </para>
-  <para>
+  <simpara>
     移植性を最大にするために、ファイル名や I/O 、
     そして他の関連するトピックを UTF-8 で扱うことを強くお勧めします。
     それに加えて、コンソールアプリケーションについては、
     TrueType フォントを使うことが好ましいです。
     また、コードページの変更に ini_set() を使うことは推奨されません。
-  </para>
+  </simpara>
   <para>
   </para>
   <para>

chapters/intro.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0bae88c19601e7f67ae6a22a8f9aa44cb9342cc1 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,takagi -->
  <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <info>
@@ -127,33 +127,33 @@
     さらには手続き型プログラミングかオブジェクト指向プログラミングか、
     もしくはそれらを混在させるかといった選択を行うこともできます。
    </para>
-   <para>
+   <simpara>
     PHP は HTML を出力するだけではありません。PHP はリッチなファイルタイプ、
     たとえば 画像やPDFファイルを出力する機能を備えていますし、
     データを暗号化したり、メールを送信することもできます。
     また、JSON や XML のような任意のテキストも簡単に出力できます。
     これらのファイルを自動生成したり、
-    印刷する代わりにファイルシステムに保存したり、
+    出力する代わりにファイルシステムに保存したり、
     動的なコンテンツのためにサーバー側でキャッシュすることも出来ます。
-   </para>
-   <para>
+   </simpara>
+   <simpara>
     PHP の機能の中で最も強力で優れているのは、
     <link linkend="refs.database">広範なデータベースをサポートしている</link>
     ことでしょう。データベース機能を用いたWebページの作成は非常に簡単です。
-    データベースごとに用意された拡張モジュール (e.g., for <link linkend="book.mysqli">mysql</link>)
+    データベースごとに用意された拡張モジュール (e.g., for <link linkend="book.mysqli">MySQL</link>)
     を使うこともできれば <link linkend="book.pdo">PDO</link> のような抽象化レイヤーを使うこともでき、
     ODBC に対応しているデータベースなら <link linkend="book.uodbc">ODBC</link>
     拡張モジュールを使って接続することもできます。その他には、
     <link linkend="book.curl">cURL</link> あるいは <link linkend="book.sockets">ソケット</link>
     を使う CouchDB のような例もあります。
-   </para>
+   </simpara>
    <simpara>
     PHP は、LDAP、IMAP、SNMP、NNTP、POP3、HTTP、COM (Windowsのみ) やその他
     数え切れない程多くのプロトコルを用いて他のサービスと通信を行う
     機能もサポートしています。低レベルのネットワークソケットをオープンし、
     他のプロトコルを用いて通信を行うことも可能です。
    </simpara>
-   <para>
+   <simpara>
     PHP には便利な <link linkend="refs.basic.text">テキスト処理</link> 機能が用意されています。
     Perl 互換の正規表現 (<link linkend="book.pcre">PCRE</link>) や、
     <link linkend="refs.xml">XML 文書のパースや XML 文書へのアクセス</link>
@@ -162,7 +162,7 @@
     <link linkend="book.simplexml">SimpleXML</link> や
     <link linkend="book.xmlreader">XMLReader</link>、そして <link linkend="book.xmlwriter">XMLWriter</link>
     がサポートされています。
-   </para>
+   </simpara>
    <para>
     他にも興味深い拡張モジュールがあり、
     <link linkend="extensions">アルファベット順</link> および <link linkend="funcref">カテゴリ別</link>

chapters/tutorial.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1340d3595bde8489ea1385868ffd75471a56999b Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
  <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>簡易チュートリアル</title>
@@ -110,63 +110,63 @@ php -S localhost:8000
     通常の HTML ファイルと考えることができます。
    </para>
 
-   <para>
+   <simpara>
     この例の目的は、特殊な PHP タグ形式を示すことです。
     この例では、<literal>&lt;?php</literal> が PHP
     タグの開始を示しています。この後、PHP 命令を置き、終了タグ <literal>?&gt;</literal>
     を記述することにより、PHP モードを抜けています。
     このように任意の場所で PHP モードを抜けて HTML
     ファイルに移ることができます。詳細は、<link linkend="language.basic-syntax">
     基本的な構文</link>のセクションを参照ください。
-   </para>
+   </simpara>
 
    <note>
     <title>改行に関する注意</title>
-    <para>
+    <simpara>
      HTML においては改行にはほとんど意味がありません。ただ、
      HTML の見栄えをよくするためにも適宜改行を入れておくとよいでしょう。
      <literal>?&gt;</literal> の直後の改行は、PHP によって取り除かれます。
      複数の PHP ブロックを使用している場合や、
-     何かを出力するのかどうかがわからないファイルを include する際などに、
+     何も出力しないはずの PHP のファイルを include する際などに、
      この挙動は非常に便利です。と同時に少々混乱するかもしれません。
-     強制的に改行させるには、<literal>?&gt;</literal> の後に空白を置くか、
+     空白と改行を強制的に出力させるには、<literal>?&gt;</literal> の後に空白を置くか、
      あるいは PHP ブロック内の最後の echo/print で明示的に改行を出力します。
-    </para> 
+    </simpara> 
    </note> 
 
    <note>
     <title>テキストエディタに関する注意</title>
-    <para>
+    <simpara>
      PHP ファイルを作成、編集、管理する際に使用できる、
      多くのテキストエディタや統合開発環境 (IDE) があります。
      これらのツールのリストの一部は、<link
      xlink:href="&url.phpeditorlist;">PHP エディタのリスト</link>
      で整理されています。あるエディタを推薦したい場合、上記のページを訪れ、
      ページの管理者にそのエディタをリストに加えてくれないかとたずねてみてください。
      シンタックスハイライト機能を備えたエディタを使うと便利でしょう。
-    </para>
+    </simpara>
    </note>
 
    <note>
     <title>ワードプロセッサに関する注意</title>
-    <para>
-     StarOffice Writer, Microsoft Word および Abiword
+    <simpara>
+     StarOffice Writer, Microsoft Word および AbiWord
      のようなワードプロセッサは、PHP ファイルの編集には向いていません。
      これらのワープロ上でテストスクリプトを編集する場合は、
      ファイルを<emphasis>プレーンテキスト</emphasis>として保存していることを確認してください。
      さもないと、PHP はスクリプトを読み込んで実行できません。
-    </para>
+    </simpara>
    </note>
 
-   <para>
+   <simpara>
     さて、動作する簡単な PHP スクリプトを作成することができましたので、
     最も有名な PHP スクリプトを作成してみましょう!
     <function>phpinfo</function> 関数をコールすることにより、
     <link linkend="language.variables.predefined">定義済み変数</link>、
     ロードされている PHP モジュール、<link linkend="configuration">設定
     </link>等のシステムに関する多くの有用な情報を得ることができます。
     この重要な情報を見てみてください。
-   </para>
+   </simpara>
 
    <para>
     <example>
@@ -230,12 +230,12 @@ Mozilla/5.0 (Linux) Firefox/112.0
     </para>
    </example>
    </para>
-   <para>
+   <simpara>
     PHP で利用可能な変数の<link linkend="language.types">型</link>
     には多くの種類があります。上の例では、
     <link linkend="language.types.array">配列</link>
     の要素を出力しています。配列は、非常に有用です。
-   </para>
+   </simpara>
    <para>
     <varname>$_SERVER</varname> は、PHP
     で自動的に利用可能な変数のひとつに過ぎません。マニュアルの
@@ -285,7 +285,7 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
     PHP の入門書を手にとって最初の数章を読むか、このマニュアルの
     <link linkend="langref">言語リファレンス</link>の部分を読むべきです。
    </para>
-   <para>
+   <simpara>
     二番目の新しい概念は、<function>str_contains</function> 関数のコールです。
     <function>str_contains</function> は PHP に組み込まれた関数で、
     指定された文字列が、別の文字列に含まれているかを判定します。この場合、
@@ -308,7 +308,7 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
     <link linkend="about.prototypes">関数定義の読み方</link>および
     <link linkend="language.functions">PHP関数</link>のセクションの両方を
     読んでみると良いでしょう。
-   </para>
+   </simpara>
    <para>
     この例を少し発展させて、PHP ブロックの中からでも PHP
     モードから出たり入ったりすることができることを以下に示します。
@@ -344,27 +344,27 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
      </para>
     </example>
    </para>
-   <para>
+   <simpara>
     何かを出力する際に PHP の echo 文を使用する代わりに、PHP
     モードを抜けて通常の HTML を送信しています。ここで注意すべき重要で強力な点は、
     スクリプトの論理フローが損なわれないということです。
     <function>str_contains</function> が &true; または &false;
     のどちらを返すか、言い換えると<literal>Firefox</literal>
     が見つかったかどうかに基づき、HTML
     ブロックだけが見る側に送信されることになります。
-   </para>
+   </simpara>
   </sect1>
 
   <sect1 xml:id="tutorial.forms">
    <title>フォームの処理</title>
-   <para>
+   <simpara>
     PHP の最も強力な機能の一つは、HTML フォームを処理する手段です。
     理解するべき重要な基本概念は、あるフォームの中の全てのフォーム要素が、
     自動的に PHP スクリプトで利用可能になるということです。
     詳細は、マニュアルのセクション<link linkend="language.variables.external">
     外部から来る変数</link> および PHP
     でフォームを使用する例を参照ください。以下に HTML フォームの例を示します。
-   </para>
+   </simpara>
    <para>
     <example>
      <title>簡単な HTML フォーム</title>
@@ -409,10 +409,10 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
      </para>
     </example>
    </para>
-   <para>
+   <simpara>
     <function>htmlspecialchars</function> および
     <literal>(int)</literal> の部分以外は、何を行っているかは明らかでしょう。
-    <function>htmlspecialchars</function> は、html での特殊な文字を適切にエンコードし、
+    <function>htmlspecialchars</function> は、HTML での特殊な文字を適切にエンコードし、
     HTML タグや JavaScript をページ内に仕込めないようにします。
     また、age フィールドには数値が入ることがわかっているので、これを
     <type>int</type> 型に <link linkend="language.types.typecasting">変換</link> 
@@ -430,9 +430,9 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
     に代入されます。リクエストデータの発信源に留意しない場合には、
     スーパーグローバル変数
     <varname>$_REQUEST</varname>
-    を使用することもできます。この変数は、GET, POST, COOKIE, FILE
+    を使用することもできます。この変数は、GET, POST, COOKIE
     データの混ざったものが含まれます。
-   </para>
+   </simpara>
   </sect1>
 
   <sect1 xml:id="tutorial.whatsnext">

chmonly/aboutchm.xml

@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 4d624ced045b1f0012d9010351e250e8b2bbb755 Maintainer: mumumu Status: ready -->
  <chapter xml:id="chm.about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>このヘルプについて</title>
 
-  <para>
-   PHPマニュアル の Windowsヘルプ版 は、このマニュアルをいつも手元に置いておきたかったり、Webページをダウンロードするのを待つことなくマニュアルページやユーザーが書き込んだ Note を読みたい開発者を対象にしています。Windowsヘルプ版 は、PHPマニュアルの全ての内容と、ユーザーが書き込んだ Note が全て含まれていますし、このフォーマットを生成するスクリプトや他のコントリビューターがスキンの形で提供したビューアアプリケーションの素晴らしい機能がいくつか付いてきます。 
-  </para>
+  <simpara>
+   PHPマニュアル の Windowsヘルプ版 は、このマニュアルをいつも手元に置いておきたかったり、Webページをダウンロードするのを待つことなくマニュアルページやユーザーが書き込んだ Note を読みたい開発者を対象にしています。Windowsヘルプ版 は、PHPマニュアルの全ての内容と、ユーザーが書き込んだ Note が全て含まれています。また、ビューアアプリケーション、このフォーマットの生成に使っているスクリプト、そして他のコントリビューターによるスキンが、素晴らしい機能をいくつか提供しています。 
+  </simpara>
 
-  <para>
+  <simpara>
    PHPマニュアル の配布物に多くのファイルが含まれており、それらはメインマニュアルファイルである <filename>php_manual_ja.chm</filename> に入っています。(既にお察しの通り) あなたは PHPマニュアル をこのファイルをダブルクリックすることで見ることが出来ます。
    <!--
    The user notes are in <filename>php_manual_notes.chm</filename>. You
@@ -18,7 +18,7 @@
    files in one directory with <filename>php_manual_notes.chm</filename>.
    -->
    同じフォルダで <filename>php_manual_ja.chw</filename> というファイルを見ることがあるかもしれません。これは「キーワード」タブをはじめて使うときに生成され、マニュアルページのインデックスが含まれています。
-  </para>
+  </simpara>
 
   <para>
    Microsoft HTMLヘルプ の技術的な詳細に興味がある方向けの素晴らしいリソースに、<link xlink:href="&url.chm.helpware;">&url.chm.helpware;</link> があります。Microsoft ヘルプフォーマットやサービスの歴史における Windows HTMLヘルプの位置付けや、さらに詳しい情報は <link xlink:href="&url.chm.history;">WinWriters の記事 </link> を参照ください。