From c1d09e6d576b6f6bb1245af6e0b9b166c5f69b2f Mon Sep 17 00:00:00 2001 From: Sebastian Thiel Date: Sun, 22 Mar 2015 09:32:08 +0100 Subject: [PATCH] docs(lib): minor phrasing changes Also removed superfluous 'extern' for tests --- src/mako/lib/lib.mako | 8 ++++---- src/mako/lib/util.mako | 1 - 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/src/mako/lib/lib.mako b/src/mako/lib/lib.mako index 8e595925c9..e9c192f766 100644 --- a/src/mako/lib/lib.mako +++ b/src/mako/lib/lib.mako @@ -186,7 +186,7 @@ ${link('Hub Delegate', delegate_url)}, or the ${link('Authenticator Delegate', u When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. -${'##'} About Uploads and Downlods +${'##'} Uploads and Downlods If a method supports downloads, the response body, which is part of the ${link('Result', 'enum.Result.html')}, should be read by you to obtain the media. If such a method also supports a ${link('Response Result', 'trait.ResponseResult.html')}, it will return that by default. @@ -197,7 +197,7 @@ Methods supporting uploads can do so using up to ${len(PROTOCOL_TYPE_INFO)} diff ${put_and(md_italic(PROTOCOL_TYPE_INFO.keys()))}. The distinctiveness of each is represented by customized `${api.terms.action}(...)` methods, which are then named ${put_and(enclose_in('`', ("%s(...)" % upload_action_fn(api.terms.upload_action, v['suffix']) for v in PROTOCOL_TYPE_INFO.values())))} respectively. -${'##'} About Customization/Callbacks +${'##'} Customization and Callbacks You may alter the way an `${api.terms.action}()` method is called by providing a ${link('delegate', delegate_url)} to the ${link('Method Builder', method_builder_url)} before making the final `${api.terms.action}()` call. @@ -206,14 +206,14 @@ retry on failure. The ${link('delegate trait', delegate_url)} is default-implemented, allowing you to customize it with minimal effort. -${'##'} About Parts +${'##'} Optional Parts in Server-Requests All structures provided by this library are made to be ${link('enocodable', request_trait_url)} and ${link('decodable', response_trait_url)} via json. Optionals are used to indicate that partial requests are responses are valid. Most optionals are are considered ${link('Parts', part_trait_url)} which are identifyable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. -${'##'} About Builder Arguments +${'##'} Builder Arguments Using ${link('method builders', method_builder_url)}, you are able to prepare an action call by repeatedly calling it's methods. These will always take a single argument, for which the following statements are true. diff --git a/src/mako/lib/util.mako b/src/mako/lib/util.mako index 464c8da0e9..e4273b1ad0 100644 --- a/src/mako/lib/util.mako +++ b/src/mako/lib/util.mako @@ -32,7 +32,6 @@ ${util.library_to_crate_name(util.library_name(name, version))}\ <%def name="test_prelude()">\ extern crate hyper; extern crate "yup-oauth2" as oauth2; -extern crate serde; extern crate "${self.crate_name()}" as ${self.library_name()};