代码要写注释了吗？

/* * You may think you know what the following code does. * But you dont. Trust me. * Fiddle with it, and youll spend many a sleepless * night cursing the moment you thought youd be clever * enough to "optimize" the code below. * Now close this file and go play with something else. */

// I am not sure if we need this, but too scared to delete. ... ...

// I am not responsible of this code. // They made me write it, against my will.

//This code sucks, you know it and I know it. //Move on and call me an idiot later.

////  Kingfisher.swift//  Kingfisher////  Created by Wei Wang on 16/9/14.////  Copyright (c) 2019 Wei Wang <onevcat@gmail.com>////  Permission is hereby granted, free of charge, to any person obtaining a copy//  of this software and associated documentation files (the "Software"), to deal//  in the Software without restriction, including without limitation the rights//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell//  copies of the Software, and to permit persons to whom the Software is//  furnished to do so, subject to the following conditions:////  The above copyright notice and this permission notice shall be included in//  all copies or substantial portions of the Software.////  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN//  THE SOFTWARE.

import Foundation
/// `Session` creates and manages Alamofire's `Request` types during their lifetimes. It also provides common/// functionality for all `Request`s, including queuing, interception, trust management, redirect handling, and response/// cache handling.open class Session {    ...
}

/// Creates a `DataRequest` from a `URLRequest` created using the passed components and a `RequestInterceptor`.    ///    /// - Parameters:    ///   - convertible:     `URLConvertible` value to be used as the `URLRequest`'s `URL`.    ///   - method:          `HTTPMethod` for the `URLRequest`. `.get` by default.    ///   - parameters:      `Parameters` (a.k.a. `[String: Any]`) value to be encoded into the `URLRequest`. `nil` by    ///                      default.    ///   - encoding:        `ParameterEncoding` to be used to encode the `parameters` value into the `URLRequest`.    ///                      `URLEncoding.default` by default.    ///   - headers:         `HTTPHeaders` value to be added to the `URLRequest`. `nil` by default.    ///   - interceptor:     `RequestInterceptor` value to be used by the returned `DataRequest`. `nil` by default.    ///   - requestModifier: `RequestModifier` which will be applied to the `URLRequest` created from the provided    ///                      parameters. `nil` by default.    ///    /// - Returns:       The created `DataRequest`.    open func request(_ convertible: URLConvertible,                      method: HTTPMethod = .get,                      parameters: Parameters? = nil,                      encoding: ParameterEncoding = URLEncoding.default,                      headers: HTTPHeaders? = nil,                      interceptor: RequestInterceptor? = nil,                      requestModifier: RequestModifier? = nil) -> DataRequest {        let convertible = RequestConvertible(url: convertible,                                             method: method,                                             parameters: parameters,                                             encoding: encoding,                                             headers: headers,                                             requestModifier: requestModifier)
        return request(convertible, interceptor: interceptor)    }

/// Underlying `URLSession` used to create `URLSessionTasks` for this instance, and for which this instance's    /// `delegate` handles `URLSessionDelegate` callbacks.    ///    /// - Note: This instance should **NOT** be used to interact with the underlying `URLSessionTask`s. Doing so will    ///         break internal Alamofire logic that tracks those tasks.    ///    public let session: URLSession

// TODO(kl@gmail.com): Use a "*" here for concatenation operator.// TODO(Zeke) change this to use relations.// TODO(bug 12345): remove the "Last visitors" feature

/// Gets an image deserialized from provided data.    ///    /// - Parameters:    ///   - data: The data from which an image should be deserialized.    ///   - options: Options for deserialization.    /// - Returns: An image deserialized or `nil` when no valid image    ///            could be deserialized.    /// - Note:    /// This method is deprecated. Please implement the version with    /// `KingfisherParsedOptionsInfo` as parameter instead.    @available(*, deprecated,    message: "Deprecated. Implement the method with same name but with `KingfisherParsedOptionsInfo` instead.")    func image(with data: Data, options: KingfisherOptionsInfo?) -> KFCrossPlatformImage?