added hline/vline support in gadfly

.gitignore

@@ -1,3 +1,4 @@
 *.jl.cov
 *.jl.*.cov
 *.jl.mem
+.DS_Store

README.md

@@ -13,21 +13,27 @@ Please add wishlist items, bugs, or any other comments/questions to the issues l
 - [Qwt.jl](docs/qwt_examples.md)
 - [Gadfly.jl](docs/gadfly_examples.md)
 - [UnicodePlots.jl](docs/unicodeplots_examples.md)
+- [PyPlot.jl](docs/pyplot_examples.md)
+- [Immerse.jl](docs/immerse_examples.md)
+- [Winston.jl](docs/winston_examples.md)
 
 ## Installation
 
-First, clone the package
+First, add the package
 
 ```julia
-Pkg.clone("https://github.com/tbreloff/Plots.jl.git")
+Pkg.add("Plots")
 ```
 
 then get any plotting packages you need (obviously, you should get at least one backend):
 
 ```julia
-Pkg.add("Gadfly")                                     # [optional]
-Pkg.clone("https://github.com/tbreloff/Qwt.jl.git")   # [optional] requires pyqt and pyqwt
-Pkg.add("UnicodePlots")                               # [optional]
+Pkg.add("Gadfly")
+Pkg.add("Immerse")
+Pkg.add("UnicodePlots")
+Pkg.add("PyPlot")                                    # requires python and matplotlib
+Pkg.clone("https://github.com/tbreloff/Qwt.jl.git")  # requires pyqt and pyqwt
+Pkg.add("Winston")
 ```
 
 ## Use
@@ -43,8 +49,13 @@ using Plots
 Do a plot in Gadfly, then save a png:
 
 ```julia
+# switch to Gadfly as a backend
 gadfly!()
-plot(rand(10,2); marker = :rect)   # this will bring up a browser window with the plot, set show=false if you don't want that
+
+# This will bring up a browser window with the plot. Add a semicolon to skip display. 
+plot(rand(10,2); marker = :rect, markersizes=[10,30])
+
+# save it as a PNG
 savepng(Plots.IMG_DIR * "gadfly1.png")
 ```
 
@@ -52,7 +63,7 @@ which saves:
 
 ![gadfly_plt](img/gadfly1.png)
 
-See the examples pages for lots of ways to plot in every supported backend.
+See the examples pages for lots of examples of plots, and what those commands produce for each supported backend.
 
 ## API
 
@@ -143,14 +154,16 @@ __Tip__: Calling `subplot!` on a `Plot` object, or `plot!` on a `Subplot` object
 Shorthands:
 
 ```julia
-scatter(args...; kw...)    = plot(args...; kw...,  linetype = :none, marker = :hexagon)
-scatter!(args...; kw...)   = plot!(args...; kw..., linetype = :none, marker = :hexagon)
+scatter(args...; kw...)    = plot(args...; kw...,  linetype = :scatter)
+scatter!(args...; kw...)   = plot!(args...; kw..., linetype = :scatter)
 bar(args...; kw...)        = plot(args...; kw...,  linetype = :bar)
 bar!(args...; kw...)       = plot!(args...; kw..., linetype = :bar)
 histogram(args...; kw...)  = plot(args...; kw...,  linetype = :hist)
 histogram!(args...; kw...) = plot!(args...; kw..., linetype = :hist)
 heatmap(args...; kw...)    = plot(args...; kw...,  linetype = :heatmap)
 heatmap!(args...; kw...)   = plot!(args...; kw..., linetype = :heatmap)
+sticks(args...; kw...)     = plot(args...; kw...,  linetype = :sticks, marker = :ellipse)
+sticks!(args...; kw...)    = plot!(args...; kw..., linetype = :sticks, marker = :ellipse)
 ```
 
 Some keyword arguments you can set:
