Merge pull request #21676 from JuliaLang/tk/shouldhavebeenadoctest

Minor doctest fixes

Author: tkelman

.travis.yml

@@ -10,6 +10,7 @@ matrix:
           sources:
             - ubuntu-toolchain-r-test
           packages:
+            - libssl1.0.0
             - bar
             - time
             - binutils
@@ -29,6 +30,7 @@ matrix:
           sources:
             - ubuntu-toolchain-r-test
           packages:
+            - libssl1.0.0
             - bar
             - time
             - g++-5

base/dates/periods.jl

@@ -199,7 +199,7 @@ Construct a `CompoundPeriod` from a `Vector` of `Period`s. All `Period`s of the
 will be added together.
 
 # Examples
-```julia
+```jldoctest
 julia> Dates.CompoundPeriod(Dates.Hour(12), Dates.Hour(13))
 25 hours
 
@@ -232,7 +232,7 @@ Reduces the `CompoundPeriod` into its canonical form by applying the following r
   (eg. `Hour(1) - Day(1)` becomes `-Hour(23)`)
 
 # Examples
-```julia
+```jldoctest
 julia> Dates.canonicalize(Dates.CompoundPeriod(Dates.Hour(12), Dates.Hour(13)))
 1 day, 1 hour
 

base/linalg/dense.jl

@@ -546,7 +546,7 @@ julia> A = 2.7182818 * eye(2)
  0.0      2.71828
 
 julia> logm(A)
-2×2 Array{Float64,2}:
+2×2 Symmetric{Float64,Array{Float64,2}}:
  1.0  0.0
  0.0  1.0
 ```

base/linalg/eigen.jl

@@ -228,7 +228,7 @@ julia> A = [0 im; -1 0]
 julia> eigmax(A)
 ERROR: DomainError:
 Stacktrace:
- [1] #eigmax#38(::Bool, ::Bool, ::Function, ::Array{Complex{Int64},2}) at ./linalg/eigen.jl:238
+ [1] #eigmax#46(::Bool, ::Bool, ::Function, ::Array{Complex{Int64},2}) at ./linalg/eigen.jl:238
  [2] eigmax(::Array{Complex{Int64},2}) at ./linalg/eigen.jl:236
 ```
 """
@@ -270,7 +270,7 @@ julia> A = [0 im; -1 0]
 julia> eigmin(A)
 ERROR: DomainError:
 Stacktrace:
- [1] #eigmin#39(::Bool, ::Bool, ::Function, ::Array{Complex{Int64},2}) at ./linalg/eigen.jl:280
+ [1] #eigmin#47(::Bool, ::Bool, ::Function, ::Array{Complex{Int64},2}) at ./linalg/eigen.jl:280
  [2] eigmin(::Array{Complex{Int64},2}) at ./linalg/eigen.jl:278
 ```
 """

base/shell.jl

@@ -178,13 +178,16 @@ The unexported `shell_escape` function is the inverse of the unexported `shell_s
 it takes a string or command object and escapes any special characters in such a way that calling
 `shell_split` on it would give back the array of words in the original command. The `special`
 keyword argument controls what characters in addition to whitespace, backslashes, quotes and
-dollar signs are considered to be special (default: none). Examples:
+dollar signs are considered to be special (default: none).
 
-    julia> Base.shell_escape("cat", "/foo/bar baz", "&&", "echo", "done")
-    "cat '/foo/bar baz' && echo done"
+# Examples
+```jldoctest
+julia> Base.shell_escape("cat", "/foo/bar baz", "&&", "echo", "done")
+"cat '/foo/bar baz' && echo done"
 
-    julia> Base.shell_escape("echo", "this", "&&", "that")
-    "echo this '&&' that"
+julia> Base.shell_escape("echo", "this", "&&", "that")
+"echo this && that"
+```
 """
 shell_escape(args::AbstractString...; special::AbstractString="") =
     sprint(io->print_shell_escaped(io, args..., special=special))