doc: update Smalltalk namespace
Project: http://git-wip-us.apache.org/repos/asf/thrift/repo Commit: http://git-wip-us.apache.org/repos/asf/thrift/commit/17aa4749 Tree: http://git-wip-us.apache.org/repos/asf/thrift/tree/17aa4749 Diff: http://git-wip-us.apache.org/repos/asf/thrift/diff/17aa4749 Branch: refs/heads/master Commit: 17aa474938b6ffab6a7a2b328f6aa1a2b3a431be Parents: e0ab13f Author: Roger Meier <[email protected]> Authored: Mon Feb 9 12:09:19 2015 +0100 Committer: Roger Meier <[email protected]> Committed: Mon Feb 9 12:09:19 2015 +0100 ---------------------------------------------------------------------- doc/specs/idl.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/thrift/blob/17aa4749/doc/specs/idl.md ---------------------------------------------------------------------- diff --git a/doc/specs/idl.md b/doc/specs/idl.md index 5b8db20..6da4696 100644 --- a/doc/specs/idl.md +++ b/doc/specs/idl.md @@ -43,8 +43,20 @@ A namespace declares which namespaces/package/module/etc. the type definitions i [6] NamespaceScope ::= '*' | 'cpp' | 'java' | 'py' | 'perl' | 'rb' | 'cocoa' | 'csharp' -N.B.: Smalltalk has two distinct types of namespace commands. -*Can someone who knows Smalltalk explain why Smalltalk needs two different kinds of namespaces?* +N.B.: Smalltalk has two distinct types of namespace commands: + +- smalltalk.prefix: Prepended to generated classnames. + - Smalltalk does not have namespaces for classes, so prefixes + are used to avoid class-name collisions. + Often, the prefix is the author's initials, like "KB" or "JWS", + or an abbreviation of the package name, like "MC" for "Monticello". +- smalltalk.category: Determines the category for generated classes. + Any dots in the identifier will be replaced with hyphens when generating + the category name. + If not provided, defaults to "Generated-" + the program name. + Methods will not be categorized beyond "as yet uncategorized". + - Smalltalk allows filing both classes and methods within classes into named + groups. These named groups of methods are called categories. N.B.: The `php_namespace` directive will be deprecated at some point in the future in favor of the scoped syntax, but the scoped syntax is not yet supported for PHP.
