updated the acknowledgements section, and added a few notes to the release-7 section

Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>

2 files changed, 89 insertions, 5 deletions

diff --git a/specs/CH13.xml b/specs/CH13.xml
index 57ec69f..9b6bc88 100644
--- a/specs/CH13.xml
+++ b/specs/CH13.xml
@@ -863,7 +863,7 @@ did not document any new or improved features.
 </itemizedlist>
 <para>
 Throughout this interval,
-there were undocumented fixes and improvements made to the X Toolkit library.
+there were undocumented fixes and improvements made to the X Toolkit Intrinsics library.
 The documentation was modified to fix minor errors,
 improve the formatting, and
 update version numbers.
@@ -888,7 +888,7 @@ because (as of April 2019) there are no plans for an X11R7.8 release.
 The Intrinsics specification was first released with X11R3 in 1989.
 That was too early to take Standard C (i.e., ANSI C) into account.
 Because vendors generally did not provide a no-cost Standard C compiler,
-the X Toolkit library initially supported both K&amp;R and ANSI C.
+the X Toolkit Intrinsics library initially supported both K&amp;R and ANSI C.
 The X11R5 release notes mention using gcc, with some caveats.
 As a result, the specification and implementation gave equal attention
 to both K&amp;R and ANSI C.
@@ -917,7 +917,7 @@ Used with a K&amp;R compiler, those parameters were ignored.
 <itemizedlist>
 <listitem>
 <para>
-The X Toolkit library used <type>const</type> in just a few cases.
+The X Toolkit Intrinsics library used <type>const</type> in just a few cases.
 The specification did not mention it at all.
 </para>
 <para>
@@ -999,7 +999,7 @@ associated with <type>const</type>.
 <listitem>
 <para>
 The <type>String</type> type is not the only type used in the
-prototypes for the X Toolkit library.
+prototypes for the X Toolkit Intrinsics library.
 Its developers were also concerned with porting the library
 to platforms with different size-constraints.
 They defined different types (used in the function prototypes)
@@ -1141,7 +1141,39 @@ Applications which use the newer <type>const</type> feature must define
 </listitem>
 <listitem>
 <para>
-By default, the X Toolkit library uses the <type>const</type> feature.
+By default, the X Toolkit Intrinsics library
+uses the <type>const</type> feature.
+It has been updated to make use of the <type>const</type> feature
+for improved type-checking.
+</para>
+</listitem>
+<listitem>
+<para>
+Because the X Toolkit Intrinsics library uses <type>const</type>,
+some prototypes have been modified.
+For example:
+<itemizedlist>
+<listitem>
+<para>
+Most of the parameters which used <type>String</type> are unmodified; 
+a few (such as the <emphasis remap='I'>argv</emphasis>&ndash;parameters)
+are actually read/write.
+They are now <type>char*</type> parameters.
+</para>
+<para>
+Many of the strings passed to the library are stored in widgets
+without reallocating a copy.
+Those are treated as read-only, and use the <type>String</type> type.
+</para>
+</listitem>
+<listitem>
+<para>
+Each change to the documentation was verified using scripts that
+extracted the function prototypes and used the C compiler to check
+for compatibility.
+</para>
+</listitem>
+</itemizedlist>
 </para>
 </listitem>
 </itemizedlist>
diff --git a/specs/acknowledgement.xml b/specs/acknowledgement.xml
index f5ab15d..86eb717 100644
--- a/specs/acknowledgement.xml
+++ b/specs/acknowledgement.xml
@@ -3,6 +3,57 @@
 
 <!-- <acknowledgements> -->
 <dedication>
+<title>Acknowledgments</title>
+
+
+<note>
+<title>Acknowledgments for X11R7</title>
+<para>
+This update to the X11 Intrinsics drops support for K&amp;R C,
+as well as improving its use of Standard C features,
+notably <type>const</type>.
+</para>
+<itemizedlist>
+<listitem>
+<para>
+Matt Dew did the initial conversion of this specification from nroff to DocBook.
+</para>
+<para>
+Later, I expanded on that, improving the formatting, as
+well as updating the function prototypes in the specification
+as well as the related manual pages.
+</para>
+</listitem>
+<listitem>
+<para>
+Matthieu Herrb modified the Intrinsics header files to drop support
+for K&amp;R C, leaving the Standard C prototypes.
+</para>
+<para>
+Later, he applied my changes to complete the conversion of the
+library source from a mixture of K&amp;R C and Standard C to
+just use the standard language features.
+</para>
+</listitem>
+<listitem>
+<para>
+Others (including
+Alan Coopersmith,
+Gaetan Nadon,
+Walter Harms,
+and Kevin E. Martin) have worked to
+maintain the library's build-scripts and documentation.
+</para>
+</listitem>
+</itemizedlist>
+<literallayout>
+Thomas E. Dickey
+invisible-island.net
+April 2019
+</literallayout>
+</note>
+
+<note>
 <title>Acknowledgments for X11R6</title>
 
 <para>
@@ -322,5 +373,6 @@ Donna Converse
 X Consortium
 April 1994
 </literallayout>
+</note>
 </dedication>
 <!-- </acknowledgements> -->