@@ -161,7 +174,7 @@ color           # can be a string ("red") or a symbol (:red) or a ColorsTypes.jl
                 #   Colorant (RGB(1,0,0)) or :auto (which lets the package pick)
 label           # string or symbol, applies to that line, may go in a legend
 width           # width of a line
-linetype        # :line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar
+linetype        # :line, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar
 linestyle       # :solid, :dash, :dot, :dashdot, :dashdotdot
 marker          # :none, :ellipse, :rect, :diamond, :utriangle, :dtriangle,
                 #   :cross, :xcross, :star1, :star2, :hexagon
@@ -179,7 +192,6 @@ size            # (Int,Int), resize the enclosing window
 pos             # (Int,Int), move the enclosing window to this position
 windowtitle     # string or symbol, set the title of the enclosing windowtitle
 screen          # Integer, move enclosing window to this screen number (for multiscreen desktops)
-show            # true or false, show the plot (in case you don't want the window to pop up right away)
 ```
 
 Note that not every backend supports all options.
@@ -204,11 +216,10 @@ xlabel = ""
 ylabel = ""
 yrightlabel = ""
 reg = false
-size = (800,600)
+size = (600,400)
 pos = (0,0)
-windowtitle = ""
+windowtitle = "Plots.jl"
 screen = 1
-show = true
 ```
 
 __Tip__: You can see the default value for a given argument with `plotDefault(arg::Symbol)`, and set the default value with `plotDefault!(arg::Symbol, value)`
