From e5aa02571f87e3f200724d916518fb636944dc63 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Thu, 25 Feb 2010 05:57:09 +1300 Subject: [PATCH] sequences: add suffix! to destructive sequence ops article --- core/sequences/sequences-docs.factor | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/core/sequences/sequences-docs.factor b/core/sequences/sequences-docs.factor index dc26933af4..46b4dcd4ec 100644 --- a/core/sequences/sequences-docs.factor +++ b/core/sequences/sequences-docs.factor @@ -1617,8 +1617,8 @@ ARTICLE: "sequences-destructive-discussion" "When to use destructive operations" } "The second reason is much weaker than the first one. In particular, many combinators (see " { $link map } ", " { $link produce } " and " { $link "namespaces-make" } ") as well as more advanced data structures (such as " { $vocab-link "persistent.vectors" } ") alleviate the need for explicit use of side effects." ; -ARTICLE: "sequences-destructive" "Destructive operations" -"Many operations have constructive and destructive variants:" +ARTICLE: "sequences-destructive" "Destructive sequence operations" +"Many operations have destructive variants that side effect an input sequence, instead of creating a new sequence:" { $table { "Constructive" "Destructive" } { { $link suffix } { $link suffix! } } @@ -1641,10 +1641,14 @@ ARTICLE: "sequences-destructive" "Destructive operations" delete-all filter! } +"Adding elements:" +{ $subsections + suffix! + append! +} "Other destructive words:" { $subsections reverse! - append! move exchange copy