public
Description: Ruby on Rails
Homepage: http://rubyonrails.org
Clone URL: git://github.com/rails/rails.git
Fix docs (closes #2679) [coffee2code]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@2909 
5ecf4fe2-1ee6-0310-87b1-e25e094e27de
dhh (author)
Mon Nov 07 01:52:56 -0800 2005
commit  ea5bd8e75664e3d6e3c4bf51ba033f67ce9069f0
tree    695d01c12d23bd9125f0269b6a5cc0d6a04db0c7
parent  6ab9f2bb407194ada0973301d55525ad79e1ff78
...
21
22
23
24
 
25
26
27
28
29
30
31
 
32
33
34
...
222
223
224
225
 
226
227
228
229
230
 
231
232
233
...
334
335
336
337
 
338
339
340
...
21
22
23
 
24
25
26
27
28
29
30
 
31
32
33
34
...
222
223
224
 
225
226
227
228
229
 
230
231
232
233
...
334
335
336
 
337
338
339
340
0
@@ -21,14 +21,14 @@ You specify the methods you want to make available as API methods in an
0
 ActionWebService::API::Base derivative, and then specify this API
0
 definition class wherever you want to use that API.
0
 
0
-The implementation of the methods is done seperately to the API
0
+The implementation of the methods is done separately from the API
0
 specification.
0
 
0
 
0
 ==== Method name inflection
0
 
0
 Action Web Service will camelcase the method names according to Rails Inflector
0
-rules for the API visible to public callers. What this means, for example
0
+rules for the API visible to public callers. What this means, for example,
0
 is that the method names in generated WSDL will be camelcased, and callers will
0
 have to supply the camelcased name in their requests for the request to
0
 succeed.
0
@@ -222,12 +222,12 @@ If you're going to be sending back strings containing non-ASCII UTF-8
0
 characters using the <tt>:string</tt> data type, you need to make sure that
0
 Ruby is using UTF-8 as the default encoding for its strings.
0
 
0
-The default in Ruby to use US-ASCII encoding for strings, which causes a string
0
+The default in Ruby is to use US-ASCII encoding for strings, which causes a string
0
 validation check in the Ruby SOAP library to fail and your string to be sent
0
 back as a Base-64 value, which may confuse clients that expected strings
0
 because of the WSDL.
0
 
0
-Two ways of doing setting the default string encoding are:
0
+Two ways of setting the default string encoding are:
0
 
0
 * Start Ruby using the <tt>-Ku</tt> command-line option to the Ruby executable
0
 * Set the <tt>$KCODE</tt> flag in <tt>config/environment.rb</tt> to the
0
@@ -334,7 +334,7 @@ Action Web Service requires that the Action Pack and Active Record are either
0
 available to be required immediately or are accessible as GEMs.
0
 
0
 It also requires a version of Ruby that includes SOAP support in the standard
0
-library. At least version 1.8.2 final (2004-12-25) of Ruby is recommended, this
0
+library. At least version 1.8.2 final (2004-12-25) of Ruby is recommended; this
0
 is the version tested against.
0
 
0
 
...
4
5
6
7
 
8
9
10
...
4
5
6
 
7
8
9
10
0
@@ -4,7 +4,7 @@ require 'ftools'
0
 
0
 include Config
0
 
0
-# this was adapted from rdoc's install.rb by ways of Log4r
0
+# this was adapted from rdoc's install.rb by way of Log4r
0
 
0
 $sitedir = CONFIG["sitelibdir"]
0
 unless $sitedir
...
18
19
20
21
 
22
23
24
...
43
44
45
46
 
47
48
49
...
18
19
20
 
21
22
23
24
...
43
44
45
 
46
47
48
49
0
@@ -18,7 +18,7 @@ module ActionWebService # :nodoc:
0
       class_inheritable_option :inflect_names, true
0
 
0
       # Whether to allow ActiveRecord::Base models in <tt>:expects</tt>.
0
- # The default is +false+, you should be aware of the security implications
0
+ # The default is +false+; you should be aware of the security implications
0
       # of allowing this, and ensure that you don't allow remote callers to
0
       # easily overwrite data they should not have access to.
0
       class_inheritable_option :allow_active_record_expects, false
0
@@ -43,7 +43,7 @@ module ActionWebService # :nodoc:
0
         # A signature is an array of one or more parameter specifiers.
0
         # A parameter specifier can be one of the following:
0
         #
0
- # * A symbol or string of representing one of the Action Web Service base types.
0
+ # * A symbol or string representing one of the Action Web Service base types.
0
         # See ActionWebService::SignatureTypes for a canonical list of the base types.
0
         # * The Class object of the parameter type
0
         # * A single-element Array containing one of the two preceding items. This
...
25
26
27
28
29
 
 
30
31
32
33
 
 
34
35
36
...
25
26
27
 
 
28
29
30
31
 
 
32
33
34
35
36
0
@@ -25,12 +25,12 @@ module ActionWebService # :nodoc:
0
         # now exist on the controller, and calling it will return the
0
         # XML-RPC client object for working with that remote service.
0
         #
0
- # +options+ is the set of protocol client specific options,
0
- # see a protocol client class for details.
0
+ # +options+ is the set of protocol client specific options (see
0
+ # a protocol client class for details).
0
         #
0
         # If your API definition does not exist on the load path with the
0
- # correct rules for it to be found using +name+, you can pass through
0
- # the API definition class in +options+, using a key of <tt>:api</tt>
0
+ # correct rules for it to be found using +name+, you can pass in
0
+ # the API definition class via +options+, using a key of <tt>:api</tt>
0
         def web_client_api(name, protocol, endpoint_uri, options={})
0
           unless method_defined?(name)
0
             api_klass = options.delete(:api) || require_web_service_api(name)
...
11
12
13
14
 
15
16
17
...
11
12
13
 
14
15
16
17
0
@@ -11,7 +11,7 @@ module ActionWebService # :nodoc:
0
       end
0
   
0
       module ClassMethods
0
- # Declares a web service that will provides access to the API of the given
0
+ # Declares a web service that will provide access to the API of the given
0
         # +object+. +object+ must be an ActionWebService::Base derivative.
0
         #
0
         # Web service object creation can either be _immediate_, where the object

Comments

    No one has commented yet.