@@ -224,7 +235,7 @@ plot(rand(100,2); colors = [:red, RGB(.5,.5,0)],
                   width = 5)
 ```
 
-# TODO
+## TODO features:
 
 - [x] Plot vectors/matrices/functions
 - [ ] Plot DataFrames
@@ -238,28 +249,32 @@ plot(rand(100,2); colors = [:red, RGB(.5,.5,0)],
 - [ ] Scenes/Drawing
 - [ ] Graphs
 - [ ] Interactivity (GUIs)
+
+## TODO backends:
+
 - [x] Gadfly.jl
-- [ ] PyPlot.jl
-- [ ] Winston.jl
-- [ ] Gaston.jl
-- [ ] GLPlot.jl
+- [x] Immerse.jl
+- [x] PyPlot.jl
+- [x] UnicodePlots.jl
 - [x] Qwt.jl
+- [x] Winston.jl
+- [ ] GLPlot.jl
 - [ ] Bokeh.jl
+- [ ] Vega.jl
+- [ ] Gaston.jl
 - [ ] Plotly.jl
 - [ ] GoogleCharts.jl
-- [ ] Vega.jl
 - [ ] PLplot.jl
 - [ ] TextPlots.jl
 - [ ] ASCIIPlots.jl
 - [ ] Sparklines.jl
-- [x] UnicodePlots.jl
 - [ ] Hinton.jl
 - [ ] ImageTerm.jl
 - [ ] GraphViz.jl
 - [ ] TikzGraphs.jl
 - [ ] GraphLayout.jl
 
-# More information on backends (both supported and unsupported)
+## More information on backends (both supported and unsupported)
 
 See the wiki at: https://github.com/JuliaPlot/juliaplot_docs/wiki
 

REQUIRE

@@ -1,4 +1,3 @@
 julia 0.4-
 
 Colors
-FactCheck

docs/example_generation.jl

@@ -23,20 +23,20 @@ const examples = PlotExample[
               "A simple line plot of the 3 columns.",
               [:(plot(rand(100,3)))]),
   PlotExample("Functions",
-              "Plot multiple functions.",
+              "Plot multiple functions.  You can also put the function first.",
               [:(plot(0:0.01:4π, [sin,cos]))]),
   PlotExample("",
               "You can also call it with plot(f, xmin, xmax).",
               [:(plot([sin,cos], 0, 4π))]),
   PlotExample("",
-              "Or make a parametric plot with plot(fx, fy, umin, umax).",
+              "Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).",
               [:(plot(sin, x->sin(2x), 0, 2π))]),
   PlotExample("Global",
               "Change the guides/background without a separate call.",
               [:(plot(rand(10); title="TITLE", xlabel="XLABEL", ylabel="YLABEL", background_color = RGB(0.5,0.5,0.5)))]),
   PlotExample("Two-axis",
-              "Use the `axis` or `axiss` arguments.\n\nNote: This is only supported with Qwt right now",
-              [:(plot(Vector[randn(100), randn(100)*100]; axiss = [:left,:right]))]),
+              "Use the `axis` or `axiss` arguments.\n\nNote: Currently only supported with Qwt and PyPlot",
+              [:(plot(Vector[randn(100), randn(100)*100]; axiss = [:left,:right], ylabel="LEFT", yrightlabel="RIGHT"))]),
   PlotExample("Vectors w/ pluralized args",
               "Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).",
               [:(plot(Vector[rand(10), rand(20)]; marker=:ellipse, markersize=8, colors=[:red,:blue]))]),
@@ -48,10 +48,20 @@ const examples = PlotExample[
               [:(scatter!(rand(100); markersize=6, color=:blue))]),
   PlotExample("Heatmaps",
               "",
-              [:(heatmap(randn(10000),randn(10000); nbins=200))]),
-  PlotExample("Lots of line types",
-              "Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  \nNote: some may not work with all backends",
-              [:(plot(rand(20,4); linetypes=[:line, :step, :sticks, :dots], labels=["line","step","sticks","dots"]))]),
+              [:(heatmap(randn(10000),randn(10000); nbins=100))]),
+  PlotExample("Suported line types",
+              "All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)",
+              [:(types = intersect(supportedTypes(), [:line, :step, :stepinverted, :sticks, :scatter])),
+                  :(n = length(types)),
+                  :(x = Vector[sort(rand(20)) for i in 1:n]),
+                  :(y = rand(20,n)),
+                  :(plot(x, y; linetypes=types, labels=map(string,types)))]),
+  PlotExample("Supported line styles",
+              "All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)",
+              [:(styles = setdiff(supportedStyles(), [:auto])), :(plot(rand(20,length(styles)); linestyle=:auto, labels=map(string,styles)))]),
+  PlotExample("Supported marker types",
+              "All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)",
+              [:(markers = setdiff(supportedMarkers(), [:none,:auto])), :(plot([fill(i,10) for i=1:length(markers)]; marker=:auto, labels=map(string,markers), markersize=10))]),
   PlotExample("Bar",
               "x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)",
               [:(bar(randn(1000)))]),
@@ -66,7 +76,7 @@ const examples = PlotExample[
 
                 Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
               """,
-              [:(subplot(randn(100,5); layout=[1,1,3], linetypes=[:line,:hist,:dots,:step,:bar], nbins=10, legend=false))]),
+              [:(subplot(randn(100,5); layout=[1,1,3], linetypes=[:line,:hist,:scatter,:step,:bar], nbins=10, legend=false))]),
   PlotExample("Adding to subplots",
               "Note here the automatic grid layout, as well as the order in which new series are added to the plots.",
               [:(subplot(randn(100,5); n=4))]),
@@ -78,11 +88,17 @@ const examples = PlotExample[
 ]
 
 
+function createStringOfMarkDownCodeValues(arr, prefix = "")
+  string("`", prefix, join(arr, "`, `$prefix"), "`")
+end
+createStringOfMarkDownSymbols(arr) = createStringOfMarkDownCodeValues(arr, ":")
+
+
 function generate_markdown(pkgname::Symbol)
 
   # set up the plotter, and don't show the plots by default
-  plotter!(pkgname)
-  plotDefault!(:show, false)
+  pkg = plotter!(pkgname)
+  # plotDefault!(:show, false)
 
   # mkdir if necessary
   try
@@ -92,6 +108,17 @@ function generate_markdown(pkgname::Symbol)
   # open the markdown file
   md = open("$DOCDIR/$(pkgname)_examples.md", "w")
 
+  write(md, "# Examples for backend: $pkgname\n\n")
+  write(md, "- Supported arguments: $(createStringOfMarkDownCodeValues(supportedArgs(pkg)))\n")
+  write(md, "- Supported values for axis: $(createStringOfMarkDownSymbols(supportedAxes(pkg)))\n")
+  write(md, "- Supported values for linetype: $(createStringOfMarkDownSymbols(supportedTypes(pkg)))\n")
+  write(md, "- Supported values for linestyle: $(createStringOfMarkDownSymbols(supportedStyles(pkg)))\n")
+  write(md, "- Supported values for marker: $(createStringOfMarkDownSymbols(supportedMarkers(pkg)))\n")
+  write(md, "- Is `subplot`/`subplot!` supported? $(subplotSupported(pkg) ? "Yes" : "No")\n\n")
+
+  write(md, "### Initialize\n\n```julia\nusing Plots\n$(pkgname)!()\n```\n\n")
+
+
   for (i,example) in enumerate(examples)
 
     try
@@ -101,7 +128,9 @@ function generate_markdown(pkgname::Symbol)
 
       # save the png
       imgname = "$(pkgname)_example_$i.png"
-      savepng("$IMGDIR/$pkgname/$imgname")
+
+      # NOTE: uncomment this to overwrite the images as well
+      # savepng("$IMGDIR/$pkgname/$imgname")
 
       # write out the header, description, code block, and image link
       write(md, "### $(example.header)\n\n")
@@ -121,11 +150,45 @@ function generate_markdown(pkgname::Symbol)
 
 end
 
+
+# make and display one plot
+function test_example(pkgname::Symbol, idx::Int)
+  println("Testing plot: $pkgname:$idx:$(examples[idx].header)")
+  plotter!(pkgname)
+  plotter()
+  map(eval, examples[idx].exprs)
+  plt = currentPlot()
+  display(plt)
+  plt
+end
+
+# generate all plots and create a dict mapping idx --> plt
+function test_all_examples(pkgname::Symbol)
+  plts = Dict()
+  for i in 1:length(examples)
+    if examples[i].header == "Subplots" && !subplotSupported()
+      break
+    end
+
+    try
+      plt = test_example(pkgname, i)
+      plts[i] = plt
+    catch ex
+      # TODO: put error info into markdown?
+      warn("Example $pkgname:$i:$(examples[i].header) failed with: $ex")
+    end
+  end
+  plts
+end
+
 # run it!
 # note: generate separately so it's easy to comment out
-generate_markdown(:qwt)
-generate_markdown(:gadfly)
-generate_markdown(:unicodeplots) 
+# @osx_only generate_markdown(:unicodeplots)
+# generate_markdown(:qwt)
+# generate_markdown(:gadfly)
+# generate_markdown(:pyplot)
+# generate_markdown(:immerse)
+# generate_markdown(:winston)
 
 
 end # module

docs/gadfly_examples.md

@@ -1,3 +1,19 @@
+# Examples for backend: gadfly
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `reg`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:line`, `:step`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:cross`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+gadfly!()
+```
+
 ### Lines
 
 A simple line plot of the 3 columns.
