From 49620728e805a3bbc3477c14b8b6ef7e2b5d3ead Mon Sep 17 00:00:00 2001 From: "Kartik K. Agaram" Date: Mon, 12 Dec 2016 10:01:12 -0800 Subject: 3707 Be more disciplined about tagging 2 different concepts in the codebase: a) Use the phrase "later layers" to highlight places where a layer doesn't have the simplest possible self-contained implementation. b) Use the word "hook" to point out functions that exist purely to provide waypoints for extension by future layers. Since both these only make sense in the pre-tangled representation of the codebase, using '//:' and '#:' comments to get them stripped out of tangled output. (Though '#:' comments still make it to tangled output at the moment. Let's see if we use it enough to be worth supporting. Scenarios are pretty unreadable in tangled output anyway.) --- html/044space_surround.cc.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'html/044space_surround.cc.html') diff --git a/html/044space_surround.cc.html b/html/044space_surround.cc.html index 6ea1ccca..dfa5bc11 100644 --- a/html/044space_surround.cc.html +++ b/html/044space_surround.cc.html @@ -50,7 +50,8 @@ body { font-size: 12pt; font-family: monospace; color: #eeeeee; background-color 21:num <- copy 5 # length # actual start of this recipe default-space:space <- copy 10/unsafe - 0:space/names:dummy <- copy 20/unsafe # later layers will explain the /names: property + #: later layers will explain the /names: property + 0:space/names:dummy <- copy 20/unsafe 1:num <- copy 32 1:num/space:1 <- copy 33 ] -- cgit 1.4.1-2-gfad0