# Documenter stop deploying

**URL:** https://discourse.julialang.org/t/documenter-stop-deploying/24429
**Category:** General Usage
**Created:** [May 21, 2019, 1:11pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429 "2019-05-21T13:11:10Z")
**Posts on this page:** 15
**Page:** 1

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 1:11pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/1 "2019-05-21T13:11:10Z")

</div>

Hi,  
Since two weeks ago the Documenter stop deploying the docs. It doesn’t tell me why, only [Info: skipping docs deployment.](https://travis-ci.org/GenericMappingTools/GMT.jl/builds/535090743)  
What is wrong here?

Thanks

```julia
...
[ Info: SetupBuildDirectory: setting up build directory.
[ Info: ExpandTemplates: expanding markdown templates.
[ Info: CrossReferences: building cross-references.
[ Info: CheckDocument: running document checks.
[ Info: Populate: populating indices.
[ Info: RenderDocument: rendering document.
[ Info: HTMLWriter: rendering HTML pages.
┌ Warning: the `julia` keyword argument to `Documenter.deploydocs` is removed. Use Travis Build Stages for determining from where to deploy instead. See the section about Hosting in the Documenter manual for more details.
│ caller = ip:0x0
└ @ Core :-1
[ Info: skipping docs deployment.

```

---

<div class="post-metadata">

### Author: ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)
#### Post date: [May 21, 2019, 1:12pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/2 "2019-05-21T13:12:15Z")

</div>

This warning:

> [@joa-quim](#):
>
> ┌ Warning: the `julia` keyword argument to `Documenter.deploydocs` is removed. Use Travis Build Stages for determining from where to deploy instead. See the section about Hosting in the Documenter manual for more details. │ caller = ip:0x0 └ @ Core :-1

See [https://github.com/JuliaDocs/Documenter.jl/blob/master/CHANGELOG.md](https://github.com/JuliaDocs/Documenter.jl/blob/master/CHANGELOG.md) for how to upgrade.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 1:20pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/3 "2019-05-21T13:20:09Z")

</div>

Sorry, update what? If you are referring to [hosting instructions](https://juliadocs.github.io/Documenter.jl/stable/man/hosting/) I spent hours last night trying to make it work but got nothing but (uncomprehensible to me) errors. To start with the man page is not clear on what to do when the repo is under an organisation instead of individual. And even before that it fails on Windows with

```julia
julia> Travis.genkeys(user="joa-quim", repo="git@github.com:GenericMappingTools/GMT.jl.git")
ERROR: IOError: could not spawn `which which`: no such file or directory (ENOENT)
Stacktrace:
 [1] _spawn_primitive(::String, ::Cmd, ::Array{Any,1}) at .\process.jl:400
 [2] setup_stdios(::getfield(Base, Symbol("##505#506")){Cmd}, ::Array{Any,1}) at .\process.jl:413
 [3] success(::Cmd) at .\process.jl:412
 [4] #genkeys#1(::String, ::String, ::Function) at C:\Users\j\.julia\packages\DocumenterTools\QEnZ4\src\Travis.jl:61
 [5] (::getfield(DocumenterTools.Travis, Symbol("#kw##genkeys")))(::NamedTuple{(:user, :repo),Tuple{String,String}}, ::typeof(DocumenterTools.Travis.genkeys)) at .\none:0

```

I had SSH keys from a previous attempt but as I said, every time I tried to follow one of the advices, type

````julia
 Warning: The `assets` keyword argument should now be specified in the
│ `Documenter.HTML()` format specifier. To fix this warning replace
│ ```
│ assets = ...
│ ```
│ with
│ ```
│ format = Documenter.HTML(assets = ...)
│ ```

````

I fell into a new error.

---

<div class="post-metadata">

### Author: ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)
#### Post date: [May 21, 2019, 1:26pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/4 "2019-05-21T13:26:12Z")

</div>

It’s understandable that you might be quite frustrated by trouble getting this working but sniping at someone who is trying to help you seems like a bad way to get more help.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 1:30pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/5 "2019-05-21T13:30:51Z")

</div>

You are right that I am frustrated but I tried to be only factual about the errors and the things I don’t understand, but I don’t have the impression of having been offensive. If I was, I apologies.

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [May 21, 2019, 2:12pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/6 "2019-05-21T14:12:31Z")

</div>

Did you see [Hosting Documentation · Documenter.jl](https://juliadocs.github.io/Documenter.jl/stable/man/hosting/#.travis.yml-Configuration-1)?

Here is an example: [OhMyREPL.jl/.travis.yml at 9f5e1852f3864e5dc64aaa0fc089e985131e51bc · KristofferC/OhMyREPL.jl · GitHub](https://github.com/KristofferC/OhMyREPL.jl/blob/9f5e1852f3864e5dc64aaa0fc089e985131e51bc/.travis.yml#L27-L35).

And the corresponding `make.jl`: [OhMyREPL.jl/make.jl at master · KristofferC/OhMyREPL.jl · GitHub](https://github.com/KristofferC/OhMyREPL.jl/blob/master/docs/make.jl) together with a Project + Manifest in that directory.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 2:37pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/7 "2019-05-21T14:37:45Z")

</div>

Thanks for the pointers, but indeed I had read them all. But as I pointed out in first message, not easy. For example trying to get the keys

```julia
julia> Travis.genkeys(user="joa-quim", repo="git@github.com:GenericMappingTools/GMT.jl.git")
ERROR: IOError: could not spawn `which which`: no such file or directory (ENOENT)

```

Also looked into the [examples](https://juliadocs.github.io/Documenter.jl/stable/man/examples/#Examples-1) pointed out in the Docmenter page to realize that many (most) of are them still doing the same thing I used to do until it stop working.

Also had tried what turned out to finally work today, which was to change the deploydocs instruction to

```julia
deploydocs(
	repo = "github.com/GenericMappingTools/GMT.jl.git",
)

```

but, probably in combination with something else, yesterday I still got incomprehensible errors.

In summary, it now works again though I’m not exactly sure I understand the reason.

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [May 21, 2019, 2:51pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/8 "2019-05-21T14:51:09Z")

</div>

If your documentation used to deploy you should already have Travis keys setup so that shouldn’t need to be done again.

The error you are getting seems like an issue with `Travis.genkeys` in Documenter in that it seems to only work on mac / linux where `which` is available.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 3:11pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/9 "2019-05-21T15:11:58Z")

</div>

It used to deploy but without the Travis keys (like it’s still not using them now). Another thing I haven’t mention is that when it stop working I actually had it _version restricted_

```julia
julia -e 'using Pkg; ps=Pkg.PackageSpec(name="Documenter", version="0.19"); Pkg.add(ps); Pkg.pin(ps)'

```

so even more strange that it stop deploying.

Regarding the `which`, I know that and even have gnu port of it in my Win machine, but if I make it visible then the error changed to

```julia
julia> Travis.genkeys(user="joa-quim", repo="git@github.com:GenericMappingTools/GMT.jl.git")
ERROR: 'which' not found.

```

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [May 21, 2019, 3:21pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/10 "2019-05-21T15:21:01Z")

</div>

> [@joa-quim](#):
>
> Another thing I haven’t mention is that when it stop working I actually had it _version restricted_

In the log you linked ([Travis CI - Test and Deploy with Confidence](https://travis-ci.org/GenericMappingTools/GMT.jl/builds/535090743#L3332)) I see

```julia
julia -e 'using Pkg; ps=Pkg.PackageSpec(name="Documenter"); Pkg.add(ps); Pkg.pin(ps)'

```

Where did you set the `version=` keyword?

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 3:28pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/11 "2019-05-21T15:28:47Z")

</div>

Yes, but that link was from after I had removed the version in the first attempts to solve the issue, See [this log](https://travis-ci.org/GenericMappingTools/GMT.jl/builds/534982656) (probably from the same day, or close)

```julia
 julia -e 'using Pkg; ps=Pkg.PackageSpec(name="Documenter", version="0.19"); 

```

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [May 21, 2019, 3:33pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/12 "2019-05-21T15:33:28Z")

</div>

Doing

```julia
Documenter: skipping docs deployment.
  You can set DOCUMENTER_DEBUG to "true" in Travis to see more information.

```

would have been a good idea to see why it didn’t deploy.

It was probably because you had specified that the docs should be deployed from 1.0.3:

> <https://github.com/GenericMappingTools/GMT.jl/blob/f6984237e2be8c25af5fc51ef710d7a5a55992da/docs/make.jl#L107>

but that run was on 1.1.0.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 3:41pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/13 "2019-05-21T15:41:28Z")

</div>

> [@kristoffer.carlsson](#):
>
> Doing
> 
> ```julia
> Documenter: skipping docs deployment.
> You can set DOCUMENTER_DEBUG to "true" in Travis to see more information.
> 
> ```
> 
> would have been a good idea to see why it didn’t deploy.

I [did that too](https://travis-ci.org/GenericMappingTools/GMT.jl/builds/534993945) but couldn’t get any useful info out of it.

> [@](#):
>
> It was probably because you had specified that the docs should be deployed from 1.0.3:

Now, that makes sense. Thanks

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [May 21, 2019, 3:45pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/14 "2019-05-21T15:45:00Z")

</div>

> [@joa-quim](#):
>
> I [did that too](https://travis-ci.org/GenericMappingTools/GMT.jl/builds/534993945) but couldn’t get any useful info out of it.

Yeah but in that log you are not using v0.19 of Documenter anymore so then that advice doesn’t apply.

---

<div class="post-metadata">

### Author: ![joa-quim](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joa-quim/32/227_2.png) [@joa-quim](https://discourse.julialang.org/u/joa-quim)
#### Post date: [May 21, 2019, 3:51pm UTC](https://discourse.julialang.org/t/documenter-stop-deploying/24429/15 "2019-05-21T15:51:20Z")

</div>

True. As I said, tried a lot things, but not always in a clairvoyant way.
