From 234aed0777c2fc5608b784e926d8f12fd6c1bccb Mon Sep 17 00:00:00 2001
From: Dan <self@danpock.me>
Date: Thu, 28 Apr 2022 10:38:31 -0400
Subject: [PATCH 1/4] Add RFC skeleton for interfaces

---
 RFC/skeletons/interfacename.xml | 91 +++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 RFC/skeletons/interfacename.xml

diff --git a/RFC/skeletons/interfacename.xml b/RFC/skeletons/interfacename.xml
new file mode 100644
index 000000000..e1c39b8ce
--- /dev/null
+++ b/RFC/skeletons/interfacename.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.classname"
+                 xmlns:phpdoc="http://php.net/ns/phpdoc"
+                 xmlns:xlink="http://www.w3.org/1999/xlink"
+                 xmlns:xi="http://www.w3.org/2001/XInclude"
+                 xmlns="http://docbook.org/ns/docbook">
+
+ <title>The InterfaceName interface</title>
+ <titleabbrev>InterfaceName</titleabbrev>
+ 
+ <partintro>
+ 
+<!-- {{{ InterfaceName intro -->
+  <section xml:id="classname.intro">
+   &reftitle.intro;
+   <para>
+    Description of the interface.
+   </para>
+  </section>
+<!-- }}} -->
+ 
+  <section xml:id="classname.synopsis">
+   &reftitle.interfacesynopsis;
+ 
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>InterfaceName</classname></ooclass>
+ 
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <oointerface>
+      <interfacename>InterfaceName</interfacename>
+     </oointerface>
+
+<!-- If the interface extends any other interface, or two, use this (one oointerface element per interface; extends modifier only on first one)
+     <oointerface>
+      <modifier>extends</modifier>
+      <interfacename>InterfaceName</interfacename>
+     </oointerface>
+-->
+    </classsynopsisinfo>
+<!-- }}} -->
+
+<!-- Edit the classname below -->
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.classname')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])">
+     <xi:fallback />
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.classname')/db:refentry/db:refsect1[@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])">
+     <xi:fallback />
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.classname')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])">
+     <xi:fallback />
+    </xi:include>
+
+<!-- If the interface extends an interface use this. Repeat the <xi:include> tag for all the parent interfaces in the event of multiple extensions; i.e. class XYZ extends class XY and class XY extends class X
+    <classsynopsisinfo role="comment">Inherited methods</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.baseclassname')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural') and not(modifier='private')])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+-->
+<!-- }}} -->
+ 
+  </section>
+ 
+ </partintro>
+ 
+ &reference.extname.entities.classname;
+ 
+</phpdoc:classref>
+<!-- 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
+-->

From 6e012158accbe296bd06d09d18f1cee21ef2eef4 Mon Sep 17 00:00:00 2001
From: Dan <self@danpock.me>
Date: Thu, 28 Apr 2022 11:41:18 -0400
Subject: [PATCH 2/4] fix end tag being commented out

---
 RFC/skeletons/interfacename.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RFC/skeletons/interfacename.xml b/RFC/skeletons/interfacename.xml
index e1c39b8ce..f6bb70617 100644
--- a/RFC/skeletons/interfacename.xml
+++ b/RFC/skeletons/interfacename.xml
@@ -58,8 +58,8 @@
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.baseclassname')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural') and not(modifier='private')])">
      <xi:fallback/>
     </xi:include>
-   </classsynopsis>
 -->
+   </classsynopsis>
 <!-- }}} -->
  
   </section>

From aa7a30f26bcc9adb176fed83f26ce725d0ab1351 Mon Sep 17 00:00:00 2001
From: Dan <self@danpock.me>
Date: Thu, 28 Apr 2022 11:42:39 -0400
Subject: [PATCH 3/4] What if we just add interface specific tags here...

...this could legit make things easier later.
Since down the line in PHD it may be easier to target rendering a new element compared to adding conditionals for an existing one?
---
 RFC/skeletons/interfacename.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/RFC/skeletons/interfacename.xml b/RFC/skeletons/interfacename.xml
