From 61b4dc2c645294378fdd93882922a8a05115fc14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Duval?= <korli@users.berlios.de>
Date: Fri, 15 Sep 2006 13:56:32 +0000
Subject: [PATCH] improves the checks : now includes initializer, virtuals
 style fixes HeaderSampler.pl now outputs the good methodsynopsis content to
 copy/paste

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@18853 a95241bf-73f2-0310-859d-f6bbb57e9c96
---
 src/documentation/docbook-xsl/html/synop.xsl  |  5 +-
 .../haiku_book/midi/midi2consumer.xml         |  2 +-
 .../haiku_book/midi/midi2endpoint.xml         |  6 +-
 .../haiku_book/midi/midi2localconsumer.xml    | 71 +++++++++++--------
 .../haiku_book/midi/midi2localproducer.xml    | 63 ++++++++--------
 .../haiku_book/midi/midi2producer.xml         |  6 +-
 .../docbook/headersampler/HeaderSampler.pl    | 21 +++---
 7 files changed, 98 insertions(+), 76 deletions(-)

diff --git a/src/documentation/docbook-xsl/html/synop.xsl b/src/documentation/docbook-xsl/html/synop.xsl
index 12ac37a455..b16da35309 100644
--- a/src/documentation/docbook-xsl/html/synop.xsl
+++ b/src/documentation/docbook-xsl/html/synop.xsl
@@ -1074,6 +1074,9 @@ paramdef      ::= (#PCDATA|type|replaceable|parameter|funcparams)*
 <xsl:template match="type" mode="cpp">
   <span class="{name(.)}">
     <xsl:apply-templates mode="cpp"/>
+    <xsl:if test="substring(., string-length(.)) != '*'">
+	<xsl:text>&nbsp;</xsl:text>
+    </xsl:if>
   </span>
 </xsl:template>
 
@@ -1086,7 +1089,7 @@ paramdef      ::= (#PCDATA|type|replaceable|parameter|funcparams)*
 
 <xsl:template match="initializer" mode="cpp">
   <span class="{name(.)}">
-    <xsl:text>=&nbsp;</xsl:text>
+    <xsl:text>&nbsp;=&nbsp;</xsl:text>
     <xsl:apply-templates mode="cpp"/>
   </span>
 </xsl:template>
diff --git a/src/documentation/haiku_book/midi/midi2consumer.xml b/src/documentation/haiku_book/midi/midi2consumer.xml
index 6b87b07aaf..282ea1424e 100644
--- a/src/documentation/haiku_book/midi/midi2consumer.xml
+++ b/src/documentation/haiku_book/midi/midi2consumer.xml
@@ -20,7 +20,7 @@
 		
 		<methodsynopsis>
 			<type>bigtime_t</type>
-			<methodname>Latency</methodname>
+			<methodname>Latency</methodname><void/>
 			<modifier>const</modifier>
 		</methodsynopsis>
 		
diff --git a/src/documentation/haiku_book/midi/midi2endpoint.xml b/src/documentation/haiku_book/midi/midi2endpoint.xml
index 2c2da1bc06..ce003ddf7d 100644
--- a/src/documentation/haiku_book/midi/midi2endpoint.xml
+++ b/src/documentation/haiku_book/midi/midi2endpoint.xml
@@ -31,7 +31,7 @@
 		<title>Name()</title>
 		
 		<methodsynopsis>
-			<type><modifier>const</modifier> char *</type>
+			<modifier>const</modifier><type>char *</type>
 			<methodname>Name</methodname><void/>
 			<modifier>const</modifier>
 		</methodsynopsis>
@@ -56,7 +56,7 @@
 		
 		<methodsynopsis>
 			<void/> <methodname>SetName</methodname>
-			<methodparam><type><modifier>const</modifier>char *</type><parameter>name</parameter></methodparam>
+			<methodparam><modifier>const</modifier><type>char *</type><parameter>name</parameter></methodparam>
 		</methodsynopsis>
 		
 		<para>
@@ -390,7 +390,7 @@ if (endp->IsConsumer())
 		
 		<methodsynopsis>
 			<type>status_t</type> <methodname>SetProperties</methodname>
-			<methodparam><type><modifier>const</modifier>BMessage *</type><parameter>properties</parameter></methodparam>
+			<methodparam><modifier>const</modifier><type>BMessage *</type><parameter>properties</parameter></methodparam>
 		</methodsynopsis>
 		
 		<para>
diff --git a/src/documentation/haiku_book/midi/midi2localconsumer.xml b/src/documentation/haiku_book/midi/midi2localconsumer.xml
index 2fb618895d..cda4e9ea13 100644
--- a/src/documentation/haiku_book/midi/midi2localconsumer.xml
+++ b/src/documentation/haiku_book/midi/midi2localconsumer.xml
@@ -46,8 +46,13 @@
 	</para>
 	
 	<sect3 id="bmidilocalconsumer_bmidilocalconsumer">
-		<title>BMidiLocalConsumer(const char *name = NULL)</title>
-		
+		<title>BMidiLocalConsumer()</title>
+
+		<methodsynopsis>
+		<methodname>BMidiLocalConsumer</methodname>
+		<methodparam><modifier>const</modifier><type>char *</type><parameter>name</parameter><initializer>NULL</initializer></methodparam>
+		</methodsynopsis>		
+
 		<para>
 			Creates a new local consumer endpoint.
 		</para>
@@ -82,7 +87,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_setlatency">
-		<title>void SetLatency(bigtime_t latency)</title>
+		<title>SetLatency()</title>
+		<methodsynopsis><void/><methodname>SetLatency</methodname><methodparam><type>bigtime_t</type><parameter>latency</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Changes the published latency of the consumer.
@@ -91,7 +97,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_getproducerid">
-		<title>int32 GetProducerID()</title>
+		<title>GetProducerID()</title>
+		<methodsynopsis><type>int32</type><methodname>GetProducerID</methodname><void/></methodsynopsis>
 		
 		<para>
 			Returns the ID of the producer that most recently sent a MIDI event to 
@@ -105,7 +112,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_settimeout">
-		<title>void SetTimeout(bigtime_t when, void *data)</title>
+		<title>SetTimeout()</title>
+		<methodsynopsis><void/><methodname>SetTimeout</methodname><methodparam><type>bigtime_t</type><parameter>when</parameter></methodparam><methodparam><type>void *</type><parameter>data</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Requests that the Timeout() hook will be called at some point
@@ -146,7 +154,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_timeout">
-		<title>virtual void Timeout(void *data)</title>
+		<title>Timeout()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>Timeout</methodname><methodparam><type>void *</type><parameter>data</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Hook function that is called per your own request.
@@ -158,8 +167,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_data">
-		<title>virtual void Data(
-			uchar *data, size_t length, bool atomic, bigtime_t time)</title>
+		<title>Data()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>Data</methodname><methodparam><type>uchar *</type><parameter>data</parameter></methodparam><methodparam><type>size_t</type><parameter>length</parameter></methodparam><methodparam><type>bool</type><parameter>atomic</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when raw MIDI is received
@@ -205,8 +214,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_noteoff">
-		<title>virtual void NoteOff(
-			uchar channel, uchar note, uchar velocity, bigtime_t time)</title>
+		<title>NoteOff()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>NoteOff</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>velocity</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Note Off event is received
@@ -218,8 +227,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_noteon">
-		<title>virtual void NoteOn(
-			uchar channel, uchar note, uchar velocity, bigtime_t time)</title>
+		<title>NoteOn()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>NoteOn</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>velocity</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Note On event is received
@@ -231,8 +240,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_keypressure">
-		<title>virtual void KeyPressure(
-			uchar channel, uchar note, uchar pressure, bigtime_t time)</title>
+		<title>KeyPressure()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>KeyPressure</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>pressure</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Polyphonic Pressure (Aftertouch) event is received
@@ -244,8 +253,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_controlchange">
-		<title>virtual void ControlChange(
-			uchar channel, uchar controlNumber, uchar controlValue, bigtime_t time)</title>
+		<title>ControlChange()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>ControlChange</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>controlNumber</parameter></methodparam><methodparam><type>uchar</type><parameter>controlValue</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Controller Change event is received
@@ -257,8 +266,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_programchange">
-		<title>virtual void ProgramChange(
-			uchar channel, uchar programNumber, bigtime_t time)</title>
+		<title>ProgramChange()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>ProgramChange</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>programNumber</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Program Change event is received
@@ -270,8 +279,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_channelpressure">
-		<title>virtual void ChannelPressure(
-			uchar channel, uchar pressure, bigtime_t time)</title>
+		<title>ChannelPressure()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>ChannelPressure</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>pressure</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Channel Pressure event is received
@@ -283,8 +292,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_pitchbend">
-		<title>virtual void PitchBend(
-			uchar channel, uchar lsb, uchar msb, bigtime_t time)</title>
+		<title>PitchBend()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>PitchBend</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>lsb</parameter></methodparam><methodparam><type>uchar</type><parameter>msb</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Pitch Bend event is received
@@ -296,8 +305,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_systemexclusive">
-		<title>virtual void SystemExclusive(
-			void* data, size_t length, bigtime_t time)</title>
+		<title>SystemExclusive()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>SystemExclusive</methodname><methodparam><type>void *</type><parameter>data</parameter></methodparam><methodparam><type>size_t</type><parameter>length</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a System Exclusive event is received
@@ -319,8 +328,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_systemcommon">
-		<title>virtual void SystemCommon(
-			uchar status, uchar data1, uchar data2, bigtime_t time)</title>
+		<title>SystemCommon()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>SystemCommon</methodname><methodparam><type>uchar</type><parameter>status</parameter></methodparam><methodparam><type>uchar</type><parameter>data1</parameter></methodparam><methodparam><type>uchar</type><parameter>data2</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a System Common event is received.
@@ -336,8 +345,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_systemrealtime">
-		<title>virtual void SystemRealTime(
-			uchar status, bigtime_t time)</title>
+		<title>SystemRealTime()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>SystemRealTime</methodname><methodparam><type>uchar</type><parameter>status</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>			
 			Invoked when a Real Time event is received
@@ -349,7 +358,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_tempochange">
-		<title>virtual void TempoChange(int32 beatsPerMinute, bigtime_t time)</title>
+		<title>TempoChange()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>TempoChange</methodname><methodparam><type>int32</type><parameter>beatsPerMinute</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a Tempo Change event is received
@@ -361,7 +371,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalconsumer_allnotesoff">
-		<title>virtual void AllNotesOff(bool justChannel, bigtime_t time)</title>
+		<title>AllNotesOff()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>AllNotesOff</methodname><methodparam><type>bool</type><parameter>justChannel</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Not used
diff --git a/src/documentation/haiku_book/midi/midi2localproducer.xml b/src/documentation/haiku_book/midi/midi2localproducer.xml
index 4cad7b7842..29cd1ad9ec 100644
--- a/src/documentation/haiku_book/midi/midi2localproducer.xml
+++ b/src/documentation/haiku_book/midi/midi2localproducer.xml
@@ -34,8 +34,11 @@
 	</para>
 	
 	<sect3 id="bmidilocalproducer_bmidilocalproducer">
-		<title>BMidiLocalProducer(const char *name = NULL)</title>
-		
+		<title>BMidiLocalProducer()</title>
+		<methodsynopsis>
+			<methodname>BMidiLocalProducer</methodname>
+			<methodparam><modifier>const</modifier><type>char *</type><parameter>name</parameter><initializer>NULL</initializer></methodparam>
+		</methodsynopsis>
 		<para>
 			Creates a new local producer endpoint.
 		</para>
@@ -70,8 +73,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_connected">
-		<title>virtual void Connected(BMidiConsumer *cons)</title>
-		
+		<title>Connected()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>Connected</methodname><methodparam><modifier>const</modifier><type>BMidiConsumer *</type><parameter>cons</parameter></methodparam></methodsynopsis>
 		<para>
 			Invoked when a new consumer is connected to this producer
 		</para>
@@ -100,7 +103,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_disconnected">
-		<title>virtual void Disconnected(BMidiConsumer *cons)</title>
+		<title>Disconnected()</title>
+		<methodsynopsis><modifier>virtual</modifier><void/><methodname>Disconnected</methodname><methodparam><modifier>const</modifier><type>BMidiConsumer *</type><parameter>cons</parameter></methodparam></methodsynopsis>
 		
 		<para>
 			Invoked when a consumer is disconnected from this producer.
@@ -112,8 +116,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraydata">
-		<title>void SprayData(
-			void *data, size_t length, bool atomic = false, bigtime_t time = 0) const</title>
+		<title>SprayData()</title>
+		<methodsynopsis><void/><methodname>SprayData</methodname><methodparam><type>void *</type><parameter>data</parameter></methodparam><methodparam><type>size_t</type><parameter>length</parameter></methodparam><methodparam><type>bool</type><parameter>atomic</parameter><initializer>false</initializer></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends raw MIDI data downstream to all connected consumers
@@ -149,8 +153,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraynoteoff">
-		<title>void SprayNoteOff(
-			uchar channel, uchar note, uchar velocity, bigtime_t time = 0) const</title>
+		<title>SprayNoteOff()</title>
+		<methodsynopsis><void/><methodname>SprayNoteOff</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>velocity</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Note Off event to all connected consumers
@@ -162,8 +166,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraynoteon">
-		<title>void SprayNoteOn(
-			uchar channel, uchar note, uchar velocity, bigtime_t time = 0) const</title>
+		<title>SprayNoteOn()</title>
+		<methodsynopsis><void/><methodname>SprayNoteOn</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>velocity</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Note On event to all connected consumers
@@ -175,8 +179,8 @@
 	</sect3>
 	
 	<sect3 id="bmidIlocalproducer_spraykeypressure">
-		<title>void SprayKeyPressure(
-			uchar channel, uchar note, uchar pressure, bigtime_t time = 0) const</title>
+		<title>SprayKeyPressure()</title>
+		<methodsynopsis><void/><methodname>SprayKeyPressure</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>note</parameter></methodparam><methodparam><type>uchar</type><parameter>pressure</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Polyphonic Pressure (Aftertouch) event to all connected 
@@ -189,9 +193,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraycontrolchange">
-		<title>void SprayControlChange(
-			uchar channel, uchar controlNumber, uchar controlValue,
-			bigtime_t time = 0) const</title>
+		<title>SprayControlChange()</title>
+		<methodsynopsis><void/><methodname>SprayControlChange</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>controlNumber</parameter></methodparam><methodparam><type>uchar</type><parameter>controlValue</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Controller Change event to all connected consumers.
@@ -204,8 +207,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_sprayprogramchange">
-		<title>void SprayProgramChange(
-			uchar channel, uchar programNumber, bigtime_t time = 0) const</title>
+		<title>SprayProgramChange()</title>
+		<methodsynopsis><void/><methodname>SprayProgramChange</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>programNumber</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 
 		<para>
 			Sends a Program Change event to all connected consumers
@@ -217,8 +220,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraychannelpressure">
-		<title>void SprayChannelPressure(
-			uchar channel, uchar pressure, bigtime_t time = 0) const</title>
+		<title>SprayChannelPressure()</title>
+		<methodsynopsis><void/><methodname>SprayChannelPressure</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>pressure</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Channel Pressure event to all connected consumers
@@ -230,8 +233,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraypitchbend">
-		<title>void SprayPitchBend(
-			uchar channel, uchar lsb, uchar msb, bigtime_t time = 0) const</title>
+		<title>SprayPitchBend()</title>
+		<methodsynopsis><void/><methodname>SprayPitchBend</methodname><methodparam><type>uchar</type><parameter>channel</parameter></methodparam><methodparam><type>uchar</type><parameter>lsb</parameter></methodparam><methodparam><type>uchar</type><parameter>msb</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Pitch Bend event to all connected consumers
@@ -243,8 +246,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraysystemexclusive">
-		<title>void SpraySystemExclusive(
-			void *data, size_t length, bigtime_t time = 0) const</title>
+		<title>SpraySystemExclusive()</title>
+		<methodsynopsis><void/><methodname>SpraySystemExclusive</methodname><methodparam><type>void *</type><parameter>data</parameter></methodparam><methodparam><type>size_t</type><parameter>length</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a System Exclusive event to all connected consumers
@@ -263,8 +266,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraysystemcommon">
-		<title>void SpraySystemCommon(
-			uchar status, uchar data1, uchar data2, bigtime_t time = 0) const</title>
+		<title>SpraySystemCommon()</title>
+		<methodsynopsis><void/><methodname>SpraySystemCommon</methodname><methodparam><type>uchar</type><parameter>status</parameter></methodparam><methodparam><type>uchar</type><parameter>data1</parameter></methodparam><methodparam><type>uchar</type><parameter>data2</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a System Common event to the connected consumers
@@ -321,8 +324,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraysystemrealtime">
-		<title>void SpraySystemRealTime(
-			uchar status, bigtime_t time = 0) const</title>
+		<title>SpraySystemRealTime()</title>
+		<methodsynopsis><void/><methodname>SpraySystemRealTime</methodname><methodparam><type>uchar</type><parameter>status</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		
 		<para>
 			Sends a Real Time event to the connected consumers
@@ -382,8 +385,8 @@
 	</sect3>
 	
 	<sect3 id="bmidilocalproducer_spraytempochange">
-		<title>void SprayTempoChange(
-			int32 beatsPerMinute, bigtime_t time = 0) const</title>
+		<title>SprayTempoChange()</title>
+		<methodsynopsis><void/><methodname>SprayTempoChange</methodname><methodparam><type>int32</type><parameter>beatsPerMinute</parameter></methodparam><methodparam><type>bigtime_t</type><parameter>time</parameter><initializer>0</initializer></methodparam><modifier>const</modifier></methodsynopsis>
 		<para>
 			Sends a Tempo Change event to the connected consumers.
 		</para>
diff --git a/src/documentation/haiku_book/midi/midi2producer.xml b/src/documentation/haiku_book/midi/midi2producer.xml
index ab2b98cf70..466fd2cf54 100644
--- a/src/documentation/haiku_book/midi/midi2producer.xml
+++ b/src/documentation/haiku_book/midi/midi2producer.xml
@@ -25,7 +25,7 @@
 		<methodsynopsis>
 			<type>status_t</type>
 			<methodname>Connect</methodname>
-			<methodparam><type><modifier>const</modifier>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
+			<methodparam><modifier>const</modifier><type>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
 		</methodsynopsis>
 		
 		<para>
@@ -56,7 +56,7 @@
 		<methodsynopsis>
 			<type>status_t</type>
 			<methodname>Disconnect</methodname>
-			<methodparam><type><modifier>const</modifier>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
+			<methodparam><modifier>const</modifier><type>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
 		</methodsynopsis>
 		
 		<para>
@@ -84,7 +84,7 @@
 		<methodsynopsis>
 			<type>bool</type>
 			<methodname>IsConnected</methodname>
-			<methodparam><type><modifier>const</modifier>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
+			<methodparam><modifier>const</modifier><type>BMidiConsumer *</type> <parameter>cons</parameter></methodparam>
 			<modifier>const</modifier>
 		</methodsynopsis>
 		
diff --git a/src/tools/docbook/headersampler/HeaderSampler.pl b/src/tools/docbook/headersampler/HeaderSampler.pl
index 8b41d23a27..600f97b68a 100644
--- a/src/tools/docbook/headersampler/HeaderSampler.pl
+++ b/src/tools/docbook/headersampler/HeaderSampler.pl
@@ -204,16 +204,17 @@ sub PrintFunction {
 	my @args = @_;
 		for (@args) {
 			$paramconst = "";
+			$paraminit = "";
 			if ( /const*/ ) { $paramconst = "<modifier>const</modifier>"; }
-			if ( /[ ]*=[ ]*/ ) { $_ = $`; }		# for default value; ex. (short X = 100)
+			if ( /[ ]*=[ ]*/ ) { $paraminit = "<initializer>". $' ."</initializer>" ; $_ = $`; }	# for default value; ex. (short X = 100)
 			split(/[ ]+/);
 			$paramname = pop();
 			$paramtype = pop();
 			if ( $paramname =~ /^\*/ ) {
 				$paramname = $';
-				$paramtype = $paramtype . " *";
+				$paramtype .= " *";
 			}
-			$_ = "<type>" . $paramconst . $paramtype . "</type> <parameter>" . $paramname . "</parameter>"
+			$_ = $paramconst . "<type>" . $paramtype . "</type> <parameter>" . $paramname . "</parameter>" . $paraminit;
 		}
 	$funcargs = join('</methodparam><methodparam>', @args);
 
@@ -225,16 +226,19 @@ sub PrintFunction {
 		}
 		if ( s/^static[ ]*// ) { 
 			if ( $funcmod =~ /^$/ ) { 
-				$funcmode .= " "; 
+				$funcmod .= " "; 
 			}
-			$funcmode .= "static" 
+			$funcmod .= "static" 
+		}
+		if ($funcmod) {
+			$funcmod = "<modifier>" . $funcmod . "</modifier>";
 		}
 		if ( /^void/ ) {
-			$functype = $funcmode . "<void/>"
+			$functype = $funcmod . "<void/>"
 		} else {
 			$typeconst = "";
 			if ( /^const / ) { $typeconst = "<modifier>const</modifier>"; $_ = $'; }
-			$functype = $funcmode . "<type>" . $typeconst . $_ . "</type>"
+			$functype = $funcmod . $typeconst . "<type>" . $_ . "</type>"
 		}
 	}
 	if ($funcconst) {
@@ -291,7 +295,8 @@ sub ValidateDocbook {
 		}
 	}
 	if ( $found == 0 ) {
-		print $pattern . "\n" ;
+		$pattern =~ s/\*/ \*/g;
+		print "<methodsynopsis>".$pattern . "</methodsynopsis>\n" ;
 	}
 	close IN2;
 }