From 552996f1b7a029e4b98936d5bbc0c8aa8c4d6975 Mon Sep 17 00:00:00 2001 From: Matthias Felleisen Date: Fri, 16 Sep 2011 15:29:32 -0400 Subject: [PATCH] [Style] explain comments in document --- collects/scribblings/style/constructs.scrbl | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/collects/scribblings/style/constructs.scrbl b/collects/scribblings/style/constructs.scrbl index e0a82992a9..bbf480794a 100644 --- a/collects/scribblings/style/constructs.scrbl +++ b/collects/scribblings/style/constructs.scrbl @@ -14,7 +14,10 @@ and readability. Following Lisp and Scheme tradition, we use a single semicolon for in-line comments (to the end of a line) and two semicolons for comments that start -a line. Think of the second semicolon as making an emphatic point. +a line. @margin-note*{This request does not contradict the programs in this +document. They use two semicolons for full-line comments in source but +scribble renders only one.} Think of the second semicolon as making an +emphatic point. Seasoned Schemers, not necessarily Racketeers, also use triple and quadruple semicolons. This is considered a courtesy to distinguish file