index f6bb70617..c72b4dee5 100644
--- a/RFC/skeletons/interfacename.xml
+++ b/RFC/skeletons/interfacename.xml
@@ -23,11 +23,11 @@
    &reftitle.interfacesynopsis;
  
 <!-- {{{ Synopsis -->
-   <classsynopsis>
+   <interfacesynopsis>
     <ooclass><classname>InterfaceName</classname></ooclass>
  
 <!-- {{{ Class synopsis -->
-    <classsynopsisinfo>
+    <interfacesynopsisinfo>
      <oointerface>
       <interfacename>InterfaceName</interfacename>
      </oointerface>
@@ -38,11 +38,11 @@
       <interfacename>InterfaceName</interfacename>
      </oointerface>
 -->
-    </classsynopsisinfo>
+    </interfacesynopsisinfo>
 <!-- }}} -->
 
 <!-- Edit the classname below -->
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <interfacesynopsisinfo role="comment">&Methods;</interfacesynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.classname')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])">
      <xi:fallback />
     </xi:include>
@@ -59,7 +59,7 @@
      <xi:fallback/>
     </xi:include>
 -->
-   </classsynopsis>
+   </interfacesynopsis>
 <!-- }}} -->
  
   </section>

From 077e6e53642c91064ecf759fc2635be6a3cb0020 Mon Sep 17 00:00:00 2001
From: Dan <self@danpock.me>
Date: Thu, 28 Apr 2022 11:52:42 -0400
Subject: [PATCH 4/4] Allow new interfacesynopsis into sections

---
 docbook/docbook-xml/docbook.dtd | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/docbook/docbook-xml/docbook.dtd b/docbook/docbook-xml/docbook.dtd
index 51dc280d4..223830723 100644
--- a/docbook/docbook-xml/docbook.dtd
+++ b/docbook/docbook-xml/docbook.dtd
@@ -932,6 +932,33 @@
 
 >
 
+<!ELEMENT interfacesynopsis ((ooclass|oointerface)+, (interfacesynopsisinfo|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|xi:include)*)>
+
+<!ATTLIST interfacesynopsis
+	xmlns	CDATA	#FIXED	"http://docbook.org/ns/docbook"
+	role	CDATA	#IMPLIED
+	%db.common.attributes;
+	%db.common.linking.attributes;
+	language	CDATA	#IMPLIED
+	class	(class|interface)	#IMPLIED
+
+>
+
+<!ELEMENT interfacesynopsisinfo (#PCDATA|info|textobject|inlinemediaobject|remark|superscript|subscript|xref|link|olink|anchor|biblioref|alt|annotation|indexterm|abbrev|acronym|date|emphasis|footnote|footnoteref|foreignphrase|phrase|quote|wordasword|firstterm|glossterm|coref|productnumber|productname|database|application|hardware|trademark|citation|citerefentry|citetitle|citebiblioid|author|person|personname|org|orgname|editor|jobtitle|replaceable|systemitem|option|optional|package|parameter|property|termdef|nonterminal|errorcode|errortext|errorname|errortype|prompt|envar|filename|command|computeroutput|userinput|function|varname|returnvalue|type|classname|exceptionname|interfacename|methodname|modifier|initializer|ooclass|ooexception|oointerface|tag|markup|token|symbol|literal|code|constant|email|uri|guiicon|guibutton|guimenuitem|guimenu|guisubmenu|guilabel|menuchoice|mousebutton|keycombo|keycap|keycode|keysym|shortcut|accel|inlineequation|lineannotation|co)*>
+
+<!ATTLIST interfacesynopsisinfo
+	xmlns	CDATA	#FIXED	"http://docbook.org/ns/docbook"
+	role	CDATA	#IMPLIED
+	%db.common.attributes;
+	%db.common.linking.attributes;
+	continuation	(continues|restarts)	#IMPLIED
+	linenumbering	(numbered|unnumbered)	#IMPLIED
+	startinglinenumber	NMTOKEN	#IMPLIED
+	language	CDATA	#IMPLIED
+	xml:space	(preserve)	#IMPLIED
+
+>
+
 <!ELEMENT ooclass ((package|modifier)*, classname)>
 
 <!ATTLIST ooclass
@@ -2644,7 +2671,7 @@
 
 >
 
-<!ELEMENT section (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (((section)+, (simplesect)*)|(simplesect)+|(phpdoc:varentry|refentry)+)?)|((section)+, (simplesect)*)|(simplesect)+|(phpdoc:varentry|refentry|xi:include)+), (glossary|bibliography|index|toc)*)>
+<!ELEMENT section (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|interfacesynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (((section)+, (simplesect)*)|(simplesect)+|(phpdoc:varentry|refentry)+)?)|((section)+, (simplesect)*)|(simplesect)+|(phpdoc:varentry|refentry|xi:include)+), (glossary|bibliography|index|toc)*)>
 
 <!ATTLIST section
 	xmlns	CDATA	#FIXED	"http://docbook.org/ns/docbook"