# HG changeset patch # User Steve Losh # Date 1506386841 14400 # Node ID 0cf1ef232b1c7fb25402bcbfdb2b46b856334957 # Parent 126034bff1da31e7d291cdad5f1d835b351b0781 Docs diff -r 126034bff1da -r 0cf1ef232b1c DOCUMENTATION.markdown --- a/DOCUMENTATION.markdown Mon Sep 25 20:47:10 2017 -0400 +++ b/DOCUMENTATION.markdown Mon Sep 25 20:47:21 2017 -0400 @@ -472,6 +472,30 @@ +### `NEST` (macro) + + (NEST &REST FORMS) + +Thread the given forms, putting each as the body of the previous. + + Example: + + (nest (multiple-value-bind (a b c) (foo)) + (when (and a b c)) + (multiple-value-bind (d e f) (bar)) + (when (and d e f)) + (do-something)) + + macroexpands to: + + (multiple-value-bind (a b c) (foo) + (when (and a b c) + (multiple-value-bind (d e f) (bar) + (when (and d e f) + (do-something))))) + + + ### `WHEN-FOUND` (macro) (WHEN-FOUND (VAR LOOKUP-EXPR)