You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by bu...@apache.org on 2015/02/09 12:11:16 UTC
svn commit: r939539 - in /websites/staging/thrift/trunk/content: ./
docs/idl.html
Author: buildbot
Date: Mon Feb 9 11:11:16 2015
New Revision: 939539
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/docs/idl.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Feb 9 11:11:16 2015
@@ -1 +1 @@
-1658359
+1658360
Modified: websites/staging/thrift/trunk/content/docs/idl.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/idl.html (original)
+++ websites/staging/thrift/trunk/content/docs/idl.html Mon Feb 9 11:11:16 2015
@@ -73,11 +73,7 @@
</div>
<div class="container">
- <hr />
-<p>title: "Interface Description Language (IDL)"
-kind: doc</p>
-<hr />
-<h2 id="thrift-interface-description-language">Thrift interface description language</h2>
+ <h2 id="thrift-interface-description-language">Thrift interface description language</h2>
<p>The Thrift interface definition language (IDL) allows for the definition of <a href="/docs/types">Thrift Types</a>. A Thrift IDL file is processed by the Thrift code generator to produce code for the various target languages to support the defined structs and services in the IDL file.</p>
<h2 id="description">Description</h2>
<p><em>Under construction</em></p>
@@ -118,8 +114,21 @@ kind: doc</p>
</pre></div>
-<p>N.B.: Smalltalk has two distinct types of namespace commands.
-<em>Can someone who knows Smalltalk explain why Smalltalk needs two different kinds of namespaces?</em></p>
+<p>N.B.: Smalltalk has two distinct types of namespace commands:</p>
+<ul>
+<li>smalltalk.prefix: Prepended to generated classnames.</li>
+<li>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".</li>
+<li>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".</li>
+<li>Smalltalk allows filing both classes and methods within classes into named
+ groups. These named groups of methods are called categories.</li>
+</ul>
<p>N.B.: The <code>php_namespace</code> 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.</p>
<p>N.B.: The <code>xsd_namespace</code> directive has some purpose internal to Facebook but serves no purpose in Thrift itself. Use of this feature is strongly discouraged</p>
<h2 id="definition">Definition</h2>