--- a/doc/api.mdwn	Fri Nov 16 11:22:01 2007 -0500
+++ b/doc/api.mdwn	Fri Nov 16 11:26:01 2007 -0500
@@ -7,3 +7,8 @@
 	* [[modules/luaevent.core.buffer]] - Interface to libevent's evbuffer
 	* [[modules/luaevent.core.bufferevent]] - Interface to libevent's bufferevent
 * [[modules/luaevent]] - Higher level wrapper mimicking [copas](http://www.luaforge.net/projects/copas)
+
+Note: Any reference to a "File Descriptor" may in fact be one of the following:
+* Integer value of file descriptor
+* lightuserdata 'handle' (cast to a native integer)
+* [LuaSocket](http://www.luaforge.net/projects/luasocket)-based socket handle
\ No newline at end of file