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/center

@@ -0,0 +1,24 @@
+Synopsis:
+   $center(<width> <text>)
+
+Technical:
+   This function returns the input text right-justified in a buffer that is
+   precisely ( ((width - strlen(text)) / 2) + strlen(text) ) characters
+   wide.  The width must be given, there is no default.
+
+Practical:
+   This function returns the given text, padded on the left such that it
+   will appear to be "centered" in the width given.  The right side is not
+   padded, only the left.  To force padding on both sides, you must use the
+   width qualifier $[]var.
+
+Returns:
+   input text centered in given width
+
+Examples:
+   $center(15 hello there)               returns "  hello there"
+   $[15]center(15 hello there)           returns "  hello there  "
+
+See Also:
+   Special_Vars(7)
+