Skip to content

Commit

Permalink
make howto.html fully xhtml1.1 compliant
Browse files Browse the repository at this point in the history
  • Loading branch information
bgoglin committed Aug 26, 2011
1 parent f5a1bca commit f941e9b
Showing 1 changed file with 16 additions and 48 deletions.
64 changes: 16 additions & 48 deletions doc/howto.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ <h2 class="section">Basics</h2>



<a id="basic_use">
<h3 class="question">How do I use lltag?</h3>
</a>
<h3 class="question"><a id="basic_use">How do I use lltag?</a></h3>

<pre>
lltag myfile1.mp3 myfile2.ogg
Expand All @@ -39,9 +37,7 @@ <h3 class="question">How do I use lltag?</h3>



<a id="see_current_tags">
<h3 class="question">How do I see current tags in files?</h3>
</a>
<h3 class="question"><a id="see_current_tags">How do I see current tags in files?</a></h3>

All the tags currently existing in files may be displayed:
<pre>
Expand All @@ -55,9 +51,7 @@ <h3 class="question">How do I see current tags in files?</h3>



<a id="set_tags_by_hand">
<h3 class="question">How do I set tags by hand?</h3>
</a>
<h3 class="question"><a id="set_tags_by_hand">How do I set tags by hand?</a></h3>

Any tag may be changed by hand:
<pre>
Expand Down Expand Up @@ -85,19 +79,15 @@ <h2 class="section">Disabling, Confirming, Forcing</h2>



<a id="do_not_tag">
<h3 class="question">How do I try lltag without actually tagging?</h3>
</a>
<h3 class="question"><a id="do_not_tag">How do I try lltag without actually tagging?</a></h3>

<pre>
lltag --dry-run
</pre>



<a id="change_confirm">
<h3 class="question">How do I change what confirmation lltag wants?</h3>
</a>
<h3 class="question"><a id="change_confirm">How do I change what confirmation lltag wants?</a></h3>

It is possible to remove any need for confirmation when no problem occurs:
<pre>
Expand All @@ -119,9 +109,7 @@ <h2 class="section">Parsing</h2>



<a id="see_parsing">
<h3 class="question">How do I see how lltag parses filename?</h3>
</a>
<h3 class="question"><a id="see_parsing">How do I see how lltag parses filename?</a></h3>

<tt>lltag</tt> uses internal format that are defined in <tt>/etc/lltag/formats/</tt>.
You might see them with:
Expand All @@ -131,9 +119,7 @@ <h3 class="question">How do I see how lltag parses filename?</h3>



<a id="force_format">
<h3 class="question">How do I force lltag to use another format?</h3>
</a>
<h3 class="question"><a id="force_format">How do I force lltag to use another format?</a></h3>

If internal formats do not fit the way your filename is written, you may pass
additional formats with:
Expand All @@ -148,9 +134,7 @@ <h3 class="question">How do I force lltag to use another format?</h3>



<a id="preferred_parser">
<h3 class="question">What is the preferred parser?</h3>
</a>
<h3 class="question"><a id="preferred_parser">What is the preferred parser?</a></h3>

If all your filenames have the same format, i.e. they may be matched with the
same parser, you might want to try this one first instead of seeing the other
Expand All @@ -170,9 +154,7 @@ <h2 class="section">Getting tags from the online CDDB</h2>



<a id="what_is_cddb">
<h3 class="question">What is CDDB and why does lltag need it?</h3>
</a>
<h3 class="question"><a id="what_is_cddb">What is CDDB and why does lltag need it?</a></h3>

CDDB is a huge online database of CD describing their artist, album, date,
tracks, ... everything that <tt>lltag</tt> considers as tags.
Expand All @@ -192,9 +174,7 @@ <h3 class="question">What is CDDB and why does lltag need it?</h3>



<a id="cddb_get_tags">
<h3 class="question">How do get tags from CDDB?</h3>
</a>
<h3 class="question"><a id="cddb_get_tags">How do get tags from CDDB?</a></h3>

The common way to search a CD on CDDB is to pass keywords, which return a list
of matching CDs. Then, you choose a CD in the list, and a track in the CD tracks.
Expand All @@ -217,9 +197,7 @@ <h3 class="question">How do get tags from CDDB?</h3>



<a id="choose_cddb_cd">
<h3 class="question">How do choose a precise CD in CDDB?</h3>
</a>
<h3 class="question"><a id="choose_cddb_cd">How do choose a precise CD in CDDB?</a></h3>

All CD that are registered in CDDB are identified by a category and an
hexadecimal identifier. When searching by keywords, <tt>lltag</tt> will
Expand All @@ -231,9 +209,7 @@ <h3 class="question">How do choose a precise CD in CDDB?</h3>



<a id="interactive_cddb">
<h3 class="question">Is the interactive interface always required to access CDDB?</h3>
</a>
<h3 class="question"><a id="interactive_cddb">Is the interactive interface always required to access CDDB?</a></h3>

The CDDB interface seems to be designed for interactive usage since the user
is supposed to choose a CD in the list of CDs returned by the keywords query,
Expand All @@ -259,9 +235,7 @@ <h2 class="section">Managing tags</h2>



<a id="set_explicit">
<h3 class="question">How do I set a specific value? What are explicit tag values?</h3>
</a>
<h3 class="question"><a id="set_explicit">How do I set a specific value? What are explicit tag values?</a></h3>

Each tag field may receive a specific value even if it is not obtained through
parsing the filename or so:
Expand All @@ -281,9 +255,7 @@ <h3 class="question">How do I set a specific value? What are explicit tag values



<a id="cleanup_tag">
<h3 class="question">How do I cleanup tags?</h3>
</a>
<h3 class="question"><a id="cleanup_tag">How do I cleanup tags?</a></h3>

If your filenames are dirty, it is possible to ask <tt>lltag</tt> to be flexible
with spaces. Any space in the format might be matched with 0 or several spaces
Expand All @@ -309,9 +281,7 @@ <h2 class="section">Renaming</h2>



<a id="rename">
<h3 class="question">How do I rename files after tagging?</h3>
</a>
<h3 class="question"><a id="rename">How do I rename files after tagging?</a></h3>

Files might be renamed using the tags that were gotten from original filename parsing:
<pre>
Expand All @@ -325,9 +295,7 @@ <h3 class="question">How do I rename files after tagging?</h3>



<a id="rename_without_tagging">
<h3 class="question">How do I rename files without tagging?</h3>
</a>
<h3 class="question"><a id="rename_without_tagging">How do I rename files without tagging?</a></h3>

<tt>lltag</tt> may also be used as a renaming program without any tagging:

Expand Down

0 comments on commit f941e9b

Please sign in to comment.