Reformat docstrings and add Documenter docs (#115)

Author: ararslan

.gitignore

@@ -0,0 +1,5 @@
+docs/build/
+docs/site/
+*.jl.cov
+*.jl.*.cov
+*.jl.mem

.travis.yml

@@ -12,4 +12,5 @@ notifications:
 #  - if [[ -a .git/shallow ]]; then git fetch --unshallow; fi
 #  - julia -e 'Pkg.clone(pwd()); Pkg.build("Polynomials"); Pkg.test("Polynomials"; coverage=true)';
 after_success:
+  - julia -e 'cd(Pkg.dir("Polynomials")); Pkg.add("Documenter"); using Documenter; include(joinpath("docs", "make.jl"))';
   - julia -e 'cd(Pkg.dir("Polynomials")); Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder())';

README.md

@@ -2,12 +2,18 @@
 
 Basic arithmetic, integration, differentiation, evaluation, and root finding over dense univariate polynomials.
 
-[![Build Status](https://travis-ci.org/JuliaMath/Polynomials.jl.svg?branch=master)](https://travis-ci.org/JuliaMath/Polynomials.jl)
-[![Coverage Status](https://coveralls.io/repos/github/JuliaMath/Polynomials.jl/badge.svg)](https://coveralls.io/github/JuliaMath/Polynomials.jl)
 [![Polynomials](http://pkg.julialang.org/badges/Polynomials_0.4.svg)](http://pkg.julialang.org/?pkg=Polynomials)
 [![Polynomials](http://pkg.julialang.org/badges/Polynomials_0.5.svg)](http://pkg.julialang.org/?pkg=Polynomials)
 [![Polynomials](http://pkg.julialang.org/badges/Polynomials_0.6.svg)](http://pkg.julialang.org/?pkg=Polynomials)
 
+Master branch:
+[![Build Status](https://travis-ci.org/JuliaMath/Polynomials.jl.svg?branch=master)](https://travis-ci.org/JuliaMath/Polynomials.jl)
+[![Coverage Status](https://coveralls.io/repos/github/JuliaMath/Polynomials.jl/badge.svg)](https://coveralls.io/github/JuliaMath/Polynomials.jl)
+
+Documentation:
+[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://JuliaMath.github.io/Polynomials.jl/stable)
+[![](https://img.shields.io/badge/docs-latest-blue.svg)](https://JuliaMath.github.io/Polynomials.jl/latest)
+
 #### Poly{T<:Number}(a::Vector)
 
 Construct a polynomial from its coefficients, lowest order first.

docs/make.jl

@@ -0,0 +1,19 @@
+using Polynomials, Documenter
+
+makedocs(
+    modules = [Polynomials],
+    clean = false,
+    format = :html,
+    sitename = "Polynomials.jl",
+    authors = "Jameson Nash, Keno Fischer, and other contributors",
+    pages = [
+        "Manual" => "index.md",
+    ],
+)
+
+deploydocs(
+    repo = "github.com/JuliaMath/Polynomials.jl.git",
+    target = "build",
+    deps = nothing,
+    make = nothing,
+)

docs/src/index.md

@@ -0,0 +1,35 @@
+# Polynomials.jl
+
+Polynomials.jl is a Julia package that provides basic arithmetic, integration,
+differentiation, evaluation, and root finding over dense univariate polynomials.
+
+To install the package, run
+
+```julia
+Pkg.add("Polynomials")
+```
+
+The package can then be loaded into the current session using
+
+```julia
+using Polynomials
+```
+
+## Functions
+
+```@meta
+CurrentModule = Polynomials
+```
+
+```@docs
+Poly
+poly
+degree
+coeffs
+variable
+polyval
+polyint
+polyder
+polyfit
+roots
+```