Rewording still - avoiding 'you's, and a bit of reformating

diff --git a/include/creating-location-markers.html b/include/creating-location-markers.html
index e415fafe3a474208a9631f67ec3d62a6a358f318..ee303cfed1ed8fbe45e3c3dbceba84aa46ff36f7 100644 (file)
--- a/include/creating-location-markers.html
+++ b/include/creating-location-markers.html
@@ -1,26 +1,29 @@
 
 <p>
 
 <p>

-  <dfn>Location Markers</dfn> appear in the <dfn>Locations ruler</dfn> at the top
-  of the timeline. The <dfn>begin</dfn> and <dfn>end</dfn> markers appear
-  automatically, but you can create custom markers at any position in a
+  <dfn>Location Markers</dfn> appear in the <a href="@@ruler">Locations Markers
+  ruler</a> at the top  of the timeline. The green
+  <dfn style="background-color:limegreen;">begin</dfn> and
+  <dfn style="background-color:limegreen;">end</dfn> markers, that define the length of the session, appear
+  automatically, but yellow <span style="background-color:gold;">custom</span> markers can be created at any position in a

   session.
 </p>
 <p>
   session.
 </p>
 <p>

-  To add a marker at the <strong>current playhead position</strong>, press
-  <kbd>Num-&crarr;</kbd> (the Enter key on the numeric  keypad).
-  Alternatively, use <kbd class="menu">Transport &gt; Markers &gt; Add
-  Mark from Playhead</kbd>.
-</p>
-<p>
-  To add a marker at an <strong>arbitrary location</strong> on the timeline,
-  navigate to the desired position, right-click on the Locations ruler and
-  select <kbd class="menu">New Location Marker</kbd>.
-  You can also go to the Editor list, click <kbd class="menu">New
-  Marker</kbd> and use the clock widget to set its position.
+  There are multiple ways to create custom markers at the current playhead position:

 </p>
 </p>

+<ul>
+  <li>using the keyboard shortcut (default is <kbd>Num-&crarr;</kbd>, the <kbd>Enter</kbd> key on the numeric keypad)</li>
+  <li>using the <kbd class="menu">Transport &gt; Markers &gt; Add
+  Mark from Playhead</kbd> menu.</li>
+</ul>
+

 <p>
 <p>

-  For details see
-  <a href="@@the-ranges-and-marks-lists">Ranges &amp; Marks List</a>
-  and <a href="@@editing-clocks">Editing Clocks</a>.
+  Adding a marker at an arbitrary location on the timeline (i.e. not at the playhead
+  position) can also be done either by:

 </p>
 </p>

-
+<ul>
+  <li><kbd class="mouse">right</kbd> clicking in the Location Marker ruler, and
+  selecting <kbd class="menu">New location marker</kbd></li>
+  <li>using the <a href="@@the-ranges-and-marks-lists">Ranges &amp; Marks List</a>,
+  clicking <kbd class="menu">New Marker</kbd> and using the <a href="@@editing-clocks">
+  clock widget</a> to set its position.</li>
+</ul>

diff --git a/include/creating-range-markers.html b/include/creating-range-markers.html
index 5aeaeeb6d790f0a30fe134056dee0a440b9a5f98..a6fcd27da7d302ba619635384fcad21d3ab7b112 100644 (file)
--- a/include/creating-range-markers.html
+++ b/include/creating-range-markers.html
@@ -1,20 +1,31 @@
 
 <p>
 
 <p>

-  <dfn>Range markers</dfn> are essentially two location markers the are grouped
-  together to mark the beginning and end of a section in the timeline.
+  <dfn>Range markers</dfn> are essentially two <a href="@@creating-location-markers">
+  location markers</a> that appear in the <a href="@@ruler">Range Markers ruler</a>,
+  and are grouped together to mark the beginning and end of a section in the timeline.

 </p>
 </p>

+

 <h2>Creating a Range on the timeline</h2>
 <p>
 <h2>Creating a Range on the timeline</h2>
 <p>

-  To create a new <dfn>range</dfn>, right-click on the
-  Ranges ruler at the top of the timeline, then select
-  <kbd class="menu">New Range</kbd>.
-  Two markers with the same name will appear along the ruler.
-  Both marks can be moved along the timeline by clicking and dragging
-  them to the desired location.
+  Creating a new <dfn>range</dfn> can be done by <kbd class="mouse">right</kbd>
+  clicking on the Range Markers ruler at the top
+  of the timeline, then selecting <kbd class="menu">New Range</kbd>. Two markers
+  with the same name and opposign arrows will appear along the ruler.

 </p>
 <p>
   It is also possible to create range markers from a selected range or
 </p>
 <p>
   It is also possible to create range markers from a selected range or

-  region in the Editor window, or to use the <kbd class="menu">Ranges
+  region in the Editor window, or to using the <kbd class="menu">Ranges

   &amp; Marks List</kbd> in the Editor list.
 </p>
 
   &amp; Marks List</kbd> in the Editor list.
 </p>
 

+<h2>Editing a Range</h2>
+<p>
+  Both markers of a range can be independently moved along the timeline by clicking and dragging
+  them to the desired location.
+</p>
+<p>
+  They can also be moved together by <kbd class="mod1n"></kbd> dragging one marker.
+</p>
+<p>
+  See <a href="@@moving-markers">Moving markers</a> for more information.
+</p>

diff --git a/include/marker-context-menu.html b/include/marker-context-menu.html
index bb260b46e183e96f1bfe6a663408fe21bace87fb..438296512bd0b81bd7a8cb7a043ca056f897a319 100644 (file)
--- a/include/marker-context-menu.html
+++ b/include/marker-context-menu.html
@@ -1,7 +1,7 @@
 
 <p>
   <kbd class="mouse">Right</kbd>-clicking a marker in the timeline opens the
 
 <p>
   <kbd class="mouse">Right</kbd>-clicking a marker in the timeline opens the

-  marker context menu. From this menu, you can:
+  marker context menu:

 </p>
 <table class="dl">
   <tr><th>Locate to Here</th>
 </p>
 <table class="dl">
   <tr><th>Locate to Here</th>

diff --git a/include/moving-markers.html b/include/moving-markers.html
index 698f5541a8dea9f2ced3dbf2a3390becd436973e..31a87a0235db74501fedf124e7a9571ab8dff09a 100644 (file)
--- a/include/moving-markers.html
+++ b/include/moving-markers.html
@@ -1,7 +1,7 @@
 
 <h2>Single marker</h2>
 <p>
 
 <h2>Single marker</h2>
 <p>

-  <kbd class="mouse">Left</kbd>-click and drag to move a single marker to a
+  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a

   new location on the timeline.
 </p>
 
   new location on the timeline.
 </p>
 


@@ -15,12 +15,12 @@
 </p>
 <p class="note">
   The markers are bounded by the zero point on
 </p>
 <p class="note">
   The markers are bounded by the zero point on

-  the timeline. In other words, the first marker in your selection cannot move
+  the timeline. In other words, the first marker in the selection cannot move

   to the left of zero on the timeline.
 </p>
 
 <h2>Both ends of a range marker</h2>
 <p>
   to the left of zero on the timeline.
 </p>
 
 <h2>Both ends of a range marker</h2>
 <p>

-  <kbd class="mod1 mouse">Left</kbd>-drag either end of the range marker. The
+  By <kbd class="mod1 mouse">left</kbd>-dragging either end of the range marker, the

   other end will move by the same distance.
 </p>
   other end will move by the same distance.
 </p>