@@ -10,7 +26,7 @@ plot(rand(100,3))
 
 ### Functions
 
-Plot multiple functions.
+Plot multiple functions.  You can also put the function first.
 
 ```julia
 plot(0:0.01:4π,[sin,cos])
@@ -30,10 +46,10 @@ plot([sin,cos],0,4π)
 
 ### 
 
-Or make a parametric plot with plot(fx, fy, umin, umax).
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
 
 ```julia
-plot(sin,(x->begin  # /Users/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
             sin(2x)
         end),0,2π)
 ```
@@ -54,10 +70,10 @@ plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RG
 
 Use the `axis` or `axiss` arguments.
 
-Note: This is only supported with Qwt right now
+Note: Currently only supported with Qwt and PyPlot
 
 ```julia
-plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right])
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
 ```
 
 ![](../img/gadfly/gadfly_example_6.png)
@@ -97,22 +113,47 @@ scatter!(rand(100); markersize=6,color=:blue)
 
 
 ```julia
-heatmap(randn(10000),randn(10000); nbins=200)
+heatmap(randn(10000),randn(10000); nbins=100)
 ```
 
 ![](../img/gadfly/gadfly_example_10.png)
 
-### Lots of line types
+### Suported line types
 
-Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  
-Note: some may not work with all backends
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
 
 ```julia
