RK -> BL. Complete-ish docs.

Author: irskep

.gitignore

@@ -2,3 +2,6 @@
 /.build
 /Packages
 /*.xcodeproj
+docs/
+build/
+Binaries/

Makefile

@@ -0,0 +1,15 @@
+.PHONY: docs
+
+docs:
+	jazzy \
+		-o docs \
+		--clean \
+		--no-skip-undocumented \
+		--sdk macosx \
+		--xcodebuild-arguments -project,BearLibTerminal.xcodeproj,-target,BearLibTerminal \
+		--author "Steve Johnson" \
+		--author_url "http://steveasleep.com" \
+		--module-version 1.0.0 \
+		--copyright "2018 Steve Johnson" \
+		--root-url "http://steveasleep.com/BearLibTerminal-Swift" \
+		--github_url "https://github.com/irskep/BearLibTerminal-Swift"

README.md

@@ -2,18 +2,55 @@
 
 Swifty bindings for [BearLibTerminal](http://foo.wyrd.name/en:bearlibterminal).
 
-This repo is compatible with the Swift package manager.
+This repo is compatible with the Swift package manager. It has not yet been tested
+with Carthage or Cocoapods.
 
 ```swift
-let terminal = RKTerminal.main
+let terminal = BLTerminal.main
 terminal.open()
-terminal.print(point: RKPoint(x: 0, y: 0), string: "[color=red]Hi![/color]")
+terminal.print(point: BLPoint(x: 0, y: 0), string: "[color=red]Hi![/color]")
 terminal.waitForExit()
 terminal.close()
 ```
 
-The code is very short. Please read `Sources/BearLibTerminal` to get a sense
-of the interface and data types.
+## Setup
+
+You need to add a new dependency to your `Package.swift`:
+
+```
+// swift-tools-version:4.0
+
+import PackageDescription
+
+let package = Package(
+    name: "My Game",
+    dependencies: [
+         .package(url: "https://github.com/irskep/BearLibTerminal-Swift.git", from: "1.0.1"),
+    ],
+    targets: [
+        .target(
+            name: "My Game",
+            dependencies: ["BearLibTerminal"]),
+
+    ]
+)
+```
+
+You **also** need to link against the BearLibTerminal shared library! On OS X,
+that's `libBearLibTerminal.dylib` ([download](http://foo.wyrd.name/_media/en:bearlibterminal:bearlibterminal_0.15.7_osx.zip)).
+See [the BearLibTerminal site](http://foo.wyrd.name/en:bearlibterminal) for more links.
+
+## Why it's better than using the C bridge directly
+
+The C library plays fast and loose with signedness of ints. You need to convert an `Int8`
+to a `UInt8` pretty regularly, and it can be hard to remember where and how to do this.
+
+Also, If you code against the interface, you can write tests for your code without showing
+a GUI.
+
+## Docs
+
+If you're reading this from GitHub, please [visit the full documentation.](http://steveasleep.com/BearLibTerminal-Swift)
 
 If you would like more documentation, please open a GitHub issue so
-I know someone cares!
+I know someone cares!

Sources/BearLibTerminal/BearLibTerminal+constants.swift

@@ -1,6 +1,6 @@
 //
 //  BearLibTerminal+constants.swift
-//  RLSandbox
+//  BearLibTerminal-Swift
 //
 //  Created by Steve Johnson on 1/5/18.
 //  Copyright © 2018 Steve Johnson. All rights reserved.
@@ -9,7 +9,12 @@
 import CBearLibTerminal
 
 
-public struct RKConstant {
+/**
+ All constants exposed by BearLibTerminal. See
+ [the original documentation](http://foo.wyrd.name/en:bearlibterminal:reference)
+ for details about each one.
+ */
+public struct BLConstant {
     // Keyboard scancodes for events/states.
     public static let A = TK_A
     public static let B = TK_B