<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN">
<HTML>
<HEAD>
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8">
  <META NAME="GENERATOR" CONTENT="GtkHTML/3.32.2">
</HEAD>
<BODY>
On Mon, 2011-09-26 at 18:38 -0600, Matt Dew wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
On 09/25/2011 11:55 AM, Gaetan Nadon wrote:
&gt; On Sat, 2011-09-24 at 20:23 -0600, Matt Dew wrote:
&gt;&gt; ---
&gt;&gt;   specs/saver.xml |   30 +++++++++++++++---------------
&gt;&gt;   1 files changed, 15 insertions(+), 15 deletions(-)
&gt;&gt;
&gt;&gt; diff --git a/specs/saver.xml b/specs/saver.xml
&gt;&gt; index b1e6f95..bcdd3a0 100644
&gt;&gt; --- a/specs/saver.xml
&gt;&gt; +++ b/specs/saver.xml
&gt;&gt; @@ -39,7 +39,7 @@ implied warranty.
&gt;&gt;   &lt;/legalnotice&gt;
&gt;&gt;   &lt;/bookinfo&gt;
&gt;&gt;
&gt;&gt; -&lt;chapter id=&quot;Introduction_&quot;&gt;
&gt;&gt; +&lt;chapter id='Introduction'&gt;
&gt;&gt;   &lt;title&gt;Introduction&lt;/title&gt;
&gt;&gt;   &lt;para&gt;
&gt;&gt;   The X Window System provides support for changing the image on a display screen
&gt;&gt; @@ -464,7 +464,7 @@ window attributes.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;   &lt;/sect1&gt;
&gt;&gt;
&gt;&gt; -&lt;sect1 id=&quot;Events_&quot;&gt;
&gt;&gt; +&lt;sect1 id=&quot;Events&quot;&gt;
&gt;&gt;   &lt;title&gt;Events&lt;/title&gt;
&gt;&gt;   &lt;para&gt;
&gt;&gt;   The Screen Saver extension adds one event:
&gt;&gt; @@ -649,7 +649,7 @@ SETofSCREENSAVEREVENT
&gt;&gt;   &lt;/literallayout&gt;
&gt;&gt;   &lt;/sect1&gt;
&gt;&gt;
&gt;&gt; -&lt;sect1 id=&quot;Events&quot;&gt;
&gt;&gt; +&lt;sect1 id=&quot;Events_2&quot;&gt;
&gt;&gt;   &lt;title&gt;Events&lt;/title&gt;
&gt;&gt;
&gt;&gt;   &lt;literallayout class=&quot;monospaced&quot;&gt;
&gt;&gt; @@ -673,7 +673,7 @@ SETofSCREENSAVEREVENT
&gt;&gt;   &lt;/sect1&gt;
&gt;&gt;   &lt;/chapter&gt;
&gt;&gt;
&gt;&gt; -&lt;chapter id=&quot;Inter_Client_Communications_Conventions_&quot;&gt;
&gt;&gt; +&lt;chapter id='Inter_Client_Communications_Conventions'&gt;
&gt;&gt;   &lt;title&gt;Inter-Client Communications Conventions&lt;/title&gt;
&gt;&gt;   &lt;para&gt;
&gt;&gt;   Screen saver clients should create at least one resource value whose
&gt;&gt; @@ -705,7 +705,7 @@ The include file for this extension is
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverqueryextension'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverQueryExtension'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Bool&lt;function&gt;XScreenSaverQueryExtension&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -728,7 +728,7 @@ no additional errors are defined by this extension, the results
&gt;&gt;   of&lt;emphasis remap='I'&gt;error_base&lt;/emphasis&gt;  are not defined.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverqueryversion'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverQueryVersion'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Status&lt;function&gt;XScreenSaverQueryVersion&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -753,14 +753,14 @@ set and 0 is returned.
&gt;&gt;   &lt;para&gt;
&gt;&gt;   This routine allocates and returns an
&gt;&gt;   &lt;emphasis role=&quot;bold&quot;&gt;XScreenSaverInfo&lt;/emphasis&gt;  structure
&gt;&gt; -for use in calls to&lt;function&gt;XScreenSaverQueryInfo&lt;/function&gt;.
&gt;&gt; +for use in calls to&lt;xref linkend='XScreenSaverQueryInfo' xrefstyle='select: title pageabbrev'/&gt;.
&gt; Are you considering adding &quot;xrefstyle&quot; with pageabbrev to all xref links?
&gt; If so, consider this suggestion to put it in the customization layer.

