Initial import of the ircii-pana-1.1-final source tree.

git-svn-id: svn://svn.code.sf.net/p/bitchx/code/tags/ircii-pana-1.1-final@1 13b04d17-f746-0410-82c6-800466cd88b0

bitchx-docs/6_Functions/convert

@@ -0,0 +1,23 @@
+Synopsis:
+   $convert(<ip address|hostname>)
+
+Technical:
+   This function does a DNS lookup on the given address.  For an IP address,
+   it attempts to find the corresponding Internet hostname.  For a hostname,
+   it attempts to find the corresponding IP address.
+
+Practical:
+   This function does effectively the same thing as $iptoname() and
+   $nametoip().  It is mostly useful when you want to convert an address,
+   but you aren't sure if the input will be an IP address or not.
+
+Returns:
+   IP address or hostname corresponding to input, or nothing on error
+
+Examples:
+   $convert(some.school.edu)       returns IP address for "some.school.edu"
+   $convert(192.168.1.1)           returns hostname for "192.168.1.1"
+
+See Also:
+   iptoname(6); nametoip(6)
+