about summary refs log tree commit diff stats
path: root/031merge.cc
diff options
context:
space:
mode:
authorKartik K. Agaram <vc@akkartik.com>2016-12-12 10:01:12 -0800
committerKartik K. Agaram <vc@akkartik.com>2016-12-12 10:07:59 -0800
commit49620728e805a3bbc3477c14b8b6ef7e2b5d3ead (patch)
treec80ecf970ec78dfc0c40944a4b9e827c0eb77078 /031merge.cc
parentd81fcff20567a1d5e793e813bc761222885660b1 (diff)
downloadmu-49620728e805a3bbc3477c14b8b6ef7e2b5d3ead.tar.gz
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.)
Diffstat (limited to '031merge.cc')
-rw-r--r--031merge.cc4
1 files changed, 2 insertions, 2 deletions
diff --git a/031merge.cc b/031merge.cc
index 14999123..3faee8d8 100644
--- a/031merge.cc
+++ b/031merge.cc
@@ -209,8 +209,8 @@ void check_merge_call(const vector<reagent>& ingredients, const reagent& product
   assert(false);
 }
 
-// replaced in a later layer
-// todo: find some clean way to take this call completely out of this layer
+//: replaced in a later layer
+//: todo: find some clean way to take this call completely out of this layer
 const type_tree* get_base_type(const type_tree* t) {
   return t;
 }