ido-mode: updated POD to try to stop the README from adding anchors everywhere.

2 files changed, 153 insertions, 67 deletions

diff --git a/ido-mode/README.pod b/ido-mode/README.pod
index 9c49c0f..62f7190 100644
--- a/ido-mode/README.pod
+++ b/ido-mode/README.pod
@@ -37,24 +37,36 @@ the possible interactive options.
 
 =head3 EXTENDED USAGE:
 
-It is possible to pass arguments to the /ido_switch_start command, which
+It is possible to pass arguments to the C</ido_switch_start> command, which
 correspond to some of the interactively settable parameters listed below.
 
 The following options are available:
 
 =over 4
 
-=item C<-channels> -- search through only channels.
+=item C<-channels>
 
-=item C<-queries>  -- search through only queries.
+Search through only channels.
 
-=item C<-all>      -- search both queries and channels (Default).
+=item C<-queries>
 
-=item C<-active>   -- limit search to only window items with activity.
+Search through only queries.
 
-=item C<-exact>    -- enable exact-substring matching
+=item C<-all>
 
-=item C<-flex>     -- enable flex-string matching
+search both queries and channels (Default).
+
+=item C<-active>
+
+Lmit search to only window items with activity.
+
+=item C<-exact>
+
+Enable exact-substring matching
+
+=item C<-flex>
+
+Enable flex-string matching
 
 =back
 
@@ -83,38 +95,65 @@ activated:
 
 =over 4
 
-=item C<C-g>   - Exit the mode without changing windows.
+=item C<C-g>
+
+ Exit the mode without changing windows.
+
+=item C<Esc>
+
+Exit, as above.
+
+=item C<C-s>
+
+Rotate the list of window candidates forward by one item
 
-=item C<Esc>   - Exit, as above.
+=item C<C-r>
 
-=item C<C-s>   - Rotate the list of window candidates forward by 1
+Rotate the list of window candidates backward by one item
 
-=item C<C-r>   - Rotate the list of window candidates backward by 1
+=item C<C-e>
 
-=item C<C-e>   - Toggle 'Active windows only' filter
+Toggle 'Active windows only' filter
 
-=item C<C-f>   - Switch between 'Flex' and 'Exact' matching.
+=item C<C-f>
 
-=item C<C-d>   - Select a network or server to filter candidates by
+Switch between 'Flex' and 'Exact' matching.
 
-=item C<C-u>   - Clear the current search string
+=item C<C-d>
 
-=item C<C-q>   - Cycle between showing only queries, channels, or all.
+Select a network or server to filter candidates by
 
-=item C<C-SPC> - Filter candidates by current search string, and then reset
-                 the search string
+=item C<C-u>
 
-=item C<RET>   - Select the current head of the candidate list (the green one)
+Clear the current search string
 
-=item C<SPC>   - Select the current head of the list, without exiting the
-                 switching mode. The head is then moved one place to the right,
-                 allowing one to cycle through channels by repeatedly pressing space.
+=item C<C-q>
 
-=item C<TAB>   - B<[currently in development]> displays all possible completions
-                 at the bottom of the current window.
+Cycle between showing only queries, channels, or all.
 
-=item I<All other keys> (C<a-z, A-Z>, etc) - Add that character to the current search
-                        string.
+=item C<C-SPC>
+
+Filter candidates by current search string, and then reset
+the search string
+
+=item C<RET>
+
+Select the current head of the candidate list (the green one)
+
+=item C<SPC>
+
+Select the current head of the list, without exiting the
+switching mode. The head is then moved one place to the right,
+allowing one to cycle through channels by repeatedly pressing space.
+
+=item C<TAB>
+
+B<[currently in development]> displays all possible completions
+at the bottom of the current window.
+
+=item I<All other keys> (C<a-z, A-Z>, etc)
+
+Add that character to the current search string.
 
 =back
 
@@ -122,13 +161,17 @@ activated:
 
 =over 4
 
-=item Using C-e (show actives), followed by repeatedly pressing space will cycle
-   through all your currently active windows.
+=item * 
+
+Using C-e (show actives), followed by repeatedly pressing space will cycle
+through all your currently active windows.
+
+=item *
 
-=item If you enter a search string fragment, and realise that more than one candidate
-   is still presented, rather than delete the whole string and modify it, you can
-   use C-SPC to 'lock' the current matching candidates, but allow you to search
-   through those matches alone.
+If you enter a search string fragment, and realise that more than one candidate
+is still presented, rather than delete the whole string and modify it, you
+can use C-SPC to 'lock' the current matching candidates, but allow you to
+search through those matches alone.
 
 =back
 
diff --git a/ido-mode/ido_switcher.pl b/ido-mode/ido_switcher.pl
index 81f49ff..8194f8a 100644
--- a/ido-mode/ido_switcher.pl
+++ b/ido-mode/ido_switcher.pl
@@ -37,24 +37,36 @@ the possible interactive options.
 
 =head3 EXTENDED USAGE:
 
