summaryrefslogtreecommitdiffstats
path: root/tcllib/modules/textutil/repeat.man
diff options
context:
space:
mode:
authorWilliam Joye <wjoye@cfa.harvard.edu>2016-10-27 19:39:39 (GMT)
committerWilliam Joye <wjoye@cfa.harvard.edu>2016-10-27 19:39:39 (GMT)
commitea28451286d3ea4a772fa174483f9a7a66bb1ab3 (patch)
tree6ee9d8a7848333a7ceeee3b13d492e40225f8b86 /tcllib/modules/textutil/repeat.man
parentb5ca09bae0d6a1edce939eea03594dd56383f2c8 (diff)
parent7c621da28f07e449ad90c387344f07a453927569 (diff)
downloadblt-ea28451286d3ea4a772fa174483f9a7a66bb1ab3.zip
blt-ea28451286d3ea4a772fa174483f9a7a66bb1ab3.tar.gz
blt-ea28451286d3ea4a772fa174483f9a7a66bb1ab3.tar.bz2
Merge commit '7c621da28f07e449ad90c387344f07a453927569' as 'tcllib'
Diffstat (limited to 'tcllib/modules/textutil/repeat.man')
-rw-r--r--tcllib/modules/textutil/repeat.man46
1 files changed, 46 insertions, 0 deletions
diff --git a/tcllib/modules/textutil/repeat.man b/tcllib/modules/textutil/repeat.man
new file mode 100644
index 0000000..06e23d6
--- /dev/null
+++ b/tcllib/modules/textutil/repeat.man
@@ -0,0 +1,46 @@
+[manpage_begin textutil::repeat n 0.7.1]
+[see_also regexp(n)]
+[see_also split(n)]
+[see_also string(n)]
+[keywords blanks]
+[keywords repetition]
+[keywords string]
+[moddesc {Text and string utilities, macro processing}]
+[titledesc {Procedures to repeat strings.}]
+[category {Text processing}]
+[require Tcl 8.2]
+[require textutil::repeat [opt 0.7]]
+[description]
+
+The package [package textutil::repeat] provides commands to generate
+long strings by repeating a shorter string many times.
+
+[para]
+
+The complete set of procedures is described below.
+
+[list_begin definitions]
+
+[call [cmd ::textutil::repeat::strRepeat] [arg text] [arg num]]
+
+This command returns a string containing the [arg text] repeated
+[arg num] times. The repetitions are joined without characters between
+them. A value of [arg num] <= 0 causes the command to return an empty
+string.
+
+[para]
+
+[emph Note]: If the Tcl core the package is loaded in provides the
+command [cmd {string repeat}] then this command will be implemented in
+its terms, for maximum possible speed. Otherwise a fast implementation
+in Tcl will be used.
+
+[call [cmd ::textutil::repeat::blank] [arg num]]
+
+A convenience command. Returns a string of [arg num] spaces.
+
+[list_end]
+
+[vset CATEGORY textutil]
+[include ../doctools2base/include/feedback.inc]
+[manpage_end]