Remove Documenter.generate() and Travis.genkeys()

.travis.yml

@@ -13,4 +13,4 @@ notifications:
   email: false
 
 after_success:
-  - julia -e 'cd(Pkg.dir("Documenter", "test")); include("coverage.jl")'
+  - julia -e 'cd("test"); include("coverage.jl")'

docs/src/lib/public.md

@@ -23,9 +23,6 @@ Documenter
 makedocs
 hide
 deploydocs
-Documenter.generate
-Travis
-Travis.genkeys
 Deps
 Deps.pip
 ```

docs/src/man/hosting.md

@@ -41,10 +41,18 @@ Deploy keys provide push access to a *single* repository, to allow secure deploy
     They are `which`, `git`, and `ssh-keygen`. Make sure these are installed before you
     begin this section.
 
-Open a Julia REPL and import [`Documenter`](@ref).
+SSH keys can be generated with the `Travis.genkeys` from the `DocumenterTools.jl` package.
+DocumenterTools can be added using the Julia package manager. From the REPL, type `]`
+to enter the Pkg REPL mode and run
+
+```
+pkg> add DocumenterTools
+```
+
+DocumenterTools can now be loaded as
 
 ```jlcon
-julia> using Documenter
+julia> using DocumenterTools
 ```
 
 Then call the [`Travis.genkeys`](@ref) function as follows:
@@ -119,7 +127,7 @@ Add the following at the end of the file:
 ```julia
 deploydocs(
     repo = "github.com/USER_NAME/PACKAGE_NAME.jl.git",
-    julia = "0.6"
+    julia = "1.0"
 )
 ```
 

src/Documenter.jl

@@ -18,6 +18,14 @@ using DocStringExtensions
 import Base64: base64decode
 import Pkg
 
+# Deprecations
+# ------------
+Base.@deprecate_moved generate "DocumenterTools" false
+module Travis
+    Base.@deprecate_moved genkeys "DocumenterTools" false
+end
+export Travis
+
 # Submodules
 # ----------
 
@@ -34,15 +42,14 @@ include("DocChecks.jl")
 include("Writers/Writers.jl")
 include("Deps.jl")
 include("Generator.jl")
-include("Travis.jl")
 
 import .Utilities: Selectors
 
 
 # User Interface.
 # ---------------
 
-export Travis, Deps, makedocs, deploydocs, hide
+export Deps, makedocs, deploydocs, hide
 
 """
     makedocs(
@@ -591,92 +598,4 @@ function getenv(regex::Regex)
     error("could not find key/iv pair.")
 end
 
-"""
-$(SIGNATURES)
-
-Creates a documentation stub for a package called `pkgname`. The location of
-the documentation is assumed to be `<package directory>/docs`, but this can
-be overriden with the keyword argument `dir`.
-
-It creates the following files
-
-```
-docs/
-    .gitignore
-    src/index.md
-    make.jl
-    mkdocs.yml
-```
-
-# Arguments
-
-**`pkgname`** is the name of the package (without `.jl`). It is used to
-determine the location of the documentation if `dir` is not provided.
-
-# Keywords
-
-**`dir`** defines the directory where the documentation will be generated.
-It defaults to `<package directory>/docs`. The directory must not exist.
-
-# Examples
-
-```jlcon
-julia> using Documenter
-
-julia> Documenter.generate("MyPackageName")
-[ ... output ... ]
-```
-"""
-function generate(pkgname::AbstractString; dir=nothing)
-    # TODO:
-    #   - set up deployment to `gh-pages`
-    #   - fetch url and username automatically (e.g from git remote.origin.url)
-
-    # Check the validity of the package name
-    if length(pkgname) == 0
-        error("Package name can not be an empty string.")
-    end
-    # Determine the root directory where we wish to generate the docs and
-    # check that it is a valid directory.
-    docroot = if dir === nothing
-        pkgdir = Pkg.dir(pkgname)
-        if !isdir(pkgdir)
-            error("Unable to find package $(pkgname).jl at $(pkgdir).")
-        end
-        joinpath(pkgdir, "docs")
-    else
-        dir
-    end
-
-    if ispath(docroot)
-        error("Directory $(docroot) already exists.")
-    end
-
-    # deploy the stub
-    try
-        @info("Deploying documentation to $(docroot)")
-        mkdir(docroot)
-
-        # create the root doc files
-        Generator.savefile(docroot, ".gitignore") do io
-            write(io, Generator.gitignore())
-        end
-        Generator.savefile(docroot, "make.jl") do io
-            write(io, Generator.make(pkgname))
-        end
-        Generator.savefile(docroot, "mkdocs.yml") do io
-            write(io, Generator.mkdocs(pkgname))
-        end
-
-        # Create the default documentation source files
-        Generator.savefile(docroot, "src/index.md") do io
-            write(io, Generator.index(pkgname))
-        end
-    catch
-        rm(docroot, recursive=true)
-        rethrow()
-    end
-    nothing
-end
-
-end
+end # module

test/runtests.jl

@@ -49,9 +49,6 @@ println("="^50)
 
     # A simple build outside of a Git repository
     include("nongit/tests.jl")
-
-    # Tests for Documenter.generate().
-    include("generate.jl")
 end
 
 # Additional tests