X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgrid-controls.html;h=fee3dd0704af99d6afcf0c2d69333d8aefc3a0b0;hb=a5670d03b509c2a8b38b1c683353a9e929c62353;hp=2166fc99a0cf8afc1cba27d8849fc53407c578f0;hpb=7be4f507991a0b87174a0e78831a4e7e9e96bcbe;p=ardour-manual

diff --git a/include/grid-controls.html b/include/grid-controls.html
index 2166fc9..fee3dd0 100644
--- a/include/grid-controls.html
+++ b/include/grid-controls.html
@@ -1,27 +1,62 @@
 
-<img class="left" src="/images/toolbar-grid.png" alt="Editor toolbar's grid">
+<h2> What is “Snap” and “Grid”?</h2>
 
+<figure class="left">
+	<img src="/images/toolbar-grid.png" alt="Editor toolbar's grid">
+	<figcaption>
+		Editor toolbar's grid.
+	</figcaption>
+</figure>
+
+<p>
+“Snap” will cause drags and other mouse-driven operations to jump to
+positions determined by the nearest snap setting.  Snap can be set to
+multiple options: markers, region start/ends, and the grid (those
+are all enabled by default. change them in prefs).
+</p>
+<p>
+Grid can be enabled, and it will draw lines at selected intervals;
+which can be musical, like 16th notes, or can be timecode based
+(minutes and seconds). You can leave the Grid enabled, but snap
+disabled, if you just want to see the lines but not snap to them.
+</p>
+<p>
+For example: if the Grid is set to “beats” and Snap-to-grid is
+enabled, then any operations such as split, paste, or range-select
+will happen exactly on a beat, according to the musical timeline and
+tempo.
+</p>
 <p>
-  Ardour's editor utilizes a <dfn>grid</dfn> to assist in the placement of regions
-  on the timeline, or with editing functions that need to happen at a specific
-  point in time. This <dfn>snapping</dfn> of the cursor and various objects to the
-  grid can be toggled on or off, as does its behaviour, and grid units.
+Alternatively, you can leave “Snap” enabled (so your mouse actions
+can snap to Markers, or region edges) but disable the Grid.
+</p>
+
+<h2>A Warning, of sorts</h2>
+
+<p class="warning">
+The grid consist of lines running vertically in the edit canvas. If
+you zoom too far out, you might see a coarser grid than you
+expect. Ardour tries not to show “too many” or “too few” grid lines
+depending on the zoom level. You might find that items snap in-between
+the grid lines sometimes. That’s expected behavior. If you can’t see
+or snap to the grid you’d like to use, you may have to zoom in or out.
 </p>
 
 <h2>About Snapping</h2>
 
 <p>
-  There are two ways to think about aligning material to a grid. The first and
-  most obvious one is where an object's position is clamped to grid lines. In
-  Ardour, this is called <dfn>absolute snap</dfn> and is commonly used when
-  working with sampled material where audio begins exactly at the beginning of a
-  file, note or region.
+  There are two ways to think about aligning material. The first and
+  most obvious one is where an object's position is clamped to the
+  snap positions. In Ardour, this is called <dfn>absolute snap</dfn>
+  and is commonly used when working with sampled material where audio
+  begins exactly at the beginning of a file, note or region.
 </p>
 
 <p>
-  The second, <dfn>relative snap</dfn>, is used when an object's position relative
-  to the grid lines is important. In music, this allows to move objects around
-  without changing the "feel" (or timing) of a performance.
+  The second, <dfn>relative snap</dfn>, is used when an object's
+  position relative to the snap positions is important. In music, this
+  allows to move objects around without changing the "feel" (or
+  timing) of a performance.
 </p>
 
 <p>
@@ -48,7 +83,7 @@
 </p>
 
 <p>
-  The realtive snap and snap modifiers (along with other modifier keys) may be set
+  The relative snap and snap modifiers (along with other modifier keys) may be set
   in <kbd class="menu">Edit &gt; Preferences &gt; User Interaction</kbd>
 </p>
 
@@ -58,7 +93,7 @@
   otherwise unused key. For example, the snap modifier may be chosen to be the
   <kbd class="mod2n"></kbd> key and the relative snap modifier to be the <kbd
   class="mod2n"></kbd> and <kbd class="mod4n"></kbd> keys.
-</p>.
+</p>
 
 <h2>Snap Modes</h2>
 
@@ -85,7 +120,7 @@
     New objects will always be created at grid
     points.</br>
     Holding down the snap modifier will disable the current grid
-    setting and allow you to move the object freely.</td></tr>
+    setting and allow moving the object freely.</td></tr>
   <tr><th><kbd class="menu">Magnetic</kbd></th>
     <td>is a less strict type of snapping. Objects can still be moved to any
     position, but positions close to the relative or absolute grid points will snap.
@@ -156,3 +191,4 @@
   unusable. This option should not be used in conjunction with the use any of the
   Region grid units.
 </p>
+