Update docs deployment (#279)

* Update docs deployment

* Fix some problems with doctests

* Allow failures in nightly (appveyor)

Author: lbenet

.travis.yml

@@ -12,16 +12,31 @@ os:
 julia:
   - 0.7
   - 1.0
+  - 1.1
   - nightly
 
-#matrix:
-#   allow_failures:
-#     - julia: nightly
+matrix:
+  allow_failures:
+    - julia: nightly
 
 notifications:
   email: false
 
+env:
+  global:
+    - DOCUMENTER_DEBUG=true
+
+jobs:
+  include:
+    - stage: "Documentation"
+      julia: 1.1
+      os: linux
+      script:
+        - julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
+        - julia --project=docs/ docs/make.jl
+      after_success: skip
+
 after_success:
-  - julia -e 'using Pkg; ps=Pkg.PackageSpec(name="Documenter", version="0.19"); Pkg.add(ps); Pkg.pin(ps)'
-  - julia -e 'cd(Pkg.dir("IntervalArithmetic")); include(joinpath("docs", "make.jl"))'
-  - julia -e 'cd(Pkg.dir("IntervalArithmetic")); Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder()); Codecov.submit(process_folder())'
+  - julia -e 'import Pkg; Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder())'
+
+sudo: false

appveyor.yml

@@ -10,9 +10,9 @@ platform:
 
 # # Uncomment the following lines to allow failures on nightly julia
 # # (tests will run but not make your overall status red)
-# matrix:
-#   allow_failures:
-#   - julia_version: nightly
+matrix:
+  allow_failures:
+  - julia_version: nightly
 
 branches:
   only:

docs/Project.toml

@@ -0,0 +1,3 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+IntervalArithmetic = "d1acc4aa-44c8-5952-acd4-ba5d80a2a253"

docs/make.jl

@@ -2,8 +2,9 @@ using Documenter, IntervalArithmetic
 
 makedocs(
     modules = [IntervalArithmetic],
-    format = :html,
+    format = Documenter.HTML(prettyurls = get(ENV, "CI", nothing) == "true"),
     sitename = "IntervalArithmetic",
+    authors = "David P. Sanders and Luis Benet",
     pages = [
         "Package" => "index.md",
         "Interval Arithmetic" => "intro.md",
@@ -19,8 +20,6 @@ makedocs(
 deploydocs(
     repo   = "github.com/JuliaIntervals/IntervalArithmetic.jl.git",
     target = "build",
-    julia  = "1.0",
-    osname = "linux",
     deps   = nothing,
     make   = nothing
 )

docs/src/decorations.md

@@ -42,7 +42,10 @@ julia> X = DecoratedInterval(3, 4)
 By default, decorations are not displayed. The following turns on display of decorations:
 ```jldoctest decorations
 julia> setformat(decorations=true)
-6
+Display parameters:
+- format: standard
+- decorations: true
+- significant figures: 6
 
 julia> X
 [3, 4]_com

docs/src/rounding.md

@@ -13,7 +13,7 @@ The true value that is actually stored in the variable can be conveniently deter
 
 ```jldoctest
 julia> big(0.1)
-1.000000000000000055511151231257827021181583404541015625000000000000000000000000e-01
+0.1000000000000000055511151231257827021181583404541015625
 ```
 
 So, in fact, the Julia float `0.1` refers to a real number that is slightly greater than 0.1. By default, such calculations are done in round-to-nearest mode (`RoundNearest`); i.e., the nearest representable floating-point number to 0.1 is used.
@@ -22,7 +22,7 @@ So, in fact, the Julia float `0.1` refers to a real number that is slightly grea
 
 ```jldoctest
 julia> big"0.1"
-1.000000000000000000000000000000000000000000000000000000000000000000000000000002e-01
+0.1000000000000000000000000000000000000000000000000000000000000000000000000000002
 ```
 ]
 
@@ -68,7 +68,7 @@ The result correctly contains the true 0.4.
 Let's look at the internal representation of the `Float64` number 0.1:
 
 ```jldoctest
-julia> bits(0.1)
+julia> bitstring(0.1)
 "0011111110111001100110011001100110011001100110011001100110011010"
 ```
 The last 53 bits of these 64 bits correspond to the binary expansion of 0.1, which is

docs/src/usage.md

@@ -15,7 +15,7 @@ julia> a = @interval(1)
 [1, 1]
 
 julia> typeof(ans)
-IntervalArithmetic.Interval{Float64}
+Interval{Float64}
 
 julia> b = @interval(1, 2)
 [1, 2]
@@ -29,7 +29,7 @@ julia> @biginterval(1, 2)
 [1, 2]₂₅₆
 
 julia> showfull(ans)
-Interval(1.000000000000000000000000000000000000000000000000000000000000000000000000000000, 2.000000000000000000000000000000000000000000000000000000000000000000000000000000)
+Interval(1.0, 2.0)
 ```
 
 The constructor of the `Interval` type may be used directly, but this is generally not recommended, for the following reason:
@@ -134,7 +134,7 @@ julia> @biginterval "0.1"*2
 [0.199999, 0.200001]₂₅₆
 
 julia> showfull(ans)
-Interval(1.999999999999999999999999999999999999999999999999999999999999999999999999999983e-01, 2.000000000000000000000000000000000000000000000000000000000000000000000000000004e-01)
+Interval(0.1999999999999999999999999999999999999999999999999999999999999999999999999999983, 0.2000000000000000000000000000000000000000000000000000000000000000000000000000004)
 
 ```