Jump help

diff --git a/PciIds/Html/Handler.pm b/PciIds/Html/Handler.pm
index dfb518a3a2090dd5478375aac1a1f0a130c14931..aa3887619f84f98643f7c55aadc436062f898c9f 100644 (file)
--- a/PciIds/Html/Handler.pm
+++ b/PciIds/Html/Handler.pm
@@ -54,7 +54,8 @@ my %handlers = (
                'profile' => \&PciIds::Html::Users::profileFormSubmit,
                'admin' => \&PciIds::Html::Admin::submitAdminForm,
                'notifications' => \&PciIds::Html::Notifications::notifFormSubmit,
-               'jump' => \&PciIds::Html::Jump::jump
+               'jump' => \&PciIds::Html::Jump::jump,
+               'help' => \&PciIds::Html::Help::getHelp
        }
 );
 

diff --git a/help/index b/help/index
index e8983c5283f2db6c84c29492935b379262c8c407..b5a10a3a95b3d4eef2d5aae27cdfaba7c1609a15 100644 (file)
--- a/help/index
+++ b/help/index
@@ -2,6 +2,7 @@ Help index
 <h2>Read only operations</h2>
 <ul class='navigation'>
        <li><a href='$HELP_URL$list'>Browsing</a>
+       <li><a href='$HELP_URL$jump'>Jumping</a>
 </ul>
 <h2>Account based operations</h2>
 <ul class='navigation'>

diff --git a/help/jump b/help/jump
new file mode 100644 (file)
index 0000000..8f58fb0
--- /dev/null
+++ b/help/jump
@@ -0,0 +1,32 @@
+Jumping
+The jump box (little text box with 'Jump' button by its side) has two functions.
+
+<h2>Direct ID jump</h2>
+<p>
+If you enter an ID and press Jump (or Enter), you are sent directly to that ID.
+<p>
+You can use both slashes ('/') and colons (':') as ID segment separators.
+If the ID starts with an ID type prefix (eg. 'PC'), it is considered absolute.
+If it starts with a segment separator, it is considered absolute inside current ID tree (eg. PCI devices).
+Absolute addresses are tried first, if they do not exist, relative search is done.
+Otherwise, it is relative and is appended to current ID, then to its parent and so on, until some exists or a root of tree is reached.
+
+<h2>Name search</h2>
+<p>
+If direct ID jump does not succeed, names of items are searched for it.
+By default only names of the same ID type are searched (if you browse PCI devices, you will not get results from device classes).
+If you want to search all names, prefix the search with an asterisk ('*').
+<p>
+If you want to turn off name search in your query, prefix the query with '#'.
+
+<h2>Examples</h2>
+<p>
+All examples are searches from within ID 'PC:0000:0000'.
+<ul>
+       <li><tt>PD:00</tt> ‒ jumps to <tt>PD:00</tt>, if it exist.
+       <li><tt>:1234</tt> ‒ jumps to <tt>PC:1234</tt>, if it exist.
+       <li><tt>abcd</tt> ‒ tries <tt>PC:0000:0000:abcd</tt>, then <tt>PC:0000:abcd</tt>, then <tt>PC:abcd</tt>. Then searches in names.
+       <li><tt>#abcd</tt> ‒ same as above, but does not continue searching in names.
+       <li><tt>Some text</tt> ‒ all id searches will fail, names of PCI devices are searched for <tt>Some text</tt>.
+       <li><tt>*Some text</tt> ‒ same, but the search is trough all devices in database.
+</ul>

diff --git a/help/list b/help/list
index 3b37d5c0d04dbed8fcfe70cc210cc1fe6c17d444..b403c85cb408a5b2afe95f5bc138bb37dd4b1d3f 100644 (file)
--- a/help/list
+++ b/help/list
@@ -28,6 +28,7 @@ Colors are used both in discussion and list of sub-items to mark status of discu
 <div class='lmenu'><ul>
        <li><a href='$HELP_URL$newitem'>Add item</a>
        <li><a href='$HELP_URL$newhistory'>Discuss</a>
+       <li><form class='jump' method='POST' action='$HELP_URL$jump'><p><input type='text' class='jump' disabled='disabled'><input type='submit' value='Jump'></form>
 </ul></div>
 <div class='rmenu'><ul>
        <li><a href='$HELP_URL$account'>Log in</a>