-plot(rand(20,4); linetypes=[:line,:step,:sticks,:dots],labels=["line","step","sticks","dots"])
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
 ```
 
 ![](../img/gadfly/gadfly_example_11.png)
 
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/gadfly/gadfly_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/gadfly/gadfly_example_13.png)
+
 ### Bar
 
 x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
@@ -121,7 +162,7 @@ x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints
 bar(randn(1000))
 ```
 
-![](../img/gadfly/gadfly_example_12.png)
+![](../img/gadfly/gadfly_example_14.png)
 
 ### Histogram
 
@@ -131,7 +172,7 @@ note: fillto isn't supported on all backends
 histogram(randn(1000); nbins=50,fillto=20)
 ```
 
-![](../img/gadfly/gadfly_example_13.png)
+![](../img/gadfly/gadfly_example_15.png)
 
 ### Subplots
 
@@ -143,10 +184,10 @@ histogram(randn(1000); nbins=50,fillto=20)
 
 
 ```julia
-subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:dots,:step,:bar],nbins=10,legend=false)
+subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:scatter,:step,:bar],nbins=10,legend=false)
 ```
 
-![](../img/gadfly/gadfly_example_14.png)
+![](../img/gadfly/gadfly_example_16.png)
 
 ### Adding to subplots
 
@@ -156,7 +197,7 @@ Note here the automatic grid layout, as well as the order in which new series ar
 subplot(randn(100,5); n=4)
 ```
 
-![](../img/gadfly/gadfly_example_15.png)
+![](../img/gadfly/gadfly_example_17.png)
 
 ### 
 
@@ -166,5 +207,5 @@ subplot(randn(100,5); n=4)
 subplot!(randn(100,3))
 ```
 
-![](../img/gadfly/gadfly_example_16.png)
+![](../img/gadfly/gadfly_example_18.png)
 

docs/immerse_examples.md

@@ -0,0 +1,211 @@
+# Examples for backend: immerse
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `reg`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:line`, `:step`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:cross`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+immerse!()
+```
+
+### Lines
+
+A simple line plot of the 3 columns.
+
+```julia
+plot(rand(100,3))
+```
+
+![](../img/immerse/immerse_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/immerse/immerse_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/immerse/immerse_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π)
+```
+
+![](../img/immerse/immerse_example_4.png)
+
+### Global
+
+Change the guides/background without a separate call.
+
+```julia
+plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+```
+
+![](../img/immerse/immerse_example_5.png)
+
+### Two-axis
+
+Use the `axis` or `axiss` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/immerse/immerse_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+```
+
+![](../img/immerse/immerse_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3; reg=true,fillto=0)
+```
+
+![](../img/immerse/immerse_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100); markersize=6,color=:blue)
+```
+
+![](../img/immerse/immerse_example_9.png)
+
+### Heatmaps
+
+
+
+```julia
+heatmap(randn(10000),randn(10000); nbins=100)
+```
+
+![](../img/immerse/immerse_example_10.png)
+
+### Suported line types
+
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
+
+```julia
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
+```
+
+![](../img/immerse/immerse_example_11.png)
+
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/immerse/immerse_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/immerse/immerse_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/immerse/immerse_example_14.png)
+
+### Histogram
+
+note: fillto isn't supported on all backends
+
+```julia
+histogram(randn(1000); nbins=50,fillto=20)
+```
+
+![](../img/immerse/immerse_example_15.png)
+
+### Subplots
+
+  subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
+  You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
+  number of columns `nc`), or you can set the layout directly with `layout`.  
+
+  Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
+
+
+```julia
+subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:scatter,:step,:bar],nbins=10,legend=false)
+```
+
+![](../img/immerse/immerse_example_16.png)
+
+### Adding to subplots
+
+Note here the automatic grid layout, as well as the order in which new series are added to the plots.
+
+```julia
+subplot(randn(100,5); n=4)
+```
+
+![](../img/immerse/immerse_example_17.png)
+
+### 
+
+
+
+```julia
+subplot!(randn(100,3))
+```
+
+![](../img/immerse/immerse_example_18.png)
+

