diff options
author | Roger Meier <r.meier@siemens.com> | 2015-02-09 12:09:19 +0100 |
---|---|---|
committer | Roger Meier <r.meier@siemens.com> | 2015-02-09 12:09:19 +0100 |
commit | 17aa474938b6ffab6a7a2b328f6aa1a2b3a431be (patch) | |
tree | b48cbf76f841b9d92f365ca1710a292475d15fc5 /doc/specs | |
parent | e0ab13f63a5946ca4e98f3b5923ff15d9fca8c0f (diff) | |
download | thrift-17aa474938b6ffab6a7a2b328f6aa1a2b3a431be.tar.gz |
doc: update Smalltalk namespace
Diffstat (limited to 'doc/specs')
-rw-r--r-- | doc/specs/idl.md | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/doc/specs/idl.md b/doc/specs/idl.md index 5b8db20b2..6da469665 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. |