fix(docs): place doc comment above the last overload

src/iam.ts

@@ -177,6 +177,9 @@ export class IAM {
     this.id = id;
   }
 
+  getPolicy(gaxOpts?: CallOptions): Promise<GetPolicyCallback>;
+  getPolicy(callback: GetPolicyCallback): void;
+  getPolicy(gaxOpts: CallOptions, callback: GetPolicyCallback): void;
   /**
    * Get the IAM policy
    *
@@ -207,9 +210,6 @@ export class IAM {
    *   const apiResponse = data[1];
    * });
    */
-  getPolicy(gaxOpts?: CallOptions): Promise<GetPolicyCallback>;
-  getPolicy(callback: GetPolicyCallback): void;
-  getPolicy(gaxOpts: CallOptions, callback: GetPolicyCallback): void;
   getPolicy(
       gaxOptsOrCallback?: CallOptions|GetPolicyCallback,
       callback?: GetPolicyCallback): Promise<GetPolicyCallback>|void {
@@ -232,6 +232,10 @@ export class IAM {
         callback!);
   }
 
+  setPolicy(policy: Policy, gaxOpts?: CallOptions): Promise<SetPolicyResponse>;
+  setPolicy(policy: Policy, gaxOpts: CallOptions, callback: SetPolicyCallback):
+      void;
+  setPolicy(policy: Policy, callback: SetPolicyCallback): void;
   /**
    * Set the IAM policy
    *
@@ -280,10 +284,6 @@ export class IAM {
    *   const apiResponse = data[1];
    * });
    */
-  setPolicy(policy: Policy, gaxOpts?: CallOptions): Promise<SetPolicyResponse>;
-  setPolicy(policy: Policy, gaxOpts: CallOptions, callback: SetPolicyCallback):
-      void;
-  setPolicy(policy: Policy, callback: SetPolicyCallback): void;
   setPolicy(
       policy: Policy, gaxOptsOrCallback?: CallOptions|SetPolicyCallback,
       callback?: SetPolicyCallback): Promise<SetPolicyResponse>|void {
@@ -311,6 +311,13 @@ export class IAM {
         callback!);
   }
 
+  testPermissions(permissions: string|string[], gaxOpts?: CallOptions):
+      Promise<TestIamPermissionsResponse>;
+  testPermissions(
+      permissions: string|string[], gaxOpts: CallOptions,
+      callback: TestIamPermissionsCallback): void;
+  testPermissions(
+      permissions: string|string[], callback: TestIamPermissionsCallback): void;
   /**
    * Test a set of permissions for a resource.
    *
@@ -371,13 +378,6 @@ export class IAM {
    *   const apiResponse = data[1];
    * });
    */
-  testPermissions(permissions: string|string[], gaxOpts?: CallOptions):
-      Promise<TestIamPermissionsResponse>;
-  testPermissions(
-      permissions: string|string[], gaxOpts: CallOptions,
-      callback: TestIamPermissionsCallback): void;
-  testPermissions(
-      permissions: string|string[], callback: TestIamPermissionsCallback): void;
   testPermissions(
       permissions: string|string[],
       gaxOptsOrCallback?: CallOptions|TestIamPermissionsCallback,

src/index.ts

@@ -219,6 +219,16 @@ export class PubSub {
       this.Promise = this.options.promise;
     }
   }
+
+  createSubscription(
+      topic: Topic|string, name: string,
+      options?: CreateSubscriptionOptions): Promise<CreateSubscriptionResponse>;
+  createSubscription(
+      topic: Topic|string, name: string, options: CreateSubscriptionOptions,
+      callback: CreateSubscriptionCallback): void;
+  createSubscription(
+      topic: Topic|string, name: string,
+      callback: CreateSubscriptionCallback): void;
   /**
    * Options for creating a subscription.
    *
@@ -281,15 +291,6 @@ export class PubSub {
    * = data[1];
    * });
    */
-  createSubscription(
-      topic: Topic|string, name: string,
-      options?: CreateSubscriptionOptions): Promise<CreateSubscriptionResponse>;
-  createSubscription(
-      topic: Topic|string, name: string, options: CreateSubscriptionOptions,
-      callback: CreateSubscriptionCallback): void;
-  createSubscription(
-      topic: Topic|string, name: string,
-      callback: CreateSubscriptionCallback): void;
   createSubscription(
       topic: Topic|string, name: string,
       optionsOrCallback?: CreateSubscriptionOptions|CreateSubscriptionCallback,
@@ -347,6 +348,10 @@ export class PubSub {
         });
   }
 
+  createTopic(name: string, gaxOpts: CallOptions): Promise<CreateTopicResponse>;
+  createTopic(
+      name: string, gaxOpts: CallOptions, callback?: CreateTopicCallback): void;
+  createTopic(name: string, callback: CreateTopicCallback): void;
   /**
    * Create a topic with the given name.
    *
@@ -376,10 +381,6 @@ export class PubSub {
    *   const apiResponse = data[1];
    * });
    */
-  createTopic(name: string, gaxOpts: CallOptions): Promise<CreateTopicResponse>;
-  createTopic(
-      name: string, gaxOpts: CallOptions, callback?: CreateTopicCallback): void;
-  createTopic(name: string, callback: CreateTopicCallback): void;
   createTopic(
       name: string, gaxOptsOrCallback?: CallOptions|CreateTopicCallback,
       callback?: CreateTopicCallback): Promise<CreateTopicResponse>|void {

src/publisher.ts

@@ -99,6 +99,7 @@ export class Publisher {
     };
     this.timeoutHandle_ = null;
   }
+
   /**
    * @typedef {array} PublisherPublishResponse
    * @property {string} 0 The id for the message.

src/snapshot.ts

@@ -165,6 +165,7 @@ export class Snapshot {
       this.seek = parent.seek.bind(parent, name);
     }
   }
+
   /**
    * Delete the snapshot.
    *