Skip to content

Fix reference to non-existent "example three" - #5724

Merged
jordikroon merged 2 commits into
php:masterfrom
GabrielCordeiroBarrosoTeles:fix/basic-syntax-example-three-reference
Jul 30, 2026
Merged

Fix reference to non-existent "example three"#5724
jordikroon merged 2 commits into
php:masterfrom
GabrielCordeiroBarrosoTeles:fix/basic-syntax-example-three-reference

Conversation

@GabrielCordeiroBarrosoTeles

Copy link
Copy Markdown
Contributor

Summary

  • The short tags paragraph in language.basic-syntax.phptags referred to "example three", but the page only has a single <example> block containing three manually numbered code snippets (1., 2., 3.), not three separate DocBook examples.
  • Reworded the reference to point to the third line of that example instead, so it doesn't refer to a non-existent "example three".

Closes #5685

The short tags paragraph referred to "example three", but the page
only has a single <example> block containing three manually numbered
code snippets, not three separate examples. Point to the third line
of that example instead.

Closes php#5685
Comment thread language/basic-syntax.xml Outdated
Comment thread language/basic-syntax.xml Outdated
Co-authored-by: Jordi Kroon <jordi@jordikroon.nl>
@jordikroon
jordikroon merged commit fa67e21 into php:master Jul 30, 2026
2 checks passed
@jordikroon

Copy link
Copy Markdown
Member

Thank you for your contribution!

KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Aug 9, 2026
- php/doc-en#5724(Fix reference to non-existent "example three")
  短縮タグの説明が、存在しない「例 3」を参照していた誤りを修正する。
  このページに example は 1 つしかなく、その中で 3 つのコードが手で番号付け
  されているだけなので、原文は「上の例の 3 番目」を指す表現に変わった。
  あわせて当該段落が para から simpara になったのを反映する。

- php/doc-en#5747(Example emits warning unrelated to content)
  「条件を使った高度なエスケープ」のコード例が、未定義の変数 $expression を
  参照していて内容と無関係な警告を出していたのを修正する。
KentarouTakeda added a commit to php/doc-ja that referenced this pull request Aug 9, 2026
* PDO・PDO_PGSQL・PDO_Firebird の PHP 8.4 の変更を追従

php/doc-en#5703(ext/pdo: PHP 8.4 changes across PDO, PDO_PGSQL and PDO_Firebird)に追従。

- reference/pdo/pdo/prepare.xml — ドライバ固有の SQL パーサーの説明を追加。
  あわせて 8.4.0 より前のパーサーについての注記を過去形にする
- reference/pdo/pdo/getattribute.xml — 取得できる属性の一覧を原文に合わせて差し替え
- reference/pdo/pdostatement/getattribute.xml — Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE を追加
- reference/pdo_pgsql/reference.xml — DSN の認証情報がコンストラクタの引数より
  優先される旨の注記を追加
- reference/pdo_pgsql/pdo-pgsql.xml — ドル記号で囲まれた文字列の中で疑問符を
  ?? としてエスケープすることが非推奨になった旨の注記を追加
- reference/pdo_pgsql/configure.xml — libpq 10.0 以降が必要になった旨を追加
- reference/pdo_firebird/configure.xml — C++ コンパイラと fbclient 3.0 以降が
  必要になった旨を追加

* SimpleXML で暗黙の巻き戻しがなくなったことを追従

php/doc-en#5737(ext/simplexml: Document that get methods and string casts no
longer implicitly rewind)に追従。PHP 8.4.0 以降、値を取得するメソッドの呼び出しと
string へのキャストがイテレータを暗黙的に巻き戻さなくなった旨を追加する。

- reference/simplexml/simplexmlelement.xml
- reference/simplexml/simplexmlelement/rewind.xml

* language/basic-syntax.xml を原文の修正に追従

- php/doc-en#5724(Fix reference to non-existent "example three")
  短縮タグの説明が、存在しない「例 3」を参照していた誤りを修正する。
  このページに example は 1 つしかなく、その中で 3 つのコードが手で番号付け
  されているだけなので、原文は「上の例の 3 番目」を指す表現に変わった。
  あわせて当該段落が para から simpara になったのを反映する。

- php/doc-en#5747(Example emits warning unrelated to content)
  「条件を使った高度なエスケープ」のコード例が、未定義の変数 $expression を
  参照していて内容と無関係な警告を出していたのを修正する。

* entities/entities.remove.ent の revtag を更新

php/doc-en#5722(Convert and move global.ent into doc-en)で、削除予定の
エンティティ 3 件(reference.pdo-cubrid.entities.PDO、
reference.pdo-pgsql.entities.PDO、reference.pdo-sqlite.entities.PDO)が
このファイルに移された。

原文が「翻訳側は entities を空のままにし、revtag だけ更新する」と明記している
ファイルなので、EN-Revision だけを更新する。上記 3 件は ja ツリーからの参照が
ゼロであることを確認した。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refer to absent example

2 participants