From 989d8514977f79bf8caf55550776e699edbc5110 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Tue, 31 Jul 2012 07:18:29 -0600 Subject: [PATCH] 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 --- collects/scribblings/scribble/sigplan.scrbl | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/collects/scribblings/scribble/sigplan.scrbl b/collects/scribblings/scribble/sigplan.scrbl index 522e3572..6ce80f15 100644 --- 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.}