View Issue Details

IDProjectCategoryView StatusLast Update
0001479ardourdocumentationpublic2008-11-21 00:33
Reportertimbyr Assigned Totimbyr  
PrioritynormalSeverityminorReproducibilityN/A
Status closedResolutionfixed 
Summary0001479: manual contains two sections about adding tracks to a session.
DescriptionThere are two sections in the manual that describe adding tracks to a session, one is in the Sessions section and the other in the tracks and busses section. There doesn't seem to be any appreciable difference between the two so it looks as if someone wrote one not being aware the other existed.

There is already a adding_tracks.xml file containing one of the sections, I think it would be appropriate to consolidate and improve the two sections and then just XInclude that file from the tracks and busses section.
TagsNo tags attached.

Activities

2007-02-19 14:28

 

adding-tracks.patch (4,207 bytes)   
Index: xml/adding_tracks.xml
===================================================================
--- xml/adding_tracks.xml	(revision 1473)
+++ xml/adding_tracks.xml	(working copy)
@@ -13,33 +13,52 @@
   <itemizedlist>
     <listitem>
       <para>
-        <menuchoice> <guimenu>Session</guimenu> <guisubmenu>Add
+        Choose <menuchoice> <guimenu>Session</guimenu> <guisubmenu>Add
         Track/Bus</guisubmenu> </menuchoice>
       </para>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/add_track_bus.png"/>
+        </imageobject>
+      </mediaobject>
     </listitem>
-  </itemizedlist>
-  <mediaobject>
-    <imageobject>
-      <imagedata fileref="images/add_track_bus.png"/>
-    </imageobject>
-  </mediaobject>
-  <para>
-    In the Add Tracks dialog, choose whether you wish to add a new Track or
-    a new Bus.
-  </para>
 
-  <itemizedlist>
     <listitem>
       <para>
+        Choose whether you wish to add a new Track or a new Bus.
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
         Enter the number of new tracks/busses you want to add.
       </para>
     </listitem>
+
+    <listitem>
+      <para>
+        Choose the channel configuration for the Tracks or Busses you are
+        adding.
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
+        If you are creating a Track choose whether to create a normal track
+        or a Tape Track.
+      </para>
+    </listitem>
   </itemizedlist>
 
-  <para>
-    Choose the I/O configuration of the tracks/busses you are adding using
-    the clickbox.
-  </para>
+  <note>
+    <para>
+      If you choose <literal>Manual Setup</literal> for the channel
+      configuration then the tracks will be created with no inputs and you
+      will have to configure the I/O configuration of the track using the
+      <link linkend="input-output-connections-editor">I/O Connections
+      Editor</link>
+    </para>
+  </note>
 <!--
 	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="Some_Subsection.xml" />
Index: xml/tracks_and_busses.xml
===================================================================
--- xml/tracks_and_busses.xml	(revision 1473)
+++ xml/tracks_and_busses.xml	(working copy)
@@ -16,43 +16,9 @@
       <imagedata fileref="images/signal_flow.png"/>
     </imageobject>
   </mediaobject>
-  <section id="creating-tracks">
-    <title>Creating Tracks</title>
-    <para>
-      Tracks may be added to the session at any time.
-    </para>
-    <orderedlist><title>Creating a new Track</title>
-      <listitem>
-        <para>
-          Choose <menuchoice> <guimenu>Session</guimenu> <guisubmenu>Add
-          Track/Bus</guisubmenu> </menuchoice>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          add_track.ps Add Track Dialog
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          In the Add Tracks dialog, choose whether you wish to add a new
-          Track or a new Bus.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          Enter the number of new tracks/busses you want to add.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          Choose the I/O configuration of the tracks/busses you are adding
-          using the clickbox.
-        </para>
-      </listitem>
-    </orderedlist>
-  </section>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="adding_tracks.xml" />
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="renaming_tracks.xml" />
   <section id="deleting-tracks">
     <title>Deleting Tracks</title>
Index: xml/sessions.xml
===================================================================
--- xml/sessions.xml	(revision 1473)
+++ xml/sessions.xml	(working copy)
@@ -15,8 +15,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="creating_a_new_session.xml" />
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
-		href="adding_tracks.xml" />
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="opening_a_session.xml" />
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="saving_a_session.xml" />
adding-tracks.patch (4,207 bytes)   

timbyr

2007-02-19 14:34

developer   ~0003320

Added a patch that removes one of the two sections on adding tracks and slightly improves the remaining one. This is a fairly minor patch and i'll commit it in a few days if there isn't any negative feedback.

timbyr

2007-02-19 14:34

developer   ~0003321

request for feedback.

timbyr

2007-03-19 02:48

developer   ~0003600

Patch committed svn rev 1620

Issue History

Date Modified Username Field Change
2007-02-08 11:29 timbyr New Issue
2007-02-08 11:30 timbyr Status new => assigned
2007-02-08 11:30 timbyr Assigned To => timbyr
2007-02-19 14:28 timbyr File Added: adding-tracks.patch
2007-02-19 14:34 timbyr Note Added: 0003320
2007-02-19 14:34 timbyr Note Added: 0003321
2007-02-19 14:34 timbyr Status assigned => feedback
2007-03-19 02:48 timbyr Status feedback => resolved
2007-03-19 02:48 timbyr Resolution open => fixed
2007-03-19 02:48 timbyr Note Added: 0003600
2008-11-21 00:33 seablade Status resolved => closed