Doc updates for Primitives

Doc updates for `Scenic.Primitive` and `Scenic.Primitive.Component`

Removed the link to `Scenic.Primitive.Component` from
`Scenic.Primitive`'s table because the `component/3` helper no longer
exists and `Scenic.Primitive.Component` no longer seems to match in that
table.

Use plain backticks to create links when possible because it is rendered
better in editors and is shorter with better error checking in
ex_doc (which then caught the `component/3` and `circle/3` broken
links).

Also:
- Formatting updates
- Grammar updates
- Remove some dead code
- Add more links to modules

Author: axelson

lib/scenic/primitive.ex

@@ -20,15 +20,15 @@ defmodule Scenic.Primitive do
   ## How to use primitives
 
   By far, the easiest way to use primitives is to import the helper functions in
-  [`Scenic.Primitives`](Scenic.Primitives.html). These helpers can both add primitives to
+  `Scenic.Primitives`. These helpers can both add primitives to
   a scene you are building and modify later as you react to events.
 
   ```elixir
   import Scenic.Primitives
 
   @graph Scenic.Graph.build()
-    |> rect( {100, 50}, stroke: {1, :yellow} )
-    |> rectangle( {100, 50}, stroke: {1, :yellow} )
+         |> rect({100, 50}, stroke: {1, :yellow})
+         |> rectangle({100, 50}, stroke: {1, :yellow})
   ```
 
   Once you get a primitive out of a graph via functions such as `Graph.modify`, or `Graph.get`,
@@ -44,21 +44,20 @@ defmodule Scenic.Primitive do
 
   | Helper | Primitive Module | Description |
   |---|---|---|
