add doctests.jl test file and /docs folder

Author: apkille

docs/.gitignore

@@ -0,0 +1,2 @@
+build/
+site/

docs/Project.toml

@@ -0,0 +1,3 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+RandomMatrices = "2576dda1-a324-5b11-aa66-c48ed7e3c618"

docs/make.jl

@@ -0,0 +1,28 @@
+push!(LOAD_PATH,"../src/")
+
+using Documenter
+using RandomMatrices
+
+DocMeta.setdocmeta!(RandomMatrices, :DocTestSetup, :(using RandomMatrices, Random); recursive=true)
+
+function main()
+
+    makedocs(
+    doctest = false,
+    clean = true,
+    sitename = "RandomMatrices.jl",
+    format = Documenter.HTML(
+        assets=["assets/init.js"]
+    ),
+    modules = [RandomMatrices],
+    checkdocs = :exports,
+    warnonly = false,
+    authors = "Andrew Kille",
+    pages = [
+        "RandomMatrices.jl" => "index.md",
+        "Full API" => "API.md"
+    ]
+    )
+end
+
+main()

docs/src/API.md

@@ -0,0 +1,17 @@
+# [Full API](@id Full-API)
+
+```@raw html
+<style>
+    .content table td {
+        padding-top: 0 !important;
+        padding-bottom: 0 !important;
+    }
+</style>
+```
+
+## Autogenerated API list
+
+```@autodocs
+Modules = [RandomMatrices]
+Private = false
+```

docs/src/index.md

@@ -0,0 +1,7 @@
+# RandomMatrices.jl
+
+```@meta
+DocTestSetup = quote
+    using RandomMatrices
+end
+```

test/doctests.jl

@@ -0,0 +1,8 @@
+using Documenter
+using RandomMatrices
+using Test
+
+@testset "Doctests" begin
+    DocMeta.setdocmeta!(RandomMatrices, :DocTestSetup, :(using RandomMatrices, Random); recursive=true)
+    doctest(RandomMatrices)
+end

test/runtests.jl

@@ -8,6 +8,7 @@ using Test
 	include("FormalPowerSeries.jl")
 	include("Haar.jl")
 	include("StochasticProcess.jl")
+	include("doctests.jl")
 
 	@testset "densities" begin
 		include("densities/Semicircle.jl")