commit 989d8514977f79bf8caf55550776e699edbc5110
parent e285bfb53b56cf0bc88d0ec8d8c3c964a4bc8450
Author: Matthew Flatt <mflatt@racket-lang.org>
Date: Tue, 31 Jul 2012 07:18:29 -0600
scribble/sigplan: add guidance for `category', etc.
Include the URL to ACM's explanation of how to use categories,
and add some other formatting guidance that is otherwise
difficult to track down.
original commit: aa5b1e192c5d38ada197a488f9817ed7ad9df861
Diffstat:
1 file changed, 17 insertions(+), 1 deletion(-)
diff --git a/collects/scribblings/scribble/sigplan.scrbl b/collects/scribblings/scribble/sigplan.scrbl
@@ -114,4 +114,20 @@ Declares information that is collected into the copyright region of the paper.}
)]{
Typesets category, term, and keyword information for the paper, which
-is normally placed immediately after an @racket[abstract] form.}
+is normally placed immediately after an @racket[abstract] form.
+See also @url["http://www.acm.org/about/class/how-to-use"].
+
+For @racket[category], the @racket[subcategory] argument should be in
+titlecase (i.e., capitalize the first letter of each word) and a
+phrase at the level of ``Programming Languages'' or ``Software
+Engineering'' (as opposed to a category like ``Software'' or a
+third-level name like ``Concurrent Programming'' or ``Processors''). A
+@racket[third-level] phrase should be in titlecase. A
+@racket[fourth-level] phrase, if any, should not be capitalized.
+
+For @racket[terms], each general term should be in titlecase. Terms
+are usually drawn from a fixed list, and they are usually optional.
+
+For @racket[keywords], capitalize only the first letter of the first
+word, separate phrases by commas, and do not include ``and'' before
+the last one. Keywords should be noun phrases, not adjectives.}