No, there are places where it doesn't make sense.  A lot of links are 
very close to the target so a page # feels unnecessary.  Same page, 
sometimes the very preceeding or next paragraph so it doesn't make sense 
to do it everywhere.


&gt; <A HREF="http://lists.oasis-open.org/archives/docbook-apps/200405/msg00121.html">http://lists.oasis-open.org/archives/docbook-apps/200405/msg00121.html</A>
&gt; This attribute was meant to override the default in a few instances.
&gt;
&gt; Consider that we might want to change the xrefstyle at later point in time.
&gt;

Yep, everything I do is with the thought that style can and will change 
in the future.

&gt;&gt;   All fields in the
&gt;&gt;   structure are initialized to zero.  If insufficient memory is available,
&gt;&gt;   NULL is returned.  The results of this routine can be released
&gt;&gt; -using&lt;emphasis remap='I'&gt;XFree&lt;/emphasis&gt;.
&gt;&gt; +using&lt;olink targetdoc='libX11' targetptr='XFree'&gt;&lt;function&gt;XFree&lt;/function&gt;&lt;/olink&gt;.
&gt; I assume that libX11 xfree will be changed to XFree.

Yep.


&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverqueryinfo'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverQueryInfo'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Status&lt;function&gt;XScreenSaverQueryInfo&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -795,7 +795,7 @@ description of the fields.  If the extension is not supported,
&gt;&gt;   is returned.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverselectinput'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverSelectInput'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;void&lt;function&gt;XScreenSaverSelectInput&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -832,7 +832,7 @@ See the definition of the
&gt;&gt;   of the allowed event masks.&lt;!-- xref ? --&gt;
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaversetattributes'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverSetAttributes'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;void&lt;function&gt;XScreenSaverSetAttributes&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*dpy&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -858,7 +858,7 @@ of the&lt;function&gt;ScreenSaverSetAttributes&lt;/function&gt;  request for a
&gt;&gt;   description of each of the arguments.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverunsetattributes'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverUnsetAttributes'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;void&lt;function&gt;XScreenSaverUnsetAttributes&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -872,7 +872,7 @@ extension, this routine instructs the server to discard
&gt;&gt;   any previous screen saver window attributes set by this client.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverregister'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverRegister'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Status&lt;function&gt;XScreenSaverRegister&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -891,7 +891,7 @@ is encountered and the property is not changed, otherwise it returns
&gt;&gt;   non-zero.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensaverunregister'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverUnregister'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Status&lt;function&gt;XScreenSaverUnregister&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;&gt; @@ -906,7 +906,7 @@ It returns zero if an error is encountered and the property is changed,
&gt;&gt;   otherwise it returns non-zero.
&gt;&gt;   &lt;/para&gt;
&gt;&gt;
&gt;&gt; -&lt;funcsynopsis id='xscreensavergetregistered'&gt;
&gt;&gt; +&lt;funcsynopsis id='XScreenSaverGetRegistered'&gt;
&gt;&gt;   &lt;funcprototype&gt;
&gt;&gt;     &lt;funcdef&gt;Status&lt;function&gt;XScreenSaverGetRegistered&lt;/function&gt;&lt;/funcdef&gt;
&gt;&gt;       &lt;paramdef&gt;Display&lt;parameter&gt;*display&lt;/parameter&gt;&lt;/paramdef&gt;
&gt;
&gt;

</PRE>
</BLOCKQUOTE>
Reviewed-by: Gaetan Nadon &lt;memsize@videotron.ca&gt;
</BODY>
</HTML>