--- a/doc/upplay.html
+++ b/doc/upplay.html
@@ -727,16 +727,21 @@
}
}
-asciidoc.install();
+asciidoc.install(2);
/*]]>*/
</script>
</head>
<body class="article">
<div id="header">
<h1>Upplay manual</h1>
+<div id="toc">
+ <div id="toctitle">Table of Contents</div>
+ <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
+</div>
</div>
<div id="content">
-<div id="preamble">
+<div class="sect1">
+<h2 id="_overview">Overview</h2>
<div class="sectionbody">
<div class="imageblock">
<div class="content">
@@ -910,7 +915,82 @@
losing the current display.</p></div>
<div class="paragraph"><p><code>^f</code> or <code>/</code> will open the search panel, <code>Esc</code> will close it (or the x-cross
button at the right).</p></div>
-<div class="paragraph"><p><a href="searching.html">more detail on search</a>.</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_searching">Searching</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>Upplay supports two search modes:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+Inside the current directory page: this is handy to quickly skip inside
+ a long list.
+</p>
+</li>
+<li>
+<p>
+Server search.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>The search panel is located at the bottom of the library window (the one on
+the right), and normally hidden. You can open it by the following actions:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+Typing <code>/</code> inside the library window.
+</p>
+</li>
+<li>
+<p>
+Typing <code>Ctrl+f</code> inside the library window.
+</p>
+</li>
+<li>
+<p>
+Using the View menu
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Not all servers support search (e.g, MediaTomb does not, Minidlna does,
+etc.).</p></div>
+<div class="paragraph"><p>You can close the panel by the following actions:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+Typing <code>Esc</code> (the Escape key).
+</p>
+</li>
+<li>
+<p>
+Clicking the x-cross icon on the right of the panel
+</p>
+</li>
+<li>
+<p>
+Using the <code>View</code> menu.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>When the search panel opens for the first time, the panel is in local
+search mode. Typing inside the search entry area will try to find matches
+in the page. You can use the two arrow buttons or type <code>F3</code> or <code>Shift+F3</code>
+to find the next or previous match.</p></div>
+<div class="paragraph"><p>In server mode, the search panel will let you enter a search string and the
+kind of field inside which you want to search (the combobox on the right,
+Artist/Album/Title). Type <code>Enter</code> or click the search button to start the
+search.</p></div>
+<div class="paragraph"><p>The results are displayed just like a directory listing and can be
+used in the same way (including opening tabs for directory listings, etc.).</p></div>
+<div class="paragraph"><p>Server searches are always relative to the first directory earlier in the
+path, never to another search.
+If your search yields nothing, one of the things to check is that you are
+high enough in the tree (not searching a single directory).</p></div>
+<div class="paragraph"><p>Also <strong><em>space characters are significant in the search entry</em></strong>. This has a
+capacity for trouble but it can also be a great help when trying to match
+words (there are no standard UPnP ways to specify word matches, or anchor a
+search at the beginning or end of a field).</p></div>
</div>
</div>
<div class="sect1">
@@ -969,8 +1049,8 @@
<div class="sect1">
<h2 id="hiresadjust">Adjusting the font sizes on high resolution displays</h2>
<div class="sectionbody">
-<div class="paragraph"><p>Most people will find that the font sizes are too small on high DPI
-displays.</p></div>
+<div class="paragraph"><p>Most people will find that the font sizes (and buttons/icons) are too small
+on high DPI displays.</p></div>
<div class="paragraph"><p>As of version 1.2.5, the GUI can be partially adjusted by editing two style
sheet files. To adjust the font sizes:</p></div>
<div class="ulist"><ul>
@@ -988,9 +1068,15 @@
</p>
</li>
</ul></div>
+<div class="paragraph"><p>On Windows, use <em>notepad</em> or an equivalent pure text editor to edit the
+files, which are located in the <em>share</em> and <em>share\cdbrowser</em>
+subdirectories of the top installation directory (e.g: <em>C:\Program Files
+(x86)\Upplay\</em>). You need to specify "all files" when opening the files,
+because notepad does not list <em>.css</em> files by default (only <em>.txt</em>).</p></div>
<div class="paragraph"><p>The adjustment is not perfect for now: the player section does not update
its size, which means that some titles will be truncated (in the top left
-area), and the icon sizes are unchanged.</p></div>
+area), and the icon sizes are unchanged. Arbitrary text truncation may
+happen in places. This will hopefully be improved in a future release.</p></div>
<div class="paragraph"><p>There are other, system-based, approaches described on the following Qt page:
<a href="http://doc.qt.io/qt-5/highdpi.html">http://doc.qt.io/qt-5/highdpi.html</a></p></div>
</div>
@@ -1000,7 +1086,7 @@
<div id="footer">
<div id="footer-text">
Last updated
- 2016-03-28 18:36:59 CEST
+ 2016-04-01 10:15:31 CEST
</div>
</div>
</body>