add docblocks + remove extraneous files

Author: tanner0101

Package.swift

@@ -12,10 +12,10 @@ let package = Package(
         .package(url: "https://github.com/vapor/core.git", from: "3.0.0"),
 
         // Swift ORM framework (queries, models, and relations) for building NoSQL and SQL database integrations.
-        .package(url: "https://github.com/vapor/fluent.git", from: "3.0.0-rc"),
+        .package(url: "https://github.com/vapor/fluent.git", from: "3.0.0"),
 
         // 🐘 Non-blocking, event-driven Swift client for PostgreSQL.
-        .package(url: "https://github.com/vapor/postgresql.git", from: "1.0.0-rc"),
+        .package(url: "https://github.com/vapor/postgresql.git", from: "1.0.0"),
     ],
     targets: [
         .target(name: "FluentPostgreSQL", dependencies: ["Async", "FluentSQL", "PostgreSQL"]),

Sources/FluentPostgreSQL/Deprecated.swift

@@ -1,18 +1 @@
-@available(*, deprecated, renamed: "PostgreSQLDataConvertible")
-public typealias PostgreSQLColumnStaticRepresentable = PostgreSQLDataConvertible
-
-/// - warning: Deprecated.
-@available(*, deprecated, renamed: "PostgreSQLType")
-public protocol PostgreSQLJSONType: PostgreSQLType { }
-
-/// - warning: Deprecated.
-@available(*, deprecated, renamed: "PostgreSQLType")
-public protocol PostgreSQLArrayType: PostgreSQLType { }
-
-// - warning: Deprecated.
-@available(*, deprecated, message: "Use custom migration instead.")
-public protocol PostgreSQLEnumType { }
-
-// - warning: Deprecated.
-@available(*, deprecated, message: "Use custom migration instead.")
-public protocol PostgreSQLType { }
+/// Nothing here yet...

Sources/FluentPostgreSQL/Exports.swift

@@ -1,31 +1,2 @@
 @_exported import FluentSQL
 @_exported import PostgreSQL
-
-//extension QueryBuilder where Database == PostgreSQLDatabase {
-//    public func keys(_ keys: PostgreSQLQuery.Key...) -> Self {
-//        query.keys = keys
-//        return self
-//    }
-//
-//    // MARK: Group By
-//
-//    /// Adds a group by to the query builder.
-//    ///
-//    ///     query.groupBy(\.name)
-//    ///
-//    /// - parameters:
-//    ///     - field: Swift `KeyPath` to field on model to group by.
-//    /// - returns: Query builder for chaining.
-//    public func groupBy<T>(_ field: KeyPath<Result, T>) -> Self {
-//        return groupBy(.expression(.column(PostgreSQLDatabase.queryField(.keyPath(field))), alias: nil))
-//    }
-//
-//    /// Adds a manually created group by to the query builder.
-//    /// - parameters:
-//    ///     - groupBy: New `Query.GroupBy` to add.
-//    /// - returns: Query builder for chaining.
-//    public func groupBy(_ groupBy: PostgreSQLQuery.Key) -> Self {
-//        query.groupBy.append(groupBy)
-//        return self
-//    }
-//}

Sources/FluentPostgreSQL/Fluent+PostgreSQLUpsert.swift

@@ -1,10 +1,12 @@
 extension _PostgreSQLModel {
+    /// Creates the model or updates it depending on whether a model with the same ID already exists.
     public func create(orUpdate: Bool, on conn: DatabaseConnectable) -> Future<Self> {
         return Self.query(on: conn).create(orUpdate: orUpdate, self)
     }
 }
 
 extension QueryBuilder where Result: _PostgreSQLModel, Result.Database == Database {
+    /// Creates the model or updates it depending on whether a model with the same ID already exists.
     public func create(orUpdate: Bool, _ model: Result) -> Future<Result> {
         if orUpdate {
             let row = SQLQueryEncoder(PostgreSQLExpression.self).encode(model)

Sources/FluentPostgreSQL/PostgreSQLTableNameCache.swift

@@ -1,5 +1,3 @@
-
-
 protocol AnyArray {
     static var anyElementType: Any.Type { get }
 }