From b70d86253a99f417b1de944e6cbbd42aaf1b4ba9 Mon Sep 17 00:00:00 2001
From: John Reese <jreese@leetcode.net>
Date: Thu, 26 Feb 2009 16:59:18 -0500
Subject: [PATCH] Added basic bug and bugnote view events.

---
 .../developers/en/event-reference-bug.sgml    | 128 +++++++++++++++++-
 1 file changed, 126 insertions(+), 2 deletions(-)

diff --git a/docbook/developers/en/event-reference-bug.sgml b/docbook/developers/en/event-reference-bug.sgml
index 984d5b0a85..4b8e8cb5d5 100644
--- a/docbook/developers/en/event-reference-bug.sgml
+++ b/docbook/developers/en/event-reference-bug.sgml
@@ -1,5 +1,129 @@
 <sect1 id="dev.eventref.bug">
-	<title>Bug / Bugnote Actions</title>
+	<title>Bug and Bugnote Actions</title>
+
+	<sect2 id="dev.eventref.bug.view">
+		<title>Bug View Events</title>
+
+		<blockquote id="dev.eventref.bug.view.details">
+			<title>EVENT_VIEW_BUG_DETAILS (Execute)</title>
+
+			<blockquote>
+				<para>
+					This event allows a plugin to either process information or display some
+					data in the bug view page.  It is triggered after the row containing the
+					target version and product build fields, and before the bug summary is
+					displayed.
+				</para>
+
+				<para>
+					Any output here should be defining appropriate rows and columns for the
+					surrounding <programlisting>&lt;table&gt;</programlisting> elements.
+				</para>
+
+				<itemizedlist>
+					<title>Parameters</title>
+					<listitem><para>&lt;Integer&gt;: Bug ID</para></listitem>
+					<listitem><para>&lt;Boolean&gt;: Advanced view (false for simple view)</para></listitem>
+				</itemizedlist>
+			</blockquote>
+		</blockquote>
+
+		<blockquote id="dev.eventref.bug.view.extra">
+			<title>EVENT_VIEW_BUG_EXTRA (Execute)</title>
+
+			<blockquote>
+				<para>
+					This event allows a plugin to either process information or display some
+					data in the bug view page.  It is triggered after the bug notes have been
+					displayed, but before the history log is shown.
+				</para>
+
+				<para>
+					Any output here should be contained within its own
+					<programlisting>&lt;table&gt;</programlisting> element.
+				</para>
+
+				<itemizedlist>
+					<title>Parameters</title>
+					<listitem><para>&lt;Integer&gt;: Bug ID</para></listitem>
+					<listitem><para>&lt;Boolean&gt;: Advanced view (false for simple view)</para></listitem>
+				</itemizedlist>
+			</blockquote>
+		</blockquote>
+
+	</sect2>
+
+	<sect2 id="dev.eventref.bug.noteview">
+		<title>Bugnote View Events</title>
+
+		<blockquote id="dev.eventref.bug.noteview.start">
+			<title>EVENT_VIEW_BUGNOTES_START (Execute)</title>
+
+			<blockquote>
+				<para>
+					This event allows a plugin to either process information or display some
+					data in the bug notes section, before any bug notes are displayed.  It is
+					triggered after the bug notes section title.
+				</para>
+
+				<para>
+					Any output here should be defining appropriate rows and columns for the
+					surrounding <programlisting>&lt;table&gt;</programlisting> elements.
+				</para>
+
+				<itemizedlist>
+					<title>Parameters</title>
+					<listitem><para>&lt;Integer&gt;: Bug ID</para></listitem>
+					<listitem><para>&lt;Complex&gt;: A list of all bugnotes to be displayed to the user</para></listitem>
+				</itemizedlist>
+			</blockquote>
+		</blockquote>
+
+		<blockquote id="dev.eventref.bug.noteview.note">
+			<title>EVENT_VIEW_BUGNOTE (Execute)</title>
+
+			<blockquote>
+				<para>
+					This event allows a plugin to either process information or display some
+					data in the bug notes section, interleaved with the individual bug notes.
+					It gets triggered after every bug note is displayed.
+				</para>
+
+				<para>
+					Any output here should be defining appropriate rows and columns for the
+					surrounding <programlisting>&lt;table&gt;</programlisting> elements.
+				</para>
+
+				<itemizedlist>
+					<title>Parameters</title>
+					<listitem><para>&lt;Integer&gt;: Bug ID</para></listitem>
+					<listitem><para>&lt;Integer&gt;: Bugnote ID</para></listitem>
+					<listitem><para>&lt;Boolean&gt;: Private bugnote (false if public)</para></listitem>
+				</itemizedlist>
+			</blockquote>
+		</blockquote>
+
+		<blockquote id="dev.eventref.bug.noteview.end">
+			<title>EVENT_VIEW_BUGNOTES_END (Execute)</title>
+
+			<blockquote>
+				<para>
+					This event allows a plugin to either process information or display some
+					data in the bug notes section, after all bugnotes have been displayed.
+				</para>
+
+				<para>
+					Any output here should be defining appropriate rows and columns for the
+					surrounding <programlisting>&lt;table&gt;</programlisting> elements.
+				</para>
+
+				<itemizedlist>
+					<title>Parameters</title>
+					<listitem><para>&lt;Integer&gt;: Bug ID</para></listitem>
+				</itemizedlist>
+			</blockquote>
+		</blockquote>
+
+	</sect2>
 
-	<para></para>
 </sect1>