[DOC-CVS] [doc-base] master: Remove skeleton comments (#309)

[email protected] (NickSdot via GitHub) Sat, 27 Jun 2026 10:11:24 +0000
Newsgroups php.doc.cvs
Message-ID <[email protected]>
Author: NickSdot (NickSdot)
Committer: GitHub (web-flow)
Pusher: kamil-tekiela
Date: 2026-06-27T12:11:21+02:00

Commit: https://github.com/php/doc-base/commit/dbbb2aa769b0b1c83df8c519aad0a9f1843729d3
Raw diff: https://github.com/php/doc-base/commit/dbbb2aa769b0b1c83df8c519aad0a9f1843729d3.diff

Remove skeleton comments (#309)

Changed paths:
  M  skeletons/book.xml
  M  skeletons/classname.xml
  M  skeletons/exceptionname.xml
  M  skeletons/method.xml
  M  skeletons/setup.xml


Diff:

diff --git a/skeletons/book.xml b/skeletons/book.xml
index 61bb87f5c5..a883d0dede 100644
--- a/skeletons/book.xml
+++ b/skeletons/book.xml
@@ -3,14 +3,12 @@
  <title>Long title of extension</title>
  <titleabbrev>Extname</titleabbrev>
 
- <!-- {{{ preface -->
  <preface xml:id="intro.extname">
   &reftitle.intro;
   <simpara>
    Extension introduction.
   </simpara>
  </preface>
- <!-- }}} -->
 
  &reference.extname.setup;
  &reference.extname.constants;
diff --git a/skeletons/classname.xml b/skeletons/classname.xml
index 774d945cf6..d74516e898 100644
--- a/skeletons/classname.xml
+++ b/skeletons/classname.xml
@@ -5,19 +5,16 @@
  
  <partintro>
 
-  <!-- {{{ ClassName intro -->
   <section xml:id="classname.intro">
    &reftitle.intro;
    <simpara>
     Description of the class.
    </simpara>
   </section>
-  <!-- }}} -->
 
   <section xml:id="classname.synopsis">
    &reftitle.classsynopsis;
 
-   <!-- {{{ Synopsis -->
    <classsynopsis class="class">
     <ooclass>
      <classname>ClassName</classname>
@@ -90,7 +87,6 @@
      <xi:fallback/>
     </xi:include>
    </classsynopsis>
-   <!-- }}} -->
 
   </section>
 
diff --git a/skeletons/exceptionname.xml b/skeletons/exceptionname.xml
index a305f33b4a..02347592b0 100644
--- a/skeletons/exceptionname.xml
+++ b/skeletons/exceptionname.xml
@@ -5,19 +5,16 @@
  
  <partintro>
  
-<!-- {{{ ExceptionName intro -->
   <section xml:id="exceptionname.intro">
    &reftitle.intro;
    <simpara>
     Description of the exception.
    </simpara>
   </section>
-<!-- }}} -->
 
   <section xml:id="exceptionname.synopsis">
    &reftitle.classsynopsis;
 
-   <!-- {{{ Synopsis -->
    <classsynopsis class="class">
     <ooclass>
      <classname>ExceptionName</classname>
diff --git a/skeletons/method.xml b/skeletons/method.xml
index a0f763d963..db25e61e1b 100644
--- a/skeletons/method.xml
+++ b/skeletons/method.xml
@@ -131,7 +131,7 @@ Procedural synopsis goes after OOP synopsis.
 <![CDATA[
 <?php
 if ($anexample === true) {
-    echo 'Use the PEAR Coding standards';
+    echo 'Use the latest PHP-FIG PER Coding style for PHP code examples: https://www.php-fig.org/per/coding-style/';
 }
 if ($thereisoutput === 'and it is multiple lines') {
     echo 'Use a screen like we did below';
diff --git a/skeletons/setup.xml b/skeletons/setup.xml
index 8826265373..940c9e2fce 100644
--- a/skeletons/setup.xml
+++ b/skeletons/setup.xml
@@ -3,35 +3,27 @@
  &reftitle.setup;
 
  <!-- Remove sections which are useless -->
- <!-- {{{ Requirements -->
  <section xml:id="extname.requirements">
   &reftitle.required;
   &no.requirement;
  </section>
- <!-- }}} -->
 
- <!-- {{{ Installation -->
  <section xml:id="extname.installation">
   &reftitle.install;
   &no.install;
  </section>
  <!-- or &reference.extname.entities.configure; -->
- <!-- }}} -->
 
- <!-- {{{ Configuration -->
  <section xml:id="extname.configuration">
   &reftitle.runtime;
   &no.config;
  </section>
  <!-- or &reference.extname.entities.ini; -->
- <!-- }}} -->
 
- <!-- {{{ Resources -->
  <section xml:id="extname.resources">
   &reftitle.resources;
   &no.resource;
  </section>
- <!-- }}} -->
 
 </chapter>
 <!-- Keep this comment at the end of the file