diff --git a/docs/user/midi/midi1intro.dox b/docs/user/midi/midi1intro.dox
index 27abe15650..1719629ffb 100644
--- a/docs/user/midi/midi1intro.dox
+++ b/docs/user/midi/midi1intro.dox
@@ -28,7 +28,7 @@ The following classes let you use the Midi Kit's General MIDI synthesizer:
 
 - BSynth controls the synthesizer
 - BMidiSynth connects a BMidi object to the synth
-- BMidiSynthFile  connects a MIDI file to the synth
+- BMidiSynthFile connects a MIDI file to the synth
 - BSamples lets you access the synth's sound data stream
 
 To make MIDI data stream through your application, you create a "network" of 
@@ -39,4 +39,10 @@ The old Midi Kit is slowly fading into obscurity. You may want to use the
 of the kit sometimes behaves differently than the one from BeOS R5 or what
 the BeBook says, but usually for the better ;-)
 
+Especially the synth classes are not completely functional, but enough to
+play back General MIDI tunes. They should be backwards compatible with the
+majority of BeOS MIDI applications. Not all methods of BSynth, BMidiSynth,
+and BMidiSynthFile are implemented because some of them are rather obscure. 
+BSamples is a complete no-op; in other words, with the OpenBeOS Midi Kit 
+you cannot push waveform data into the output stream of the softsynth.
 */