-It is possible to pass arguments to the /ido_switch_start command, which
+It is possible to pass arguments to the C</ido_switch_start> command, which
 correspond to some of the interactively settable parameters listed below.
 
 The following options are available:
 
 =over 4
 
-=item C<-channels> -- search through only channels.
+=item C<-channels>
 
-=item C<-queries>  -- search through only queries.
+Search through only channels.
 
-=item C<-all>      -- search both queries and channels (Default).
+=item C<-queries>
 
-=item C<-active>   -- limit search to only window items with activity.
+Search through only queries.
 
-=item C<-exact>    -- enable exact-substring matching
+=item C<-all>
 
-=item C<-flex>     -- enable flex-string matching
+search both queries and channels (Default).
+
+=item C<-active>
+
+Lmit search to only window items with activity.
+
+=item C<-exact>
+
+Enable exact-substring matching
+
+=item C<-flex>
+
+Enable flex-string matching
 
 =back
 
@@ -83,38 +95,65 @@ activated:
 
 =over 4
 
-=item C<C-g>   - Exit the mode without changing windows.
+=item C<C-g>
+
+ Exit the mode without changing windows.
+
+=item C<Esc>
+
+Exit, as above.
+
+=item C<C-s>
+
+Rotate the list of window candidates forward by one item
+
+=item C<C-r>
 
-=item C<Esc>   - Exit, as above.
+Rotate the list of window candidates backward by one item
 
-=item C<C-s>   - Rotate the list of window candidates forward by 1
+=item C<C-e>
 
-=item C<C-r>   - Rotate the list of window candidates backward by 1
+Toggle 'Active windows only' filter
 
-=item C<C-e>   - Toggle 'Active windows only' filter
+=item C<C-f>
 
-=item C<C-f>   - Switch between 'Flex' and 'Exact' matching.
+Switch between 'Flex' and 'Exact' matching.
 
-=item C<C-d>   - Select a network or server to filter candidates by
+=item C<C-d>
 
-=item C<C-u>   - Clear the current search string
+Select a network or server to filter candidates by
 
-=item C<C-q>   - Cycle between showing only queries, channels, or all.
+=item C<C-u>
 
-=item C<C-SPC> - Filter candidates by current search string, and then reset
-                 the search string
+Clear the current search string
 
-=item C<RET>   - Select the current head of the candidate list (the green one)
+=item C<C-q>
 
-=item C<SPC>   - Select the current head of the list, without exiting the
-                 switching mode. The head is then moved one place to the right,
-                 allowing one to cycle through channels by repeatedly pressing space.
+Cycle between showing only queries, channels, or all.
 
-=item C<TAB>   - B<[currently in development]> displays all possible completions
-                 at the bottom of the current window.
+=item C<C-SPC>
 
-=item I<All other keys> (C<a-z, A-Z>, etc) - Add that character to the current search
-                        string.
+Filter candidates by current search string, and then reset
+the search string
+
+=item C<RET>
+
+Select the current head of the candidate list (the green one)
+
+=item C<SPC>
+
+Select the current head of the list, without exiting the
+switching mode. The head is then moved one place to the right,
+allowing one to cycle through channels by repeatedly pressing space.
+
+=item C<TAB>
+
+B<[currently in development]> displays all possible completions
+at the bottom of the current window.
+
+=item I<All other keys> (C<a-z, A-Z>, etc)
+
+Add that character to the current search string.
 
 =back
 
@@ -122,13 +161,17 @@ activated:
 
 =over 4
 
-=item Using C-e (show actives), followed by repeatedly pressing space will cycle
-   through all your currently active windows.
+=item * 
+
+Using C-e (show actives), followed by repeatedly pressing space will cycle
+through all your currently active windows.
 
-=item If you enter a search string fragment, and realise that more than one candidate
-   is still presented, rather than delete the whole string and modify it, you can
-   use C-SPC to 'lock' the current matching candidates, but allow you to search
-   through those matches alone.
+=item *
+
+If you enter a search string fragment, and realise that more than one candidate
+is still presented, rather than delete the whole string and modify it, you
+can use C-SPC to 'lock' the current matching candidates, but allow you to
+search through those matches alone.
 
 =back
 
@@ -205,9 +248,9 @@ use Irssi;
 use Irssi::TextUI;
 use Data::Dumper;
 
-use vars qw($VERSION %IRSSI);
-$VERSION = '2.0';
-%IRSSI =
+
+our $VERSION = '2.1';
+our %IRSSI   =
   (
    authors     => 'Tom Feist, Wouter Coekaerts',
    contact     => 'shabble+irssi@metavore.org, shabble@#irssi/freenode',