document iface.h to ease porting

git-svn-id: file:///home/lennart/svn/public/avahi/trunk@1288 941a03a8-eaeb-0310-b9a0-b1bbd8fe43fe

diff --git a/avahi-autoipd/iface.h b/avahi-autoipd/iface.h
index 4480c97554ff0ae6d41b54c233480e12603139a0..017c90d328012c5a042ee4a2c816b26659ea6e5c 100644 (file)
--- a/avahi-autoipd/iface.h
+++ b/avahi-autoipd/iface.h
@@ -26,10 +26,22 @@
 
 #include "main.h"
 
+/* Subscribe to network configuration changes. The only events we are
+ * interested in are when routable addresses are removed/added to the
+ * monitored interface and when our monitored interface disappears. */
+
+
+/* Return a valid fd that we listen on for events */
 int iface_init(int ifindex);
+
+/* Process events */
 int iface_process(Event *event);
 void iface_done(void);
 
+/* Deduce the initial state of our state machine. If a routable
+ * address is configured for the interface, *state should be set to
+ * STATE_SLEEPING., otherwide STATE_START */
+
 int iface_get_initial_state(State *state);
 
 #endif