Fix some bad documentation links.

sdk/lib/io/http.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 257 matching lines @@
    * [port] getter.
    *
    * The optional argument [backlog] can be used to specify the listen
    * backlog for the underlying OS listen setup. If [backlog] has the
    * value of [:0:] (the default) a reasonable value will be chosen by
    * the system.
    *
    * If [requestClientCertificate] is true, the server will
    * request clients to authenticate with a client certificate.
    * The server will advertise the names of trusted issuers of client
-   * certificates, getting them from [context], where they have been
+   * certificates, getting them from a [SecurityContext], where they have been
    * set using [SecurityContext.setClientAuthorities].
    *
    * The optional argument [shared] specifies whether additional HttpServer
    * objects can bind to the same combination of `address`, `port` and `v6Only`.
    * If `shared` is `true` and more `HttpServer`s from this isolate or other
    * isolates are bound to the port, then the incoming connections will be
    * distributed among all the bound `HttpServer`s. Connections can be
    * distributed over multiple isolates this way.
    */
 
@@ skipping 944 matching lines @@
  * ## HTTPS connections
  *
  * An HttpClient can make HTTPS requests, connecting to a server using
  * the TLS (SSL) secure networking protocol. Calling [getUrl] with an
  * https: scheme will work automatically, if the server's certificate is
  * signed by a root CA (certificate authority) on the default list of
  * well-known trusted CAs, compiled by Mozilla.
  *
  * To add a custom trusted certificate authority, or to send a client
  * certificate to servers that request one, pass a [SecurityContext] object
- * as the optional [context] argument to the `HttpClient` constructor.
+ * as the optional `context` argument to the `HttpClient` constructor.
  * The desired security options can be set on the [SecurityContext] object.
  *
  * ## Headers
  *
  * All HttpClient requests set the following header by default:
  *
  *     Accept-Encoding: gzip
  *
  * This allows the HTTP server to use gzip compression for the body if
  * possible. If this behavior is not desired set the
@@ skipping 104 matching lines @@
   Future<HttpClientRequest> open(
       String method, String host, int port, String path);
 
   /**
    * Opens a HTTP connection.
    *
    * The HTTP method is specified in [method] and the URL to use in
    * [url].
    *
    * The `Host` header for the request will be set to the value
-   * [host]:[port]. This can be overridden through the
+   * [Uri.host]:[Uri.port] from [url]. This can be overridden through the
    * [HttpClientRequest] interface before the request is sent.  NOTE
    * if [host] is an IP address this will still be set in the `Host`
    * header.
    *
    * For additional information on the sequence of events during an
    * HTTP transaction, and the objects returned by the futures, see
    * the overall documentation for the class [HttpClient].
    */
   Future<HttpClientRequest> openUrl(String method, Uri url);
 
@@ skipping 264 matching lines @@
    *
    * If a bad certificate is received on a connection attempt, the library calls
    * the function that was the value of badCertificateCallback at the time
    * the request is made, even if the value of badCertificateCallback
    * has changed since then.
    */
   set badCertificateCallback(
       bool callback(X509Certificate cert, String host, int port));
 
   /**
-   * Shut down the HTTP client. If [force] is [:false:] (the default)
-   * the [:HttpClient:] will be kept alive until all active
-   * connections are done. If [force] is [:true:] any active
+   * Shut down the HTTP client. If [force] is `false` (the default)
+   * the [HttpClient] will be kept alive until all active
+   * connections are done. If [force] is `true` any active
    * connections will be closed to immediately release all
-   * resources. These closed connections will receive an [:onError:]
-   * callback to indicate that the client was shut down. In both cases
+   * resources. These closed connections will receive an error
+   * event to indicate that the client was shut down. In both cases
    * trying to establish a new connection after calling [close]
    * will throw an exception.
    */
   void close({bool force: false});
 }
 
 /**
  * HTTP request for a client connection.
  *
  * To set up a request, set the headers using the headers property
@@ skipping 46 matching lines @@
    * following the redirect.
    *
    * All headers added to the request will be added to the redirection
    * request(s). However, any body send with the request will not be
    * part of the redirection request(s).
    */
   bool followRedirects;
 
   /**
    * Set this property to the maximum number of redirects to follow
-   * when [followRedirects] is [:true:]. If this number is exceeded the
-   * [onError] callback will be called with a [RedirectException].
+   * when [followRedirects] is `true`. If this number is exceeded
+   * an error event will be added with a [RedirectException].
    *
    * The default value is 5.
    */
   int maxRedirects;
 
   /**
    * The method of the request.
    */
   String get method;
 
@@ skipping 127 matching lines @@
    * the current response. All body data must have been read from the
    * current response before calling [redirect].
    *
    * All headers added to the request will be added to the redirection
    * request. However, any body sent with the request will not be
    * part of the redirection request.
    *
    * If [followLoops] is set to [:true:], redirect will follow the redirect,
    * even if the URL was already visited. The default value is [:false:].
    *
-   * [redirect] will ignore [maxRedirects] and will always perform the redirect.
+   * The method will ignore [HttpClientRequest.maxRedirects]
+   * and will always perform the redirect.
    */
   Future<HttpClientResponse> redirect(
       [String method, Uri url, bool followLoops]);
 
   /**
    * Returns the client response headers.
    *
    * The client response headers are immutable.
    */
   HttpHeaders get headers;
@@ skipping 107 matching lines @@
 class RedirectException implements HttpException {
   final String message;
   final List<RedirectInfo> redirects;
 
   const RedirectException(this.message, this.redirects);
 
   String toString() => "RedirectException: $message";
 
   Uri get uri => redirects.last.location;
 }