]> Shamusworld >> Repos - ardour-manual-diverged/commitdiff
Sync with master branch. master
authorShamus Hammons <jlhamm@acm.org>
Mon, 16 Jan 2017 21:39:25 +0000 (15:39 -0600)
committerShamus Hammons <jlhamm@acm.org>
Mon, 16 Jan 2017 21:39:25 +0000 (15:39 -0600)
Now synchronized with commit 4a898e4a87ba100ac4c6dde0fceecc718cca8060.

explode
explode.cpp
master-doc.txt
source/css/app.css

diff --git a/explode b/explode
index ff2bd23ba167ed6457ff73ce4bfcf8b9cb4755b0..e932d12a840f8f0f14997f69a9b055a250283b0f 100755 (executable)
Binary files a/explode and b/explode differ
index 7d5cc3246853f4e0e3b3513127f0205a46e665e3..3124819e0ccb0995d4dddd795e0c2a89872bf24a 100644 (file)
@@ -6,6 +6,8 @@
 // (C) 2017 Underground Software
 //
 
+// still need a fix for titles with the same name...
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -21,7 +23,7 @@ int lineCount = 0, startLine, sectionLineCount, fileCount = 0;
 int part = 0, chapter = 0, subchapter = 0;
 bool first = true;
 bool nomove = false;
-FILE * newFile = NULL;
+FILE * newFile = NULL, * master = NULL, * exp = NULL;
 char level1File[1024], level2File[1024], level3File[1024], temp[1024];
 char partFN[1024], chapterFN[1024], scLink[4096];
 
@@ -107,6 +109,24 @@ bool ParseHeader(FILE * file)
 }
 
 
