@@ -85,7 +85,7 @@ public Y y() {
8585 * Creates a new zone.
8686 *
8787 * @param zone a zone to be created
88- * @return Updated {@link ManagedZone} object
88+ * @return Updated {@code ManagedZone} object
8989 * @throws DnsException upon failure
9090 */
9191 ManagedZone create (ManagedZone zone ) throws DnsException ;
@@ -121,7 +121,7 @@ public Y y() {
121121 *
122122 * @param zoneName name of the zone to be listed
123123 * @param options a map of options for the service call
124- * @throws DnsException upon failure or if zone not found
124+ * @throws DnsException upon failure or if zone was not found
125125 */
126126 Tuple <String , Iterable <ResourceRecordSet >> listDnsRecords (String zoneName ,
127127 Map <Option , ?> options ) throws DnsException ;
@@ -131,40 +131,40 @@ Tuple<String, Iterable<ResourceRecordSet>> listDnsRecords(String zoneName,
131131 *
132132 * @param options a map of options for the service call
133133 * @return up-to-date project information
134- * @throws DnsException upon failure
134+ * @throws DnsException upon failure or if the project is not found
135135 */
136136 Project getProject (Map <Option , ?> options ) throws DnsException ;
137137
138138 /**
139139 * Applies change request to a zone.
140140 *
141- * @param zoneName the name of a zone to which the {@link Change} should be applied
141+ * @param zoneName the name of a zone to which the {@code Change} should be applied
142142 * @param changeRequest change to be applied
143143 * @param options a map of options for the service call
144144 * @return updated change object with server-assigned ID
145- * @throws DnsException upon failure or if zone not found
145+ * @throws DnsException upon failure or if zone was not found
146146 */
147147 Change applyChangeRequest (String zoneName , Change changeRequest , Map <Option , ?> options )
148148 throws DnsException ;
149149
150150 /**
151151 * Returns an existing change request.
152152 *
153- * @param zoneName the name of a zone to which the {@link Change} was be applied
153+ * @param zoneName the name of a zone to which the {@code Change} was be applied
154154 * @param changeRequestId the unique id assigned to the change by the server
155155 * @param options a map of options for the service call
156- * @return up-to-date change object
157- * @throws DnsException upon failure or if zone not found
156+ * @return up-to-date change object or {@code null} if change was not found
157+ * @throws DnsException upon failure or if zone was not found
158158 */
159159 Change getChangeRequest (String zoneName , String changeRequestId , Map <Option , ?> options )
160160 throws DnsException ;
161161
162162 /**
163- * List an existing change requests for a zone.
163+ * List existing change requests for a zone.
164164 *
165- * @param zoneName the name of a zone to which the {@link Change}s were be applied
165+ * @param zoneName the name of a zone to which the {@code Change}s were be applied
166166 * @param options a map of options for the service call
167- * @throws DnsException upon failure or if zone not found
167+ * @throws DnsException upon failure or if zone was not found
168168 */
169169 Tuple <String , Iterable <Change >> listChangeRequests (String zoneName , Map <Option , ?> options )
170170 throws DnsException ;
0 commit comments