From b07cf17d9c57bb355e84b17470235902854c7d40 Mon Sep 17 00:00:00 2001 From: dkf Date: Wed, 17 Mar 2004 00:57:19 +0000 Subject: Slightly better docs for [lsearch]'s advanced capabilities --- ChangeLog | 6 ++++++ doc/lsearch.n | 11 ++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 3decacb..d94112d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2004-03-17 Donal K. Fellows + + * doc/lsearch.n: Improved examples on the advanced capabilities of + lsearch (with the right options, set element removal can be done) + following discussion on tkchat. + 2004-03-16 Don Porter * doc/catch.n: Compiled [catch] no longer fails to catch syntax diff --git a/doc/lsearch.n b/doc/lsearch.n index b2129aa..74e8451 100644 --- a/doc/lsearch.n +++ b/doc/lsearch.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: lsearch.n,v 1.15 2003/10/14 13:38:57 dkf Exp $ +'\" RCS: @(#) $Id: lsearch.n,v 1.16 2004/03/17 00:57:20 dkf Exp $ '\" .so man.macros .TH lsearch n 8.5 Tcl "Tcl Built-In Commands" @@ -124,11 +124,20 @@ precedence. .CS lsearch {a b c d e} c => 2 lsearch -all {a b c a b c} c => 2 5 + +\fI# Filtering examples\fR lsearch -inline {a20 b35 c47} b* => b35 lsearch -inline -not {a20 b35 c47} b* => a20 lsearch -all -inline -not {a20 b35 c47} b* => a20 c47 lsearch -all -not {a20 b35 c47} b* => 0 2 +\fI# Simple set removal\fR +lsearch -all -inline -not -exact {a b c a d e a f g a} a + => b c d e f g + +\fI# Non-start based searches\fR lsearch -start 3 {a b c a b c} c => 5 + +\fI# Searching inside elements\fR lsearch -index 1 -all {{a abc} {b bcd} {c cde}} *bc* => {a abc} {b bcd} .CE -- cgit v0.12