docs/pyplot_examples.md

@@ -0,0 +1,176 @@
+# Examples for backend: pyplot
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`, `:right`
+- Supported values for linetype: `:none`, `:line`, `:step`, `:stepinverted`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`
+- Supported values for marker: `:none`, `:auto`, `:ellipse`, `:rect`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:hexagon`
+- Is `subplot`/`subplot!` supported? No
+
+### Initialize
+
+```julia
+using Plots
+pyplot!()
+```
+
+### Lines
+
+A simple line plot of the 3 columns.
+
+```julia
+plot(rand(100,3))
+```
+
+![](../img/pyplot/pyplot_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/pyplot/pyplot_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/pyplot/pyplot_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π)
+```
+
+![](../img/pyplot/pyplot_example_4.png)
+
+### Global
+
+Change the guides/background without a separate call.
+
+```julia
+plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+```
+
+![](../img/pyplot/pyplot_example_5.png)
+
+### Two-axis
+
+Use the `axis` or `axiss` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/pyplot/pyplot_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+```
+
+![](../img/pyplot/pyplot_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3; reg=true,fillto=0)
+```
+
+![](../img/pyplot/pyplot_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100); markersize=6,color=:blue)
+```
+
+![](../img/pyplot/pyplot_example_9.png)
+
+### Heatmaps
+
+
+
+```julia
+heatmap(randn(10000),randn(10000); nbins=100)
+```
+
+![](../img/pyplot/pyplot_example_10.png)
+
+### Suported line types
+
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
+
+```julia
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
+```
+
+![](../img/pyplot/pyplot_example_11.png)
+
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/pyplot/pyplot_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/pyplot/pyplot_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/pyplot/pyplot_example_14.png)
+
+### Histogram
+
+note: fillto isn't supported on all backends
+
+```julia
+histogram(randn(1000); nbins=50,fillto=20)
+```
+
+![](../img/pyplot/pyplot_example_15.png)
+

docs/qwt_examples.md

@@ -1,3 +1,19 @@
+# Examples for backend: qwt
+
+- Supported arguments: `args`, `axis`, `color`, `fillto`, `heatmap_c`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `reg`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`, `:right`
+- Supported values for linetype: `:none`, `:line`, `:step`, `:stepinverted`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot`
+- Supported values for marker: `:none`, `:auto`, `:ellipse`, `:rect`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:star2`, `:hexagon`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+qwt!()
+```
+
 ### Lines
 
 A simple line plot of the 3 columns.
@@ -10,7 +26,7 @@ plot(rand(100,3))
 
 ### Functions
 
-Plot multiple functions.
+Plot multiple functions.  You can also put the function first.
 
 ```julia
 plot(0:0.01:4π,[sin,cos])
@@ -30,10 +46,10 @@ plot([sin,cos],0,4π)
 
 ### 
 
-Or make a parametric plot with plot(fx, fy, umin, umax).
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
 
 ```julia
-plot(sin,(x->begin  # /Users/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
             sin(2x)
         end),0,2π)
 ```
@@ -54,10 +70,10 @@ plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RG
 
 Use the `axis` or `axiss` arguments.
 
