* Take a document on compatibility from the Haiku website (experimenting with pages) - Originally written by Ingo and updated by others, I have permission from Ingo.

* book.dox Rework a bit of the structure
* midi2/support Separate the overview (or Introduction) from the list of elements in a module.
* support Wrote initial documentation for Beep/BufferIO/DataIO
* Stub for article on archiving.

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@20307 a95241bf-73f2-0310-859d-f6bbb57e9c96

docs/user/midi2/midi2intro.dox

@@ -1,16 +1,12 @@
 /*!
-\ingroup midi2
-*/
-
-/*\{*/
-
-/*!
-\page midi2intro
+\page midi2_intro Introduction to the MIDI2 Kit
 
 The Midi Kit is the API that implements support for generating, processing, and 
 playing music in MIDI format. <A HREF="http://www.midi.org/">MIDI</A>, which 
 stands for 'Musical Instrument Digital Interface', is a well-established 
-standard for representing and communicating musical data. 
+standard for representing and communicating musical data. This document serves
+as an overview. If you would like to see all the components, please look at
+\link midi2 the list with classes \endlink .
 
 \section midi2twokits The two kits
 
@@ -273,7 +269,7 @@ event as quickly as possible and be done with it. Do not
 
 \section midi2apidiffs API differences
 
-As far as the end user is concerned, the OpenBeOS Midi Kit is mostly the same 
+As far as the end user is concerned, the Haiku Midi Kit is mostly the same 
 as the BeOS R5 kits, although there are a few small differences in the API 
 (mostly bug fixes):
 
@@ -308,4 +304,9 @@ Information about MIDI in general:
 
 */
 
-/*\}*/
+/*!
+\addtogroup midi2
+
+Please have a look at the \link midi2_intro introduction \endlink for a more
+comprehensive overview on how everything ties together.
+*/

docs/user/midi2/midiendpoint.dox

@@ -1,5 +1,5 @@
 /*!
-\class BMidiEndpoint MidiEndpoint.h
+\class BMidiEndpoint
 \ingroup midi2
 \ingroup libmidi2
 \brief Base class for all MIDI endpoints

docs/user/midi2/midiroster.dox

@@ -1,3 +1,9 @@
+/*!
+\var B_MIDI_EVENT
+\ingroup midi2
+\brief BMessage identifier of MIDI messages.
+*/
+
 /*!
 \class BMidiRoster MidiRoster.h
 \ingroup midi2