-/*******************************************************************
-convert a string to an IP address. The string can be a name or
-dotted decimal number
- ******************************************************************/
+/**
+ Convert a string to an IP address. The string can be a name or
+ dotted decimal number.
+
+ Returns a pointer to a static in_addr struct -- if you call this
+ more than once then you should copy it.
+*/