-Note: This is only supported with Qwt right now
+Note: Currently only supported with Qwt and PyPlot
 
 ```julia
-plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right])
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
 ```
 
 ![](../img/qwt/qwt_example_6.png)
@@ -97,22 +113,47 @@ scatter!(rand(100); markersize=6,color=:blue)
 
 
 ```julia
-heatmap(randn(10000),randn(10000); nbins=200)
+heatmap(randn(10000),randn(10000); nbins=100)
 ```
 
 ![](../img/qwt/qwt_example_10.png)
 
-### Lots of line types
+### Suported line types
 
-Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  
-Note: some may not work with all backends
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
 
 ```julia
-plot(rand(20,4); linetypes=[:line,:step,:sticks,:dots],labels=["line","step","sticks","dots"])
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
 ```
 
 ![](../img/qwt/qwt_example_11.png)
 
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/qwt/qwt_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/qwt/qwt_example_13.png)
+
 ### Bar
 
 x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
@@ -121,7 +162,7 @@ x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints
 bar(randn(1000))
 ```
 
-![](../img/qwt/qwt_example_12.png)
+![](../img/qwt/qwt_example_14.png)
 
 ### Histogram
 
@@ -131,7 +172,7 @@ note: fillto isn't supported on all backends
 histogram(randn(1000); nbins=50,fillto=20)
 ```
 
-![](../img/qwt/qwt_example_13.png)
+![](../img/qwt/qwt_example_15.png)
 
 ### Subplots
 
@@ -143,10 +184,10 @@ histogram(randn(1000); nbins=50,fillto=20)
 
 
 ```julia
-subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:dots,:step,:bar],nbins=10,legend=false)
+subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:scatter,:step,:bar],nbins=10,legend=false)
 ```
 
-![](../img/qwt/qwt_example_14.png)
+![](../img/qwt/qwt_example_16.png)
 
 ### Adding to subplots
 
@@ -156,7 +197,7 @@ Note here the automatic grid layout, as well as the order in which new series ar
 subplot(randn(100,5); n=4)
 ```
 
-![](../img/qwt/qwt_example_15.png)
+![](../img/qwt/qwt_example_17.png)
 
 ### 
 
@@ -166,5 +207,5 @@ subplot(randn(100,5); n=4)
 subplot!(randn(100,3))
 ```
 
-![](../img/qwt/qwt_example_16.png)
+![](../img/qwt/qwt_example_18.png)
 

docs/unicodeplots_examples.md

@@ -1,3 +1,19 @@
+# Examples for backend: unicodeplots
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:step`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`
+- Supported values for marker: `:none`, `:auto`, `:ellipse`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+unicodeplots!()
+```
+
 ### Lines
 
 A simple line plot of the 3 columns.
@@ -10,7 +26,7 @@ plot(rand(100,3))
 
 ### Functions
 
-Plot multiple functions.
+Plot multiple functions.  You can also put the function first.
 
 ```julia
 plot(0:0.01:4π,[sin,cos])
@@ -30,10 +46,10 @@ plot([sin,cos],0,4π)
 
 ### 
 
-Or make a parametric plot with plot(fx, fy, umin, umax).
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
 
 ```julia
-plot(sin,(x->begin  # /Users/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
             sin(2x)
         end),0,2π)
 ```
@@ -54,10 +70,10 @@ plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RG
 
 Use the `axis` or `axiss` arguments.
 
-Note: This is only supported with Qwt right now
+Note: Currently only supported with Qwt and PyPlot
 
 ```julia
-plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right])
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
 ```
 
 ![](../img/unicodeplots/unicodeplots_example_6.png)
@@ -92,17 +108,52 @@ scatter!(rand(100); markersize=6,color=:blue)
 
 ![](../img/unicodeplots/unicodeplots_example_9.png)
 
-### Lots of line types
+### Heatmaps
+
 
-Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  
-Note: some may not work with all backends
 
 ```julia
-plot(rand(20,4); linetypes=[:line,:step,:sticks,:dots],labels=["line","step","sticks","dots"])
+heatmap(randn(10000),randn(10000); nbins=100)
+```
+
+![](../img/unicodeplots/unicodeplots_example_10.png)
+
+### Suported line types
+
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
+
+```julia
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
 ```
 
 ![](../img/unicodeplots/unicodeplots_example_11.png)
 
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/unicodeplots/unicodeplots_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/unicodeplots/unicodeplots_example_13.png)
+
 ### Bar
 
 x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
@@ -111,7 +162,7 @@ x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints
 bar(randn(1000))
 ```
 
-![](../img/unicodeplots/unicodeplots_example_12.png)
+![](../img/unicodeplots/unicodeplots_example_14.png)
 
 ### Histogram
 
@@ -121,7 +172,7 @@ note: fillto isn't supported on all backends
 histogram(randn(1000); nbins=50,fillto=20)
 ```
 
-![](../img/unicodeplots/unicodeplots_example_13.png)
+![](../img/unicodeplots/unicodeplots_example_15.png)
 
 ### Subplots
 
@@ -133,10 +184,10 @@ histogram(randn(1000); nbins=50,fillto=20)
 
 
 ```julia
-subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:dots,:step,:bar],nbins=10,legend=false)
+subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:scatter,:step,:bar],nbins=10,legend=false)
 ```
 
-![](../img/unicodeplots/unicodeplots_example_14.png)
+![](../img/unicodeplots/unicodeplots_example_16.png)
 
 ### Adding to subplots
 
@@ -146,7 +197,7 @@ Note here the automatic grid layout, as well as the order in which new series ar
 subplot(randn(100,5); n=4)
 ```
 
-![](../img/unicodeplots/unicodeplots_example_15.png)
+![](../img/unicodeplots/unicodeplots_example_17.png)
 
 ### 
 
@@ -156,5 +207,5 @@ subplot(randn(100,5); n=4)
 subplot!(randn(100,3))
 ```
 
-![](../img/unicodeplots/unicodeplots_example_16.png)
+![](../img/unicodeplots/unicodeplots_example_18.png)
 

docs/winston_examples.md

@@ -0,0 +1,166 @@
+# Examples for backend: winston
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markersize`, `nbins`, `reg`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:sticks`, `:scatter`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`, `:dashdotdot`, `:dot`, `:dash`, `:dashdot`
+- Supported values for marker: `:auto`, `:hexagon`, `:none`, `:dtriangle`, `:ellipse`, `:xcross`, `:rect`, `:star1`, `:star2`, `:cross`, `:utriangle`, `:diamond`
+- Is `subplot`/`subplot!` supported? No
+
+### Initialize
+
+```julia
+using Plots
+winston!()
+```
+
+### Lines
+
+A simple line plot of the 3 columns.
+
+```julia
+plot(rand(100,3))
+```
+
+![](../img/winston/winston_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/winston/winston_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/winston/winston_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π)
+```
+
+![](../img/winston/winston_example_4.png)
+
+### Global
+
+Change the guides/background without a separate call.
+
+```julia
+plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+```
+
+![](../img/winston/winston_example_5.png)
+
+### Two-axis
+
+Use the `axis` or `axiss` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/winston/winston_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+```
+
+![](../img/winston/winston_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3; reg=true,fillto=0)
+```
+
+![](../img/winston/winston_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100); markersize=6,color=:blue)
+```
+
+![](../img/winston/winston_example_9.png)
+
+### Suported line types
+
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
+
+```julia
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
+```
+
+![](../img/winston/winston_example_11.png)
+
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/winston/winston_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/winston/winston_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/winston/winston_example_14.png)
+
+### Histogram
+
+note: fillto isn't supported on all backends
+
+```julia
+histogram(randn(1000); nbins=50,fillto=20)
+```
+
+![](../img/winston/winston_example_15.png)
+