+//
+// Restore the master document back to its pre-run state
+//
+void HandleFailure(void)
+{
+       // Close open files...
+       fclose(master);
+       fclose(exp);
+
+       if (newFile)
+               fclose(newFile);
+
+       // Remove our work, and restore the backup of the master document
+       remove("master-doc.txt");
+       rename("master-doc.bak", "master-doc.txt");
+}
+
+
 int main(int argc, char * argv[])
 {
        // First, check to see if this has been run here already.
@@ -124,7 +144,7 @@ int main(int argc, char * argv[])
        rename("master-doc.txt", "master-doc.bak");
 
        // Then open the .bak file
-       FILE * master = fopen("master-doc.bak", "r");
+       master = fopen("master-doc.bak", "r");
 
        if (master == NULL)
        {
@@ -133,7 +153,7 @@ int main(int argc, char * argv[])
        }
 
        // Create new master document
-       FILE * exp = fopen("master-doc.txt", "w");
+       exp = fopen("master-doc.txt", "w");
 
        if (exp == NULL)
        {
@@ -153,6 +173,7 @@ int main(int argc, char * argv[])
                if (strncmp(buffer, "---", 3) == 0)
                {
                        // Reset the "short" title, include file & sytle
+                       title[0] = 0;
                        shortTitle[0] = 0;
                        inclFile[0] = 0;
                        style[0] = 0;
@@ -161,7 +182,15 @@ int main(int argc, char * argv[])
                        if (!ParseHeader(master))
                        {
                                printf("Something went horribly wrong with the header parsing! Aborting!\n");
-                               break;
+                               HandleFailure();
+                               return -1;
+                       }
+
+                       if (strlen(title) == 0)
+                       {
+                               printf("Header is missing a 'title:' section, aborting!\n");
+                               HandleFailure();
+                               return -1;
                        }
 
                        // Close any previously opened files...
index 7e878684f2cf872b5938bd2e41024e88f58bd9de..a58424da1aadde4933b0ad235df52253fc420b57 100644 (file)
@@ -4204,47 +4204,6 @@ title: About Ardour's Interface
 part: chapter
 ---
 
-<p>
-  In Ardour, you work in two main windows: the <dfn>Editor</dfn> and the
-  <dfn>Mixer</dfn>.
-</p>
-
-<figure>
-  <img src="/images/global-editor-window-split.png" alt="Ardour's editor window">
-  <img style="margin-left:2em;" src="/images/global-mixer-window-split.png" alt="Ardour's mixer window">
-  <figcaption>
-  <ol class="multicol3">
-    <li>Main menu</li>
-    <li>Status bar</li>
-</ol><ol class="multicol3" start="3">
-    <li>Transport bar & Times</li>
-    <li>Mode switch</li>
-</ol><ol class="multicol3" start="5">
-    <li>The <dfn>Mixer</dfn> window</li>
-    <li>The <dfn>Editor</dfn> window</li>
-  </ol>
-  </figcaption>
-</figure>
-
-<p>
-  Switching between the Editor and the Mixer windows done:
-</p>
-
-<ul>
-  <li>with the Mode Switch buttons (#4 in the screenshot) in the upper right</li>
-  <li>with the <kbd class="mod2">M</kbd> shortcut</li>
-  <li>with the menu <kbd class="menu">Window &gt; Editor <em>(or Mixer)</em> &gt; Show</kbd>.</li>
-</ul>
-
-<p>
-  Both windows can be visible at the same time (eg. for a multi-monitor
-  setup) using <kbd class="menu">Window &gt; Editor <em>(or Mixer)</em> &gt; Detach</kbd> option in the same submenu.
-</p>
-
-<hr>
-
-<p class="fixme">Which of these two should be there? They seem to have the same content&hellip;</p>
-
 <p>
   In Ardour, you work in two main windows: the <dfn>Editor</dfn> and the <dfn>Mixer</dfn>. 
 </p>
@@ -4283,7 +4242,523 @@ title: Main Menu
 part: chapter
 ---
 
-<p class="fixme">Add content</p>
+
+---
+title: The Session Menu
+part: subchapter
+---
+
+<p>
+  The <kbd class="menu">Session</kbd> menu groups together everything related to the session and the file operations.
+</p>
+
+<dl>
+       <dt>New...</dt><dd>Creates a <a href="/working-with-sessions/new-session-dialog/">new</a> session</dd>
+       <dt>Open...</dt><dd>Opens an existing session</dd>
+       <dt>Recent...</dt><dd>Opens a list of recent session that can be opened</dd>
+       <dt>Close</dt><dd>Closes the current session (but not Ardour)</dd>
+
+       <dt>Save</dt><dd>Saves the current session</dd>
+       <dt>Save As...</dt><dd>Saves to a new session (with options)</dd>
+       <dt>Rename...</dt><dd>Changes the name of the session</dd>
+       <dt>Snapshot (keep working on current version) ...</dt><dd>Create a <a href="/working-with-sessions/snapshots/">Snapshot</a> but any subsequent change will be saved to this session</dd>
+       <dt>Snapshot ( switch to new version) ...</dt><dd>Same thing, and any subsequent change will be saved to this new snapshot session</dd>
+       <dt>Save Template...</dt><dd>Saves the session as a <a href="/working-with-sessions/session-templates/">template</a>, without the audio</dd>
+       <dt>Metadata</dt>
+               <dt class="sub1">Edit Metadata...</dt><dd>Opens the <a href="/working-with-sessions/metadata/">Metadata</a> window, where informations about the session can be saved</dd>
+               <dt class="sub1">Import Metadata...</dt><dd>Creates the metadata by extracting them from another session</dd>
+
+       <dt>Add Track, Bus or VCA...</dt><dd>Adds a <a href="/working-with-tracks/adding-tracks-and-busses/">new track/bus/VCA</a> to the session, same as the <kbd class="menu">Track &gt; Add Track, Bus or VCA...</kbd></dd>
+
+       <dt>Import</dt><dd>Opens the <a href="/adding-pre-existing-material/">Import</a> windows, to add media to the session</dd>
+       <dt>Import PT session</dt><dd>Import a ProTools&copy; session file. Not everything in the original session can be imported.</dd>
+       <dt>Scripting</dt>
+               <dt class="sub1">Add Lua Script...</dt><dd>Loads or adds a <a href="/lua-scripting/">Lua Session script</a> to the current session</dd>
+               <dt class="sub1">Remove Lua Script</dt><dd>Removes a loaded Lua Session script from the session</dd>
+       <dt>Open Video...</dt><dd>Imports a <a href="/video-timeline/">video file</a> in the session</dd>
+       <dt>Remove Video</dt><dd>Removes the video part of the session (the video timeline disappears)</dd>
+       <dt>Export</dt>
+               <dt class="sub1">Export to Audio File(s)...</dt><dd><a href="/exporting/">Export</a> all or part of the session in audio form</dd>
+               <dt class="sub1">Stem export...</dt><dd><a href="/exporting/export-dialog/">Exports each track</a> as its own audio file (for e.g. DAW interchange)</dd>
+               <dt class="sub1">Export to Video File</dt><dd>Exports the session to a <a href="/video-timeline/operations/">video file</a></dd>
+       <dt>Clean-Up</dt>
+               <dt class="sub1">Bring all media into session folder</dt><dd>Copies all the media files imported from outside the session folder in that folder, see <a href="/working-with-sessions/cleaning_up/">Cleaning up Sessions</a></dd>
+               <dt class="sub1">Reset Peak Files</dt><dd>Reinitializes the buffered images representing the audio files</dd>
+               <dt class="sub1">Clean-up Unused Sources...</dt><dd>Quarantines all the media files not used in the session to a specific subfolder of the session</dd>
+               <dt class="sub1">Flush Wastebasket</dt><dd>Deletes those quarantined files</dd>
+
+       <dt>[] Properties</dt><dd>Shows the <a href="/preferences-and-session-properties/session-properties-dialog/">Session Properties</a> dialog, allowing to fine-tune the parameters of the current session</dd>
+
+       <dt>Lock</dt><dd>Locks the session by showing an Unlock window that (until cliked) blocks every action on Ardour's window</dd>
+
+       <dt>Quit</dt><dd>Exits Ardour. Prompts for saving the session if it has been modified.</dd>
+</dl>
+
+---
+title: The Transport Menu
+part: subchapter
+---
+
+<p>
+       The <dfn>Transport</dfn> menu handles how Ardour handles the playback and playhead.
+</p>
+
+<dl>
+       <dt>Start/Stop</dt><dd>Starts or stops the playhead, and recording if it's armed</dd>
+       <dt>Play</dt>
+               <dt class="sub1">Play Selection</dt><dd>Only plays the selected part of the session, be it a range or selected regions</dd>
+               <dt class="sub1">Play Selection w/Preroll</dt><dd>As the previous menu, except it starts the playback 1/2 bar before the beginning of the selection</dd>
+               <dt class="sub1">Start/Continue/Stop</dt><dd>FIXME</dd>
+               <dt class="sub1">Play from Edit Point and Return</dt><dd>Starts the playback at the <a href="/ardours-interface/the-editor/the-toolbar/the-edit-point-control/">Edit point, and when stopped, goes back to the orginial location</a></dd>
+               <dt class="sub1">Play Loop Range</dt><dd>If a <a href="/working-with-markers/loop-range/">Loop range</a> is defined, play it and loop until stopped</dd>
+       <dt>Start Recording</dt><dd>This is a shortcut to trigger the global recording, and start playback at once</dd>
+       <dt>Stop and Forget Capture</dt><dd>Stops the recording, removes the newly created material, and goes back to the original position</dd>
+       <dt>Enable Record</dt><dd>Triggers the global recording. Next time "Play" is pressed, it will record on the track(s) that are armed for recording</dd>
+
+       <dt>Set Loop from Selection</dt><dd>Converts the selection into a <a href="/working-with-markers/loop-range/">Loop range</a> by placing loop markers at the start and end of the selected range</dd>
+       <dt>Set Punch from Selection</dt><dd>Same thing, for <a href="/working-with-markers/punch-range/">Punch</a></dd>
+       <dt>Set Session Start/End from Selection</dt><dd>Same thing, for the start and end markers of the session, defining the sessions length</dd>
+
+       <dt>Forward</dt><dd>FIXME</dd>
+       <dt>Rewind</dt><dd>Plays the audio backwards from the playhead on</dd>
+       <dt>Transition to Roll</dt><dd>FIXME</dd>
+       <dt>Transition to Reverse</dt><dd>FIXME</dd>
+
+       <dt>Playhead</dt><dd></dd>
+               <dt class="sub1">Playhead to Mouse</dt><dd>Set the position of the playhead at the current position of the mouse cursor</dd>
+               <dt class="sub1">Playhead to Active Mark</dt><dd>If a marker is selected, set the position of the playhead at the position of the marker</dd>
+               <dt class="sub1">Center Playhead</dt><dd>Centers the view on the playhead without changing the zoom level (putting the playhead in the middle of the screen)</dd>
+
+               <dt class="sub1">Nudge Playhead Forward</dt><dd>Shifts the position of the playhead to the right by the amount shown in the <a href="/ardours-interface/the-editor/the-toolbar/the-nudge-controls/">nudge timer</a></dd>
+               <dt class="sub1">Nudge Playhead Backward</dt><dd>Same thing, to the left</dd>
+
+               <dt class="sub1">Move to Next Transient</dt><dd>When transient have been set, moves the playhead to the next one to the right</dd>
+               <dt class="sub1">Move to Previous Transient</dt><dd>Same, to the left</dd>
+
+               <dt class="sub1">Playhead to Next Grid</dt><dd>Regardless of the state of the Grid Mode, goes to the next grid to the right, as set by the <a href="/ardours-interface/the-editor/the-toolbar/the-grid-controls/">Snap/Grid unit</a></dd>
+               <dt class="sub1">Playhead to Previous Grid</dt><dd>Same, to the left</dd>
+
+               <dt class="sub1">Playhead to Next Region Boundary</dt><dd>Moves the playhead to the right to the next beginning or end of region on the selected track or, if no track is selected, on all tracks</dd>
+               <dt class="sub1">Playhead to Previous Region Boundary</dt><dd>Same, to the left</dd>
+               <dt class="sub1">Playhead to Next Region Boundary (No Track Selection)</dt><dd>Moves the playhead to next beginning or end of region, be it on the selected track or any other</dd>
+               <dt class="sub1">Playhead to Previous Region Boundary (No Track Selection)</dt><dd>Same, to the left</dd>
+               <dt class="sub1">Playhead to Next Region Sync</dt><dd>Moves the playhead to next Region Sync Point, that is by default the beginning of a region but <a href="/ardours-interface/the-editor/the-toolbar/the-grid-controls/">can be moved</a></dd>
+               <dt class="sub1">Playhead to Previous Region Sync</dt><dd>Same, to the left</dd>
+
+               <dt class="sub1">Jump to Next Mark</dt><dd>moves the playhead to the next <a href="/working-with-markers/creating-location-markers/">marker</a> on the Ruler</dd>
+               <dt class="sub1">Jump to Previous Mark</dt><dd>Same, to the left</dd>
+
+               <dt class="sub1">Go to Zero</dt><dd>Sends the playhead to the 00:00:00:00 time, regardless of the sessions Start marker</dd>
+               <dt class="sub1">Go to Start</dt><dd>Sends the playhead to the Start marker of the session</dd>
+               <dt class="sub1">Go to End</dt><dd>Sends the playhead to the End marker of the session</dd>
+               <dt class="sub1">Go to Wall Clock</dt><dd>Sends the playhead to the current value of system time, as shown on the top right of the <a href="/ardours-interface/status-bar/">Status bar</a></dd>
+       <dt>Active Mark</dt>
+               <dt class="sub1">To Next Region Boundary</dt><dd>Moves the currently selected <a href="/working-with-markers/">marker</a> to the next region beginning or end</dd>
+               <dt class="sub1">To Previous Region Boundary</dt><dd>Same, to the left</dd>
+               <dt class="sub1">To Next Region Sync</dt><dd>Moves the currently selected to the next region sync point (by default : beginning or end of the region)</dd>
+               <dt class="sub1">To Previous Region Sync</dt><dd>Same, to the left</dd>
+       <dt>Markers</dt><dd></dd>
+               <dt class="sub1">Add Mark from Playhead</dt><dd>Creates a Marker at he position of the playhead</dd>
+               <dt class="sub1">Remove Mark at Playhead</dt><dd>Removes any marker at the position of the playhead</dd>
+               <dt class="sub1">Toggle Mark at Playhead</dt><dd>Combine the 2 previous : if a marker exists, deletes it, otherwise create it</dd>
+
+               <dt class="sub1">Locate to Mark <em>n</em></dt><dd>If it exists, goes to the <em>n-th</em> marker</dd>
+
+               <dt class="sub1">Set Session Start from Playhead</dt><dd>Puts the Start of the session marker at the playhead's position</dd>
+               <dt class="sub1">Set Session End from Playhead</dt><dd>Puts the End of the session marker at the playhead's position</dd>
+
+       <dt>[] Time Master</dt><dd>Sets Ardour as the Time master, i.e. Ardour sends the time information to the audio system</dd>
+       <dt>[] Punch In/Out</dt><dd>Based on the Punch in and Punch out markers if they exist, tells Ardour to record only between those two points</dd>
+       <dt>[] Punch In</dt><dd>Based on the Punch in marker, only allow to record from this point on</dd>
+       <dt>[] Punch Out</dt><dd>Based on the Punch out marker, forbids recording before this point</dd>
+       <dt>[] Audio Input</dt><dd>If checked, automatically switch the <a href="/recording/monitoring/monitor-setup-in-ardour/">monitor</a> from <em>input</em> to <em>playback</em>mode when playing</dd>
+       <dt>[] Follow Edits</dt><dd>If checked, selecting a region moves the playhead to its beginning</dd>
+       <dt>[] Auto Play</dt><dd>If checked, moving the playhead in the ruler starts the playback</dd>
+       <dt>[] Auto Return</dt><dd>If checked, when the playback is stopped, go back to the previous position of the playhead. If not, the playhead stays where it is when the playback is stopped</dd>
+       <dt>[] Click</dt><dd>Activates/desactivates the click track (metronome)</dd>
+       <dt>[] Follow Playhead</dt><dd>If checked, while playing, when the playhead reaches the right of the screen, Ardour scrolls one screen to the right to keep the playhead visible at all times</dd>
+       <dt>[] Stationary Playhead</dt><dd>If checked <em>and</em> if <kbd class="menu">Follow playhead</kbd> is checked, on playback, the playhead stays at the center of the screen, and the session scrolls</dd>
+       <dt>Panic</dt><dd>Immediately stops all MIDI playback (usefull e.g. when a MIDI bug in encountered)</dd>
+</dl>
+
+---
+title: The Edit Menu
+part: subchapter
+---
+
+<p>
+       The <dfn>Edit</dfn> menu groups together the actions related to the edition, and so will be mostly used while in Editor mode.
+</p>
+
+<dl>
+       <dt>Undo (<em>action</em>)</dt><dd>Reverts the last editing operation, namely <em>action</em></dd>
+       <dt>Redo</dt><dd>Does the last editing operation again, after an Undo</dd>
+
+       <dt>Undo Selection Change</dt><dd>Reverts the last selection operation</dd>
+       <dt>Redo Selection Change</dt><dd>Does the last selection operation again after an Undo Selection Change</dd>
+
+       <dt>Cut</dt><dd>Deletes the current selection, but puts it in memory ready to be pasted</dd>
+       <dt>Copy</dt><dd>Copies the current selection to memory</dd>
+       <dt>Paste</dt><dd>Pastes the memory at the <a href="/ardours-interface/the-editor/the-toolbar/the-edit-point-control/">edit point</a>, after a Cut or Copy operation</dd>
+
+       <dt>Select</dt>
+               <dt class="sub1">Select All Objects</dt><dd>Selects all the regions and automation pints in the session</dd>
+               <dt class="sub1">Select All Tracks</dt><dd>Selects all the tracks, busses and control masters in the session</dd>
+               <dt class="sub1">Deselect All</dt><dd>Deselects all objects or tracks, nothing is selected</dd>
+               <dt class="sub1">Invert Selection</dt><dd>Select the previously unselected regions, and deselect the previously selected ones</dd>
+
+               <dt class="sub1">Set Range to Loop Range</dt><dd>Creates a range selection on the selected tracks, based on the selected loop markers, and switches to <a href="/ardours-interface/the-editor/the-toolbar/the-toolbox/">Range Mode tool</a></dd>
+               <dt class="sub1">Set Range to Punch Range</dt><dd>Same as above, based on the selected punch markers</dd>
+               <dt class="sub1">Set Range to Selected Regions</dt><dd>Same as above, based on the selected regions (i.e. from the start of the earliest region to the end of the latest one)</dd>
+
+               <dt class="sub1">Select All After Edit Point</dt><dd>Select all the regions and automation points that exist after the Edit Point, even if the region starts before it. If some tracks are selected, only selects on these tracks.</dd>
+               <dt class="sub1">Select All Before Edit Point</dt><dd>Same as above, but before the Edit point (i.e. to the left of it)</dd>
+               <dt class="sub1">Select All Overlapping Edit Range</dt><dd>Select all the regions and automation points of which at least a part is in the current selection range</dd>
+               <dt class="sub1">Select All Inside Edit Range</dt><dd>Selects all the regions that are completely inside the selection range, i.e. their start and end are inside the range. If some tracks are selected, only selects on these tracks.</dd>
+               <dt class="sub1">Select All in Punch Range</dt><dd>Selects all the regions of which a part in in the punch range. If some tracks are selected, only selects on these tracks.</dd>
+               <dt class="sub1">Select All in Loop Range</dt><dd>Same as above, based on the loop range</dd>
+
+               <dt class="sub1">Move Range Start to Previous Region Boundary</dt><dd>Extends the left boundary of the range to the left to the next region start or end. The region must be in the range.</dd>
+               <dt class="sub1">Move Range Start to Next Region Boundary</dt><dd>Same as above, to the right (reduces the selection)</dd>
+               <dt class="sub1">Move Range End to Previous Region Boundary</dt><dd>Same as above, with the right edge of the range, to the left (reduces the selection)</dd>
+               <dt class="sub1">Move Range End to Next Region Boundary</dt><dd>Same as above, with the right edge, to the right (extends the selection)</dd>
+
+               <dt class="sub1">Start Range</dt><dd>Sets the left edge of the range to the Edit point</dd>
+               <dt class="sub1">Finish Range</dt><dd>Sets the right edge of the range to the Edit point</dd>
+
+               <dt class="sub1">Select Next Track or Bus</dt><dd>Select the track or bus under the currently selected one. If multiple tracks are selected, only the first one is considered</dd>
+               <dt class="sub1">Select Previous Track or Bus</dt><dd>Same as above, with the track/bus above the first one selected.</dd>
+
+       <dt>Delete</dt><dd>Deletes all that is currently selected</dd>
+       <dt>Crop</dt><dd>Cuts the parts of the regions that are outside the range boundaries. Only applies on the regions that belong at least in part to the range.</dd>
+       <dt>Split/Separate</dt><dd>Cuts the selected regions at the Edit point, separating them in two regions</dd>
+       <dt>Separate</dt>
+               <dt class="sub1">Separate Under</dt><dd>Removes all the parts of the regions that are under the selected one. Once done, the selected region is alone on its part of the track.</dd>
+               <dt class="sub1">Separate Using Loop Range</dt><dd>Cuts the selected regions or the regions on the selected tracks along the Loop range's start and end markers. If nothing is selected, acts on all tracks at once.</dd>
+               <dt class="sub1">Separate Using Punch Range</dt><dd>Same as above, with the Punch range markers</dd>
+       <dt>Align</dt>
+               <dt class="sub1">Align Start</dt><dd>Moves the selected regions to align the beginning of the regions to the Edit point</dd>
+               <dt class="sub1">Align Start Relative</dt><dd>When multiple regions are selected, moves all the regions together as a block to align the beginning of the earliest one to the Edit point.</dd>
+               <dt class="sub1">Align End</dt><dd>Moves the selected regions to align the end of the regions to the Edit point</dd>
+               <dt class="sub1">Align End Relative</dt><dd>When multiple regions are selected, moves all the regions together as a block to align the end of the latest one to the Edit point.</dd>
+               <dt class="sub1">Align Sync</dt><dd>Moves the selected regions to align the Sync point of the regions to the Edit point</dd>
+               <dt class="sub1">Align Sync Relative</dt><dd>When multiple regions are selected, moves all the regions together as a block to align the earliest Sync point to the Edit point.</dd>
+       <dt>Fade</dt>
+               <dt class="sub1">Fade Range Selection</dt><dd>For all the regions that either begin or end in the range, create a fade in or out on the regions length.</dd>
+               <dt class="sub1">Set Fade In Length</dt><dd>If the edit point is withing the region boundaries, adjusts selected audio regions' fade in to end at the edit point.</dd>
+               <dt class="sub1">[] Fade In</dt><dd>Toggles the fade in on the selected region on or off</dd>
+               <dt class="sub1">Set Fade Out Length</dt><dd>Same as above, for the fade out</dd>
+               <dt class="sub1">[] Fade Out</dt><dd>Toggles the fade out on the selected region on or off</dd>
+
+       <dt>Remove Last Capture</dt><dd>Destroy the last recording. A prompt reminds the user this <em>cannot</em> be undone.</dd>
+
+       <dt>Edit point</dt>
+               <dt class="sub1">Change Edit Point</dt><dd>Toggles between the mouse and the playhead as the Edit point</dd>
+               <dt class="sub1">Change Edit Point Including Marker</dt><dd>Toggles between the mouse, the playhead and marker as the Edit point</dd>
+       <dt>Snap Mode</dt>
+               <dt class="sub1">() No Grid</dt><dd>Disables <a href="/ardours-interface/the-editor/the-toolbar/the-grid-controls/">snapping</a>, i.e. allows free movement of regions and boundaries</dd>
+               <dt class="sub1">() Grid</dt><dd>Forces snapping, so any move of region boundary will be lined to the grid as chosen</dd>
+               <dt class="sub1">() Magnetic</dt><dd>If the movement of the region or boundary happens near a grid line, snaps, otherwise, allow free movement</dd>
+
+               <dt class="sub1">Next Snap Mode</dt><dd>Toggles between the No Grid, Grid and Magnetic snap modes</dd>
+               <dt class="sub1">Next Snap Choice</dt><dd>Circles through the snap choices, as detailed below</dd>
+               <dt class="sub1">Previous Snap Choice</dt><dd>Circles through the snap choices, as detailed below, in reverse order</dd>
+               <dt class="sub1">Next Musical Snap Choice</dt><dd>Circles through the musical snap choices, e.g. those expressed in bars and beats</dd>
+               <dt class="sub1">Previous Musical Snap Choice</dt><dd>Same as previous, but in reverse order</dd>
+       <dt>Snap To</dt>
+               <dt class="sub1">Snap to CD Frame</dt><dd>The grid unit will be 1/75th of a second</dd>
+               <dt class="sub1">Snap to Timecode Frame/Second/Minute</dt><dd>The grid unit will be based on the timecode settings for the session</dd>
+               <dt class="sub1">Snap to Second/Minute</dt><dd>The grid unit will be based on absolute times</dd>
+               <dt class="sub1">Snap to <em>n</em>th</dt><dd>The grid unit will be 1/<em>n</em> beats and will depend on the tempo and meter in effect at that point in the timeline.</dd>
+               <dt class="sub1">Snap to Beat</dt><dd>Same as above, whole beat</dd>
+               <dt class="sub1">Snap to Bar</dt><dd>Same as above, whole bar</dd>
+               <dt class="sub1">Snap to Mark</dt><dd>The grid will be made of markers</dd>
+               <dt class="sub1">Snap to Region Start</dt><dd>No grid, the regions will snap to the closest region start on any track</dd>
+               <dt class="sub1">Snap to Region End</dt><dd>Same as above with the regions' ends</dd>
+               <dt class="sub1">Snap to Regions Sync</dt><dd>Same as above, with the Sync points (by default, start of the region)</dd>
+               <dt class="sub1">Snap to Region Boundaries</dt><dd>Same as above, for both the starts and ends of regions</dd>
+
+       <dt>Tempo</dt><dd></dd>
+               <dt class="sub1">Set Tempo from Region = Bar</dt><dd>Computes the tempo so that the duration of the first selected region is 1 bar. Ardour prompts if the user wants it to be the global tempo, or a tempo marker at the beginning of the region used</dd>
+               <dt class="sub1">Set Tempo from Edit Range = Bar</dt><dd>Same thing, with the current Range instead of a region</dd>
+       <dt>[] Smart Object Mode</dt><dd>Toggles the Smart Mode, allowing the mouse to be in Range Mode in the upper half of a region, and in Grab Mode in the lower half</dd>
+
+       <dt>Scripted Actions</dt><dd></dd>
+               <dt class="sub1">[] Script Manager</dt><dd>Shows the <a href="/lua-scripting/">Script manager</a>, allowing to use and manage the Lua scripts in the session</dd>
+
+               <dt class="sub1">Unset #<em>n</em></dt><dd>Desactivate the <em>n</em>th script</dd>
+
+       <dt>Preferences</dt><dd>Displays the <a href="/preferences-and-session-properties/preferences-dialog/">Preferences</a> panels, allowing to change Ardour's behaviour</dd>
+</dl>
+
+---
+title: The Region Menu
+part: subchapter
+---
+
+<p>
+       The <kbd class="menu">Region</kbd> Menu is where the user can tweak its regions, the parts of audio or MIDI that sit on the timeline.
+</p>
+
+<dl>
+       <dt>Insert Region from Region List</dt><dd>If a region is selected in the Editor List, add it at the Edit point</dd>
+       <dt>Play</dt><dd>Starts playback at the beginning of the selected region(s), and stops at its(their) end</dd>
+       <dt>Loop</dt><dd>Creates a loop range on the selected region's boundaries, and starts the looped playback</dd>
+       <dt>Rename...</dt><dd>Changes the name of the region, that appears in its top left area</dd>
+       <dt>Properties...</dt><dd>Shows the <kbd class="menu">Region properties</kbd> window, that displays detailed information about the region and allow for some modifications</dd>
+       <dt>Loudness Analysis...</dt><dd>Shows the <kbd class="menu">Audio Report/Analysis</kbd> window, that displays detailed <a href="/meters/">dBFS information</a> as well as a spectrogram (dBFS of frequency against time)</dd>
+       <dt>Spectral Analysis...</dt><dd>Shows the <kbd class="menu">Audio Report/Analysis</kbd> window, that displays a integrated spectral view of the region (dBFS agaisnt frequency)</dd>
+       <dt>Edit</dt>
+               <dt class="sub1">Combine</dt><dd>Creates a new region by joining the selected audio regions in the same track, and replaces those region with the newly created compound. The same rules are applied to create the compound as for playback regarding e.g. layering</dd>
+               <dt class="sub1">Uncombine</dt><dd>Splits back the compound created by <em>combining</em> into its original audio regions</dd>
+               <dt class="sub1">Pitch Shift...</dt><dd>Changes the tune of the audio region, by octave, semitones or percentage, based on spectral analysis. Optionaly, and if they have been set for the region, preserves the formants</dd>
+               <dt class="sub1">Split/Separate</dt><dd>Cuts the selected regions at the Edit point, separating them in two regions</dd>
+               <dt class="sub1">Split at Percussion Onset</dt><dd>Allows splitting the selected regions on its PErcussion Onsets marker as set by the Rhythm Ferret (Not usable as of 5.5)</dd>
+               <dt class="sub1">Make Mono Regions</dt><dd>Creates mono regions out of a stereo or multichannel region by splitting it into its discrete channels. The created regions are added to the Editor List</dd>
+               <dt class="sub1">Close Gaps</dt><dd>Extends (or reduces) the selected regions to be perfecltly aligned. Optionnaly, sets up a crossfade duration, or a pull-back (spacing between regions)</dd>
+               <dt class="sub1">Place Transient</dt><dd>Places a transient at the Edit Point. Used e.g. for the <kbd class="menu">Pitch Shift...</kbd> action</dd>
+               <dt class="sub1">Rhythm Ferret...</dt><dd>Opens the <kbd class="menu">Rhythm Ferret</kbd> which is a powerfull tool to sequence audio files</dd>
+               <dt class="sub1">Strip Silence...</dt><dd>Opens the <kbd class="menu">Strip Silence</kbd> window which is a very handy tool to remove all audio under a user-chosen threshold (with a preview)</dd>
+               <dt class="sub1">Reverse</dt><dd>Mirrors the audio horizontally</dd>
+       <dt>Layering</dt>
+               <dt class="sub1">Raise to Top</dt><dd>On overlapping regions, puts the selected one(s) on top</dd>
+               <dt class="sub1">Raise</dt><dd>On overlapping region, makes the selected one(s) one layer higher</dd>
+               <dt class="sub1">Lower</dt><dd>Makes the selected region(s) one layer lower</dd>
+               <dt class="sub1">Lower to Bottom</dt><dd>Sends the selected region to the background</dd>
+       <dt>MIDI</dt>
+               <dt class="sub1">Transpose...</dt><dd>On a MIDI region, shows the <a href="/editing-and-arranging/edit-midi/transpose-midi/"><kbd class="menu">Transpose MIDI</kbd> window</a>, allowing to shift the pitch of the whole MIDI region by &plusmn; <em>n</em> semitones or octaves</dd>
+               <dt class="sub1">Insert Patch Change...</dt><dd>Inserts a patch change at the Edit Point, allowing a change of patch, channel, program and/or bank</dd>
+               <dt class="sub1">Quantize...</dt><dd>Shows the <a href="/editing-and-arranging/edit-midi/quantize-midi/"><kbd class="menu">Quantize</kbd> window</a>, allowing to perfectly align the MIDI notes to the musical grid</dd>
+               <dt class="sub1">Legatize</dt><dd>Shortens or elongates the MIDI notes to make them perfectly sequentials, i.e. the end of a note is the start of the following one</dd>
+               <dt class="sub1">Remove Overlap</dt><dd>FIXME Shortens or elongates the MIDI notes to make them perfectly sequentials, i.e. the end of a note is the start of the following one</dd>
+               <dt class="sub1">Transform...</dt><dd><a href="/editing-and-arranging/edit-midi/transformation-midi/"><kbd class="menu">Transform</kbd> window</a>, that allows for mathematical operations on the midi notes</dd>
+               <dt class="sub1">Unlink from Other copies</dt><dd>Makes the selected MIDI region independant, e.g. editing this region won't affect any other one.</dd>
+               <dt class="sub1">List Editor...</dt><dd>Shows the <kbd class="menu">List Editor</kbd> which sequentially lists all the MIDI events in the region, and allows for precise modifications</dd>
+       <dt>Gain</dt>
+               <dt class="sub1">[] Opaque</dt><dd>When checked, makes the region opaque audio-wise, i.e., the underlying regions won't be audible</dd>
+               <dt class="sub1">[] Mute</dt><dd>When checked, mutes <em>only</em> the selected region on the track, without muting the track. The muted regions will have <em>!!</em> prepended to their name and will be semi-transparent</dd>
+               <dt class="sub1">Normalize...</dt><dd>Shows the <kbd class="menu">Normalize region</kbd> dialog, which allows to scale the region level by setting its maximum level, optionaly constraining the RMS</dd>
+               <dt class="sub1">Boost Gain</dt><dd>Increases the gain on the selected region by boosting the audio, without touching the enveloppe or automation</dd>
+               <dt class="sub1">Cut Gain</dt><dd>Reduces the gain without touching the enveloppe or automation</dd>
+               <dt class="sub1">Reset Envelope</dt><dd>If the gain enveloppe has been edited, resets it to its initial value (constant at 0 dB)</dd>
+               <dt class="sub1">[] Envelope Active</dt><dd>When unchecked, disables any enveloppe editing that has been made. The enveloppe will be displayed in yellow instead of green.</dd>
+       <dt>Position</dt>
+               <dt class="sub1">Move to Original Position</dt><dd>Moves the region where it was initially recorded or inserted in the session</dd>
+               <dt class="sub1">Snap Position to Grid</dt><dd>If the Grid Mode is set to <em>Grid</em>, snaps the region to the nearest grid line</dd>
+               <dt class="sub1">[] Lock</dt><dd>Blocks the selected regions at their current positions in time and tracks, avoiding any movement on the timeline. The region name will be surrounded by <em>&gt;</em> and <em>&lt;</em> brackets</dd>
+               <dt class="sub1">[] Glue to Bars and Beats</dt><dd>Locks the region position to relative to the musical grid, i.e. a change of tempo will move the region to keep it on the same bar/beat</dd>
+               <dt class="sub1">[] Lock to Video</dt><dd>Same as above, relative to the position in the video</dd>
+               <dt class="sub1">Set Sync Position</dt><dd>Creates or move the Sync position, i.e. the point of the region that will be aligned or snapped to the grid, and that is (by default) the beggining of the region.</dd>
+               <dt class="sub1">Remove Sync</dt><dd>Removes any user defined Sync point, and resets the sync position to the beginning of the region</dd>
+               <dt class="sub1">Nudge Later</dt><dd>Moves the region to the right by the amount shown in the <a href="/ardours-interface/the-editor/the-toolbar/the-nudge-controls/">nudge timer</a></dd>
+               <dt class="sub1">Nudge Earlier</dt><dd>Same as above, to the left</dd>
+               <dt class="sub1">Nudge Later by Capture Offset</dt><dd>Moves the region to the right by the capture latency computed by ardour based on the user's settings regarding latency</dd>
+               <dt class="sub1">Nudge Earlier by Capture Offset</dt><dd>Same as above, to the left</dd>
+               <dt class="sub1">Sequence Regions</dt><dd>Puts the selected regions one after the other, so that the end of one region is the beggining of the next one, removing any overlap or silence. The reference point is the earliest region.</dd>
+       <dt>Trim</dt>
+               <dt class="sub1">Trim Start at Edit Point</dt><dd>If the Edit Point is within the region boundaries, shortens the region to align its start with the Edit Point</dd>
+               <dt class="sub1">Trim End at Edit Point</dt><dd>Same as above, for the end of the region</dd>
+               <dt class="sub1">Trim to Loop</dt><dd>Uses both the start and end Loop markers to shorten the region</dd>
+               <dt class="sub1">Trim to Punch</dt><dd>Same as above with the Punch markers</dd>
+               <dt class="sub1">Trim to Previous</dt><dd>On overlapping regions, shortens the selected one so that the previous region is complete, i.e. the new start point for the selected region is the end point of the previous region on the timeline</dd>
+               <dt class="sub1">Trim to Next</dt><dd>Same as above, with the end of the selected region aligned to the start of the following one.</dd>
+       <dt>Ranges</dt>
+               <dt class="sub1">Set Loop Range</dt><dd>Creates a Loop range based on the selected regions, i.e. the strt of the loop range is the start of the earliest region, and the end of the loop is the end of the latest region.</dd>
+               <dt class="sub1">Set Punch</dt><dd>Same as above, for the Punch range</dd>
+               <dt class="sub1">Add Single Range Marker</dt><dd>Same as above, for the Edit range</dd>
+               <dt class="sub1">Add Range Marker Per Region</dt><dd>For each selected region, creates its own Edit range based on the boundaries of each region</dd>
+               <dt class="sub1">Set Range Selection</dt><dd>Creates a range selection based on the boundaries of the selected regions</dd>
+       <dt>Fades</dt>
+               <dt class="sub1">[] Fade In</dt><dd>Activates/desactivates the Fade In at the start of the region</dd>
+               <dt class="sub1">[] Fade Out</dt><dd>Same as above, for the Fade out at the end of the region</dd>
+               <dt class="sub1">[] Fades</dt><dd>Shortcut to activate/desactivate both the fade in and fade out</dd>
+       <dt>Duplicate</dt>
+               <dt class="sub1">Duplicate</dt><dd>Creates a copy of the selected region(s) and happend it to the original</dd>
+               <dt class="sub1">Multi-Duplicate...</dt><dd>Shows the <kbd class="menu">Duplicate</kbd> dialog, allowing to create multiple copies, or a not-integer number of copies (the last one will then be truncated)</dd>
+               <dt class="sub1">Fill Track</dt><dd>Creates duplicates until it fills the session, i.e. reaches the End marker of the session. The last duplicate may be truncated to fit in</dd>
+       <dt>Export...</dt><dd>Shows the <a href="/exporting/export-dialog/"><kbd class="menu">Export</kbd> dialog</a>, with all parameters set to export only the selected region(s)</dd>
+       <dt>Bounce (without processing)</dt><dd>Creates a bounce, i.e. a version of the region with all the edits (boundaries, enveloppe), as a new region in the Editor List, without any of the effects of the mixer strip</dd>
+       <dt>Bounce (with processing)</dt><dd>Same as above, <em>with</em> the effects of the mixer strip</dd>
+
+       <dt>Remove</dt><dd>Deletes the region from the edit (no file is harmed in the process, and the region stays in the Editor for later use)</dd>
+</dl>
+
+---
+title: The Track Menu
+part: subchapter
+---
+
+<p>
+       The <kbd class="menu">Track</kbd> menu is where one can deal with the tracks, busses and control masters.
+</p>
+
+<dl>
+       <dt>Add Track, Bus or VCA...</dt><dd>Shows the <a href="/working-with-tracks/adding-tracks-and-busses/"><kbd class="menu">Add Track, Bus or VCA...</kbd> window</a>, where one can add one or more tracks, busses or control masters to the session and define its parameters</dd>
+       <dt>Duplicate Tracks/Busses...</dt><dd>Shows the <kbd class="menu">Duplicate Tracks and Busses</kbd> window, allowing to duplicate the selected track(s) and optionnaly, its playlist</dd>
+
+       <dt>Toggle Record Enable</dt><dd>Sets the Record Enable mode On on the selected track(s). These tracks will record audio/midi next time the global record is active and playback is started.</dd>
+       <dt>Toggle Solo</dt><dd>Sets the solo On on the selected tracks, so only these tracks will play</dd>
+       <dt>Toggle Mute</dt><dd>Mutes the selected tracks, they wont play until unmuted</dd>
+
+       <dt>Insert Time</dt><dd>Shows the <kbd class="menu">Insert Time</kbd> window, allowing to insert a blank time in the selected tracks' playlist. By default, it'll be inserted at the Edit Point, but that can be changed in the dialog, as does the behaviour of the regions</dd>
+       <dt>Remove Time</dt><dd>Same as above, but to remove time</dd>
+       <dt>Move Selected Tracks Up</dt><dd>Changes the position of the selected tracks one track up towards the top. In the mixer, the tracks will be moved to the left.</dd>
+       <dt>Move Selected Tracks Down</dt><dd>Same as above, towards the bottom</dd>
+       <dt>Height</dt>
+               <dt class="sub1">Fit Selection (Vertical)</dt><dd>Will fit the selected track(s) in the window. If too many tracks are selected, they'll be reduced to their minimum height.</dd>
+               <dt class="sub1">Largest</dt><dd>Sets the selected tracks height to a very high value, hence making the tracks wide on screen</dd>
+               <dt class="sub1">Larger</dt><dd>Same as above, but a little less high</dd>
+               <dt class="sub1">Large</dt><dd>Same as above, but again less high</dd>
+               <dt class="sub1">Normal</dt><dd>Sets the height of the track to its default value which is a trade-off between readability and number of tracks displayed</dd>
+               <dt class="sub1">Small</dt><dd>Reduces the size of the tracks to a low value, increasing the number of on screen tracks</dd>
+
+       <dt>Toggle Active</dt><dd>Toggles the active state of a track. An inactive track will be grayed and wont play any sound. That can be seen in the <kbd class="menu">A</kbd> colomn of the <a href="/ardours-interface/the-editor/the-editor_s-lists/tracks-and-busses-list/">Tracks and Busses List</a></dd>
+       <dt>Remove</dt><dd>Deletes this track and its playlist (no file is harmed in the process, and the regions from the playlist stay in the Editor for later use)</dd>
+</dl>
+
+---
+title: The View Menu
+part: subchapter
+---
+
+<p>
+  The <dfn>View</dfn> menu sets how the session is seen, and what's visible or not.
+</p>
+
+<dl>
+       <dt>[] Maximise Editor Space</dt><dd>Puts the Editor window in full screen mode</dd>
+       <dt>[] Maximize Mixer Space</dt><dd>Puts the Mixer window in full screen mode</dd>
+
+       <dt>Primary Clock</dt>
+               <dt class="sub1">Focus On Clock</dt><dd>Sets the focus on the <a href="/ardours-interface/transport-bar-and-times/times/">main clock</a>, allowing to type in numbers directly to change the playhead position</dd>
+               <dt class="sub1">Timecode</dt><dd>Sets the main clock in timecode mode, so it displays time in the Hours:Minutes:Seconds:Frames format</dd>
+               <dt class="sub1">Bars &amp; Beats</dt><dd>Sets the main clock in musical time mode, so it displays time in the Bars:Beats:Ticks format</dd>
+               <dt class="sub1">Minutes &amp; Seconds</dt><dd>Sets the main clock in absolute time mode, so it displays time in the Hours:Minutes:Seconds.Milliseconds format</dd>
+               <dt class="sub1">Samples</dt><dd>Sets the main clock in samples time mode, so the time is displayed in samples from the absolute start</dd>
+       <dt>Secondary Clock</dt>
+               <dt class="sub1">Timecode</dt><dd>Same as for the main clock (see above)</dd>
+               <dt class="sub1">Bars &amp; Beats</dt><dd>Same as for the main clock</dd>
+               <dt class="sub1">Minutes &amp; Seconds</dt><dd>Same as for the main clock</dd>
+               <dt class="sub1">Samples</dt><dd>Same as for the main clock</dd>
+
+       <dt>Zoom</dt>
+               <dt class="sub1">Zoom In</dt><dd>Zooms in, focusing the <em>Zoom Focus</em> (see bellow)</dd>
+               <dt class="sub1">Zoom Out</dt><dd>Zooms out</dd>
+               <dt class="sub1">Zoom to Session</dt><dd>Adjust the zoom value so that all the session (as defined by its start and end markers) fit in the window</dd>
+               <dt class="sub1">Zoom to Selection</dt><dd>Adjust the zoom value so that all the selected regions fit in the window</dd>
+               <dt class="sub1">Fit Selection (Vertical)</dt><dd>Fits the selected track(s) in the window. If too many tracks are selected, they'll be reduced to their minimum height.</dd>
+               <dt class="sub1">Toggle Zoom State</dt><dd>Reverts to last zoom state (kind of "undo" for zoom, even if edits have been made inbetween)</dd>
+               <dt class="sub1">Expand Track Height</dt><dd>Increases the height of the selected tracks. If no track is selected, then all the tracks are expanded</dd>
+               <dt class="sub1">Shrink Track Height</dt><dd>Same as above, but reduces the height of the tracks</dd>
+       <dt>Zoom Focus</dt>
+               <dt class="sub1">Zoom Focus Left</dt><dd>Sets the screen's left side as the zoom target, i.e. when zooming in, the left side of the screen will stay at the same place in the timeline</dd>
+               <dt class="sub1">Zoom Focus Right</dt><dd>Same, with the right of the screen</dd>
+               <dt class="sub1">Zoom Focus Center</dt><dd>Same, with the center of the screen</dd>
+               <dt class="sub1">Zoom Focus Playhead</dt><dd>Sets the playhead as the focus point of the zoom, i.e. the point in time that will stay fixed</dd>
+               <dt class="sub1">Zoom Focus Mouse</dt><dd>Same as above, with the mouse pointer</dd>
+               <dt class="sub1">Zoom Focus Edit Point</dt><dd>Same as above, with the Edit Point</dd>
+               <dt class="sub1">Next Zoom Focus</dt><dd>Circles between the previous modes</dd>
+       <dt>Rulers</dt>
+               <dt class="sub1">[] Min:Sec</dt><dd>Showss (when checked) or hides a line in <a href="/ardours-interface/the-editor/the-ruler/">the Ruler</a> with the time formatted as Hours:Minutes:Seconds.Milliseconds</dd>
+               <dt class="sub1">[] Timecode</dt><dd>Same as above, with the time formatted as Hours:Minutes:Seconds:Frames</dd>
+               <dt class="sub1">[] Samples</dt><dd>Same as the above, with the time displayed in samples from the absolute start</dd>
+               <dt class="sub1">[] Bars &amp; Beats</dt><dd>Same as the above, with the time formatted as Bars:Beats:Ticks</dd>
+
+               <dt class="sub1">[] Meter</dt><dd>Shows / hides the Meter line in the ruler, where the signature can be adjusted along the playline</dd>
+               <dt class="sub1">[] Tempo</dt><dd>Shows / hides the Tempo line, where the BPM can be changed with markers</dd>
+               <dt class="sub1">[] Ranges</dt><dd>Shows / hides the Range line, where ranges can be defined</dd>
+               <dt class="sub1">[] Loop/Punch</dt><dd>Shows / hides the Loop/Punch line, where loops and Punches can be defined</dd>
+               <dt class="sub1">[] CD Markers</dt><dd>Shows / hides the Range line, where CD Markers can be defined</dd>
+               <dt class="sub1">[] Markers</dt><dd>Shows / hides the Markers line, where custom markers can be defined</dd>
+
+               <dt class="sub1">[] Video</dt><dd>Shows / hides the Video timeline, where frames of the video are shown for syncing purposes</dd>
+       <dt>Video Monitor</dt>
+               <dt class="sub1">Original Size</dt><dd>When the <a href="/video-timeline/">Video Monitor</a> is active, resets its size to the original size, i.e. 1 pixel in the video is 1 pixel on screen</dd>
+               <dt class="sub1">[] Letterbox</dt><dd>When checked, forces the ratio (width/height) to be the one of the original video. If unched, the video will be stretched to fit the window</dd>
+
+               <dt class="sub1">[] Always on Top</dt><dd>Stays above all other windows, enabling to work in Ardour without the video windows to be hidden in the background</dd>
+               <dt class="sub1">[] Fullscreen</dt><dd>Sets the Xjadeo window to be fullscreen. Can be usefull in a dual monitor setup</dd>
+
+               <dt class="sub1">[] Timecode</dt><dd>When checked, displays a Timecode over the video, in the Hours:Minutes:Seconds:Frames format</dd>
+               <dt class="sub1">[] Frame number</dt><dd>When checked, shows the absolute frame number inside the video, i.e. this image is the <em>n</em>th of the video</dd>
+               <dt class="sub1">[] Timecode Background</dt><dd>Adds a black background to the timecode for readability</dd>
+       <dt>Scroll</dt>
+               <dt class="sub1">Scroll Tracks Down</dt><dd>Scrolls the view toward the bottom of the session from one screen (vertically, so along tracks)</dd>
+               <dt class="sub1">Scroll Tracks Up</dt><dd>Same as above, towards the top</dd>
+               <dt class="sub1">Scroll Forward</dt><dd>Scrolls the view toward the right of the session from one screen (horizontally, so along time)</dd>
+               <dt class="sub1">Scroll Backward</dt><dd>Same as above, to the left</dd>
+       <dt>Views</dt>
+               <dt class="sub1">Save View <em>n</em></dt><dd>Saves the position on the timeline in the memory, horizontally and vertically (along time and tracks)</dd>
+               <dt class="sub1">Go to View <em>n</em></dt><dd>Loads and displays a saved position (see above)</dd>
+
+       <dt>[] Show Editor Mixer</dt><dd>When checked, the selected tracks' mixer strip is displayed on the left of the editor window, allowing for a quick access to e.g. efffects and routing</dd>
+       <dt>[] Show Editor List</dt><dd>In the Editor window, shows the <a href="/ardours-interface/the-editor/the-editor_s-lists/">Editor List</a>, giving access to a number of handy lists (regions, tracks, ...)</dd>
+       <dt>[] Toggle Mixer List</dt><dd>In the Mixer view, shows the Mixer list, giving access to some handy lists (<a href="/ardours-interface/the-mixer/favorite-plugins-window/">Favorite plugins</a>, <a href="/ardours-interface/the-mixer/the-strips-list/">The Strip list</a>,...)</dd>
+       <dt>[] Toggle Monitor Section Visibility</dt><dd>If the <kbd class="option">Use monitoring section on this session</kbd> has been checked in the <a href="/preferences-and-session-properties/session-properties-dialog/monitoring/">Session Properties window</a>, shows pr hide the Monitor Section in the Mixer</dd>
+       <dt>[] Show Measure Lines</dt><dd>If checked, in the Editor, shows a vertical white lines at each measure start</dd>
+       <dt>[] Show Summary</dt><dd>If checked, in the Editor, shows the <a href="/ardours-interface/the-editor/the-summary/">Summary</a>, allowing a faste navigation in the session</dd>
+       <dt>[] Show Group Tabs</dt><dd>If checked, makes the groups visible as tabs on the left in the Editor, and on the top in the mixer</dd>
+       <dt>[] Show Marker Lines</dt><dd>If checked, each marker is extended across all the tracks in the editor with a line of the same color</dd>
+</dl>
+
+---
+title: The Window Menu
+part: subchapter
+---
+
+<p>
+  The <dfn>Window</dfn> menu deals with the layout of the different windows, and their visibility.
+</p>
+
+<dl>
+       <dt>[] Audio/MIDI Setup</dt><dd>Shows the <a href="/working-with-sessions/new-session-dialog/"><kbd class="menu">Audio/MIDI Setup</kbd> window</a>, where the sound system configuration can be modified</dd>
+
+       <dt>Editor</dt>
+               <dt class="sub1">Show</dt><dd>Switches to the Editor view</dd>
+               <dt class="sub1">Hide</dt><dd>Hides the Editor, hence showing the Mixer when the windows are attached</dd>
+               <dt class="sub1">Attach</dt><dd>If the Editor window is detached, separated from the main window, attach it back</dd>
+               <dt class="sub1">Detach</dt><dd>If the Editor is attached to the main window, fetach it (makes the Editor a separated window, usefull for multi-monitor setup)</dd>
+       <dt>Mixer</dt>
+               <dt class="sub1">Show/Hide/Attach/Detach</dt><dd>Same as for the Editor, for the <em>Mixer</em> window</dd>
+       <dt>Preferences</dt><dd></dd>
+               <dt class="sub1">Show/Hide/Attach/Detach</dt><dd>Same as for the Editor, for the <em>Preferences</em> window</dd>
+       <dt>Meterbridge</dt><dd>Shows the <a href="/meters/"><kbd class="menu">Meterbridge</kbd> window</a>, that displays all the tracks' meter at once and their recording status, and is very handy for multitrack recording</dd>
+       <dt>Scripting</dt><dd>Opens the <a href="/lua-scripting/"><kbd class="menu">Lua Scripting</kbd> window</a>, allowing to edit and run Lua scripts</dd>
+
+       <dt>[] Tracks and Busses</dt><dd>Opens the <kbd class="menu">Tracks and Busses</kbd> window, which is a shortcut to many tracks/busses operations (routing, effects, ...)</dd>
+       <dt>[] Locations</dt><dd><dd>Opens the <a href="/ardours-interface/the-editor/the-editor_s-lists/ranges-and-marks-list/"><kbd class="menu">Ranges and Marks</kbd> window</a>, a single point of control for all range and location markers</dd>
+       <dt>[] Binding Editor</dt><dd>Opens the <a href="/default-keyboard-bindings/"><kbd class="menu">Key Bindings</kbd> window</a>, which allows for easy creation or modification of any keyboard shortcut</dd>
+       <dt>[] Bundle Manager</dt><dd>Opens the <kbd class="menu">Bundle Manager</kbd> window, allowing to create and manage <em>Bundles</em>, which are a way to simplify connection management, by defining groups of ports</dd>
+       <dt>[] Big Clock</dt><dd>Opens the <a href="/ardours-interface/transport-bar-and-times/times/">Main Clock</a> as its own separate (and huge) window, which is helpfull when recording</dd>
+
+       <dt>[] Video Monitor</dt><dd>If a <a href="/video-timeline/">video</a> has been imported in the session, opens a video window (namely, <em>Xjadeo</em>), synced to the timeline</dd>
+
+       <dt>Midi Tracer</dt><dd>Opens the <kbd class="menu">MIDI Tracer</kbd> window, allowing to follow each and every MIDI message entering or leaving Ardour</dd>
+       <dt>[] Audio Connections</dt><dd>Opens the <a href="/signal-routing/Patchbay/"><kbd class="menu">Audio Connection Manager</kbd> window</a>, a way to make connections to, from and within Ardour's mixer</dd>
+       <dt>[] MIDI Connections</dt><dd>Same as above, for the MIDI connections</dd>
+       <dt>[] Log</dt><dd>Shows the <kbd class="menu">Log</kbd> window, where Ardour lists usefull information, warnings and errors</dd>
+</dl>
+
+---
+title: The Help Menu
+part: subchapter
+---
+
+<p>
+  The <dfn>Help</dfn> Menu gives acces to useful information about Ardour.
+</p>
+
+<dl>
+  <dt>[] About</dt><dd>Shows the <kbd class="menu">About Ardour</kbd> window, which contains information about the version, config, authors,and license of Ardour</dd>
+  <dt>Chat</dt><dd>This is a shortcut to the webchat version of the Freenode IRC channel of Ardour, where the developpers meet, and questions can be asked if the Manual is not enough</dd>
+  <dt>Manual</dt><dd>Link to a FLOSSManual guide to Ardour</dd>
+  <dt>Reference</dt><dd>Link to this manual, hosted on ardour.org</dd>
+  <dt>User Forums</dt><dd>Link to ardour.org's user forum</dd>
+  <dt>How to Report a Bug</dt><dd>Link to an helping page about reporting bugs</dd>
+  <dt>Report a Bug</dt><dd>Link to Ardour's Mantis bugtracker</dd>
+  <dt>Ardour Website</dt><dd>Link to Ardour's main and official website</dd>
+  <dt>Ardour Development</dt><dd>Link to the developpers' part of the official website</dd>
+</dl>
 
 
 ---
@@ -5366,7 +5841,7 @@ part: subchapter
 </p>
 
 <p>
-  The transparent white rectangle represents what's actually displayed in the Editor window, i.e. what part of the session is beign looked at on screen.
+  The transparent white rectangle represents what's actually displayed in the Editor window, i.e. what part of the session is being looked at on screen.
 </p>
 
 <p>
index 4a9fb5d1f1b8b10d498e6df637f0f1f10b6e15ac..630185bba3fbe8518bf7e1f760346c6ed4981bf4 100644 (file)
     font-weight: normal;
 }
 
+#content dt.sub1 {
+    padding-left: 2em;
+}
+
+#content dt.sub2 {
+    padding-left: 4em;
+}
+
+
 #content figure {
     display: table;
 }