debian/control: Add Build-Depends for `dh-python'.

[mLib-python] / str.pyx

diff --git a/str.pyx b/str.pyx
index bbde1b0a2af01d0d1dca22f0ce89b2e43d66b1b0..f1a2ee5b5659080c29f3587d9501203f8002996c 100644 (file)
--- a/str.pyx
+++ b/str.pyx
@@ -1,31 +1,30 @@
-# -*-pyrex-*-
-#
-# $Id$
-#
-# String utilities
-#
-# (c) 2006 Straylight/Edgeware
-#
+### -*-pyrex-*-
+###
+### String utilities
+###
+### (c) 2006 Straylight/Edgeware
+###
 
-#----- Licensing notice -----------------------------------------------------
-#
-# This file is part of the Python interface to mLib.
-#
-# mLib/Python is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-# 
-# mLib/Python is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-# 
-# You should have received a copy of the GNU General Public License
-# along with mLib/Python; if not, write to the Free Software Foundation,
-# Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+###----- Licensing notice ---------------------------------------------------
+###
+### This file is part of the Python interface to mLib.
+###
+### mLib/Python is free software; you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation; either version 2 of the License, or
+### (at your option) any later version.
+###
+### mLib/Python is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with mLib/Python; if not, write to the Free Software Foundation,
+### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 def word(char *p, quotep = False):
+  """word(STR, [quotep = False]) -> WORD, REST"""
   cdef unsigned f
   cdef char *op
   cdef char *pp
@@ -50,6 +49,7 @@ def word(char *p, quotep = False):
   return w, r
 
 def split(char *p, int n = -1, quotep = False):
+  """split(STR, [n = -1], [quotep = False]) -> WORDS, REST"""
   cdef unsigned f
   cdef char *op
   cdef char *pp
@@ -77,12 +77,16 @@ def split(char *p, int n = -1, quotep = False):
   return l, r
 
 def match(char *p, char *s, prefixp = False):
+  """match(PAT, STR, [prefixp = False]) -> BOOL"""
   cdef unsigned f
+
+  f = 0
   if prefixp:
     f = f | STRF_PREFIX
   return _tobool(str_matchx(p, s, f))
 
 def sanitize(char *p, int n = -1):
+  """sanitize(STR, [n = -1]) -> STR"""
   cdef char *buf
   cdef object d
 
@@ -95,6 +99,7 @@ def sanitize(char *p, int n = -1):
   return d
 
 def versioncmp(char *va, char *vb):
+  """versioncmp(V0, V1) -> -1 | 0 | +1"""
   return _versioncmp(va, vb)
 
-#----- That's all, folks ----------------------------------------------------
+###----- That's all, folks --------------------------------------------------