Cue: Cue window elements

[ardour-manual] / include / searching-for-files-using-tags.html

diff --git a/include/searching-for-files-using-tags.html b/include/searching-for-files-using-tags.html
index cfd86d3ca00590813841ecdcc6eb85cae21f7591..d47ba99710ca54627fd4816006f65d7c36638c90 100644 (file)
--- a/include/searching-for-files-using-tags.html
+++ b/include/searching-for-files-using-tags.html
@@ -1,30 +1,42 @@
 
 <p>
-  A <dfn>tag</dfn> is bit of information, or metadata, that is associated 
-  with a data file. Specifically, tags are keywords or terms that you feel 
-  have some relevance to a particular soundfile. Ardour can store these tags 
-  in a searchable <dfn>database</dfn> so that you can quickly search for sounds based 
-  on the tags that you have assigned to them. 
+  A <dfn>tag</dfn> is bit of information, or metadata, that is associated
+  with a data file. Specifically, tags are texts, keywords or terms that have
+  some relevance to a particular sound file. Ardour can store these tags
+  in a searchable <dfn>database</dfn> so that they can quickly be searched for
+  to retrieve sounds based on the tags that have been assigned to them.
 </p>
 <p>
-  For example you can assign the term <kbd class="input">120bpm</kbd> to a 
-  sound, and then when you search for this tag, the file will appear in the
-  search list. Tags are independent of the filename or anything else about 
-  the file. Tags, and the file paths that they are associated with, are 
-  stored in a file called <samp>sfdb</samp> in your Ardour user folder.
+  For example if the term <kbd class="input">120bpm</kbd> has been assigned to a
+  sound, search later for this tag will make the file appear in the
+  search list. Tags are independent of the filename or anything else about
+  the file. Tags, and the file paths that they are associated with, are
+  stored in a file called <samp>sfdb</samp> in the Ardour user folder.
+</p>
+
+<h2>Creating and adding tags</h2>
+
+<p>
+  Adding tags to a given file is done by opening the <kbd class="menu">Session &gt; Import</kbd>
+  dialog, selecting the file in the browser, and typing new tags into the tag
+  area in the soundfile information box on the right.
 </p>
 <p>
-  To <dfn>add tags</dfn> to a given file, open the <kbd class="menu">Session &gt; Import</kbd> 
-  dialog, select the file in the browser, and type new tags into tag area in
-  the soundfile information box on the right.<br/>
   Tags are stored when the input box loses focus, there is no need to
   explicitly save them.
 </p>
 <p>
-  You can <dfn>search</dfn> for specific tags in the <kbd
-  class="menu">Search Tags</kbd> tab of the same dialog. Files which have 
-  been tagged with the relevant terms will appear in the results window. 
-  Selected files can be auditioned and marked with additional tags if
-  required. 
+  To have more than one tag for a file, new tags can either be added on new lines
+  (meaning the <kbd>Enter</kbd> key is pressed between two tags) or they can be
+  separated from the previous ones by a comma (<kbd class="input">,</kbd>), with or without spaces.
+</p>
+
+<h2>Searching for files by tag</h2>
+
+<p>
+  Searching for specific tags is done in the <kbd class="menu">Search Tags</kbd>
+  tab of the same dialog. Files which have been tagged with the relevant terms
+  will appear in the results window. Selected files can be auditioned and marked
+  with additional tags if required.
 </p>