-  | [`arc/3`](Scenic.Primitives.html#arc/3) | `Scenic.Primitive.Arc` | Draw an arc around a circle |
-  | [`circle/3`](Scenic.Components.html#circle/3) | `Scenic.Primitive.Circle` | Draw a full circle |
-  | [`component/3`](Scenic.Primitives.html#component/3) | `Scenic.Primitive.Component` | Start a child component |
-  | [`ellipse/3`](Scenic.Primitives.html#ellipse/3) | `Scenic.Primitive.Ellipse` | Draw an ellipse |
-  | [`group/3`](Scenic.Primitives.html#group/3) | `Scenic.Primitive.Group` | Create a group |
-  | [`line/3`](Scenic.Primitives.html#line/3) | `Scenic.Primitive.Line` | Draw a line |
-  | [`path/3`](Scenic.Primitives.html#path/3) | `Scenic.Primitive.Path` | Draw a complicated path |
-  | [`quad/3`](Scenic.Primitives.html#quad/3) | `Scenic.Primitive.Quad` | Draw a quad |
-  | [`rect/3`](Scenic.Primitives.html#rect/3) | `Scenic.Primitive.Rectangle` | Draw a rectangle |
-  | [`rrect/3`](Scenic.Primitives.html#rrect/3) | `Scenic.Primitive.RoundedRectangle` | Draw a rounded rectangle |
-  | [`script/3`](Scenic.Primitives.html#script/3) | `Scenic.Primitive.Script` | Run a referenced draw script |
-  | [`sector/3`](Scenic.Primitives.html#sector/3) | `Scenic.Primitive.Sector` | A boolean toggle control. |
-  | [`sprites/3`](Scenic.Primitives.html#sprites/3) | `Scenic.Primitive.Sprites` | Draw a sector |
-  | [`text/3`](Scenic.Primitives.html#text/3) | `Scenic.Primitive.Text` | Draw a string of text |
-  | [`triangle/3`](Scenic.Primitives.html#triangle/3) | `Scenic.Primitive.Triangle` | Draw a triangle |
+  | [`arc/3`](`Scenic.Primitives.arc/3`) | `Scenic.Primitive.Arc` | Draw an arc around a circle |
+  | [`circle/3`](`Scenic.Primitives.circle/3`) | `Scenic.Primitive.Circle` | Draw a full circle |
+  | [`ellipse/3`](`Scenic.Primitives.ellipse/3`) | `Scenic.Primitive.Ellipse` | Draw an ellipse |
+  | [`group/3`](`Scenic.Primitives.group/3`) | `Scenic.Primitive.Group` | Create a group |
+  | [`line/3`](`Scenic.Primitives.line/3`) | `Scenic.Primitive.Line` | Draw a line |
+  | [`path/3`](`Scenic.Primitives.path/3`) | `Scenic.Primitive.Path` | Draw a complicated path |
+  | [`quad/3`](`Scenic.Primitives.quad/3`) | `Scenic.Primitive.Quad` | Draw a quad |
+  | [`rect/3`](`Scenic.Primitives.rect/3`) | `Scenic.Primitive.Rectangle` | Draw a rectangle |
+  | [`rrect/3`](`Scenic.Primitives.rrect/3`) | `Scenic.Primitive.RoundedRectangle` | Draw a rounded rectangle |
+  | [`script/3`](`Scenic.Primitives.script/3`) | `Scenic.Primitive.Script` | Run a referenced draw script |
+  | [`sector/3`](`Scenic.Primitives.sector/3`) | `Scenic.Primitive.Sector` | A boolean toggle control. |
+  | [`sprites/3`](`Scenic.Primitives.sprites/3`) | `Scenic.Primitive.Sprites` | Draw a sector |
+  | [`text/3`](`Scenic.Primitives.text/3`) | `Scenic.Primitive.Text` | Draw a string of text |
+  | [`triangle/3`](`Scenic.Primitives.triangle/3`) | `Scenic.Primitive.Triangle` | Draw a triangle |
   """
 
   alias Scenic.Graph
@@ -145,12 +144,8 @@ defmodule Scenic.Primitive do
                      contains_point?: 2,
                      default_pin: 1
     end
-
-    # quote
   end
 
-  # defmacro
-
   # ============================================================================
   # build and add
 
@@ -163,7 +158,7 @@ defmodule Scenic.Primitive do
   Generic builder to create a new primitive.
 
   This function is used internally. You should almost always use the helpers in
-  [Scenic.Primitives](Scenic.Primitives.html) instead.
+  `Scenic.Primitives` instead.
 
   Parameters:
   * `module` - The module of the primitive you are building
@@ -501,8 +496,8 @@ defmodule Scenic.Primitive do
   @doc """
   Put primitive-specific data onto the primitive.
 
-  Like many of the functions in the Scenic.Primitive module, you are usually better
-  off using the helper functions in [`Scenic.Primitives`](Scenic.Primitives.html) instead.
+  Like many of the functions in the `Scenic.Primitive` module, you are usually better
+  off using the helper functions in `Scenic.Primitives` instead.
 
   Parameters:
   * `primitive` - The primitive

lib/scenic/primitive/component.ex

@@ -7,28 +7,28 @@ defmodule Scenic.Primitive.Component do
   @moduledoc """
   Add a child component to a graph.
 
-  When a scene pushes a graph containing a Component to it's ViewPort,
+  When a scene pushes a graph containing a Component to its ViewPort,
   a new scene, containing the component, is created and added as a child
   to the scene that created it.
 
   Any events the new component creates are sent up the parent. The parent
-  can use functions in the Scenic.Scene module to manage it's children,
+  can use functions in the `Scenic.Scene` module to manage its children,
   send them messages and such.
 
   The standard components, such as button, slider, etc. have wrapper functions
   making them very easy to add to a graph. However, if you have a custom
-  component you can add it to any graph manually using the add_to_graph
+  component you can add it to any graph manually using the `add_to_graph/3`
   function.
 
-  You typically want to give components an :id. This will be used to identify
+  You typically want to give components an `:id`. This will be used to identify
   events coming from that components back to your scene.
 
   ```elixir
   import Components  # contains the button helper
 
   graph
-    |> button( "Press Me", id: :press_me )
-    |> MyComponent.add_to_graph( {"Some data", 123}, id: :my_component )
+  |> button("Press Me", id: :press_me)
+  |> MyComponent.add_to_graph({"Some data", 123}, id: :my_component)
   ```
 
   """