aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md62
1 files changed, 32 insertions, 30 deletions
diff --git a/README.md b/README.md
index e99155f..ac873a9 100644
--- a/README.md
+++ b/README.md
@@ -11,100 +11,101 @@ each their own repository as might be sensible, they're all stuffed in here.
The following is a brief list of the interesting scripts, and why you might want
to use them.
-* [`auto_server/`](tree/master/auto_server/) -- provides a `/join+` command
+* [`auto-server/`](tree/master/auto-server) -- provides a `/join+` command
which allows you to join channels on servers to which you're not currently
connected, as long as you've got everything set up correctly in your
`/channels` and `/networks` config.
-* [`history_search/`](tree/master/history_search/) -- an improved version of
- [@coekie's](/coekie/irssi-scripts/blob/master/history_search.pl) original
+* [`history-search/`](tree/master/history-search) -- an improved version of
+ [@coekie](/coekie/irssi-scripts/blob/master/history_search.pl)'s original
history_search, it behaves a lot more like the standard Readline incremental
search over your recent command history.
-* [`ido_mode/`](tree/master/ido_mode/) -- A window switching mode best described
+* [`ido-mode/`](tree/master/ido-mode) -- A window switching mode best described
as "The bastard lovechild of emacs ido-mode and window_switcher.pl". It
supports flexible matching of channel names, filtering by active windows,
servers, and more. See the script comments for details.
-* [`feature_tests/`](tree/master/feature_tests/) has a bunch of different little
+* [`feature-tests/`](tree/master/feature-tests) has a bunch of different little
scripts written to test certain aspects of Irssi behaviour. None of them are
likely to be particularly useful unless you're looking for simple examples of
various things on which to build. Some of the ones which might actually be
useful are:
- * [`key_test.pl`](tree/master/feature_tests/key_test.pl) - decodes and prints
+ * [`key_test.pl`](tree/master/feature-tests/key_test.pl) - decodes and prints
keyboard inputs from the `gui key pressed` signal. Useful for checking what
keycode a particular combo generates.
- * [`template.pl`](tree/master/feature_tests/template.pl) - A basic outline of a
+ * [`template.pl`](tree/master/feature-tests/template.pl) - A basic outline of a
script to use as a starting point for others.
- * [`pipes.pl`](tree/master/feature_tests/pipes.pl) A barebones template for a
+ * [`pipes.pl`](tree/master/feature-tests/pipes.pl) A barebones template for a
script which uses forking and pipes to handle async tasks in the background
without hanging Irssi.
-* [`modules/`](tree/master/modules/) contains a few half-baked attempts at
+* [`modules/`](tree/master/modules) contains a few half-baked attempts at
loadable modules for Irssi, none of which do very much at the moment. They
might be useful as templates for your own modules, however.
-* [`no_key_modes/`](tree/master/no_key_modes/) provides an additional expando
+* [`no-key-modes/`](tree/master/no-key-modes) provides an additional expando
`$M_nopass` which you can add to your theme to provide channel modes, but
without showing the channel key. This is probably less useful since someone
pointed me at `/set chanmode_expando_strip` which has much the same effect.
-* [`patches/`](tree/master/patches/) contains a few patches for the irssi
+* [`patches/`](tree/master/patches) contains a few patches for the irssi
source, probably out of date by now, which do various things. The easiest way
to figure out what is to read them, unless I get bored and document them
sometime.
-* [`prompt_info/`](tree/master/prompt_info/) was the original "How can I put
+* [`prompt_info/`](tree/master/prompt_info) was the original "How can I put
dynamic status crap into my prompt string" script. This has since been
superceded by the far nicer `uberprompt.pl` which also lives in that dir.
Many of my other scripts require uberprompt as a way to provide part of their
user interface.
-* [`sb_position/`](tree/master/sb_position/) gives you an additional status bar
+* [`sb-position/`](tree/master/sb-position) gives you an additional status bar
item which indicates approximately how far you are scrolled in a given window
buffer, in terms of pages and percentage. It is configurable as the comments
in the script explain.
-* [`scrolled_reminder/`](tree/master/scrolled_reminder/) is a script that tries
+* [`scrolled-reminder/`](tree/master/scrolled-reminder) is a script that tries
to prevent one of the more common accidental IRC screwups -- replying to a
conversation that happened hours ago because you didn't notice you were
scrolled up in the history buffer. If you try to send a message whilst
scrolled, it'll warn you and check you really want to first.
-* [`quit-notify/`](tree/master/quit-notify/) is based on a script by
+* [`quit-notify/`](tree/master/quit-notify) is based on a script by
vague@#irssi/Freenode. It is most useful when you are ignoring
joins/parts/quits from a channel, and hence don't realise when the person you
are responding to has left. If they have (or if you prefix your message with
a nonexistent nick), the script will ask you to confirm that you want to send
the message, much like `scrolled_reminder`.
-* [`undo/`](tree/master/undo/) contains 2 scripts, `undo.pl` and
+* [`undo/`](tree/master/undo) contains 2 scripts, `undo.pl` and
`kill-ring.pl`. See their header for further documentation.
-* [`testing/`](tree/master/testing/) is a Perl framework external to Irssi (ie:
+* [`testing/`](tree/master/testing) is a Perl framework external to Irssi (ie:
not a script) that will ultimately allow you to write unit tests for your
scripts, and run them in a real irssi instance, and check that they behave
- correctly. Still undergoing heavy development, and not really ready for
- public usage.
+ correctly.
+
+ *Still undergoing heavy development, and not really ready for public usage.*
-* [`throttled_autojoin/`](tree/master/throttled_autojoin/) doesn't work. It's
+* [`throttled-autojoin/`](tree/master/throttled-autojoin) doesn't work. It's
meant to allow people with huuuuuuge numbers of autojoin channels and servers
to connect slowly, so as not to time themselves out when reconnecting. Mostly
dead.
-* [`tinyurl_tabcomplete/`](tree/master/tinyurl_tabcomplete/) is a script which
+* [`tinyurl-tabcomplete/`](tree/master/tinyurl-tabcomplete) is a script which
lets you hit tab following anything that looks like a URL to replace it with a
tinyurl'd version. Handy if you regularly paste Google-maps links or other
massive horrible links.
-* [`url_hilight/`](tree/master/url_hilight/) I can't remember what this one
- does. Suggestions welcome.
+* [`url_hilight/`](tree/master/url_hilight) I can't remember what this one
+ does. Suggestions & ideas welcome.
-* [`vim_mode/`](tree/master/vim_mode/) The most exciting (and by far the
+* [`vim-mode/`](tree/master/vim-mode) The most exciting (and by far the
largest) script here. Gives vim-addicted users a way to use most of their
finger-memory in Irssi. Still under active development, features and
bug-requests welcome. Also supported in #irssi_vim on Freenode.
@@ -135,16 +136,17 @@ reminder. I'll go create an issue for it Right Now!
#### Script ideas
* override `/set` to provide list manipulation options, something like `/set
-{-append, -remove} $param $value`.
+{-append, -remove} $param $value`. Bit like a general purpose version of
+[`hide.pl`](http://scripts.irssi.org/html/hide.pl.html)
-* Finish work on [`foreach-guard`](tree/master/foreach-guard/)
+* Finish work on [`foreach-guard`](tree/master/foreach-guard)
-* Finish (Well, start) something in [`colour_popup`](tree/master/colour_popup/)
+* Finish (Well, start) something in [`colour-popup`](tree/master/colour-popup)
to make an actual popup
* Revisit some of the cracked-out ideas for colour/format overlays
-* Go back and clean up [`irssi_vim`](tree/master/irssi_vim/) like I promised to
+* Go back and clean up [`irssi-vim`](tree/master/irssi-vim) like I promised to
everyone ages and ages ago. Also do the features thing.
* Actually fix all the [issues](https://github.com/shabble/irssi-scripts/issues)
@@ -168,8 +170,8 @@ general features.
* Do something productive again on the 256colour fork/patches
-* Ditto @leonerd's [fixterms](http://www.leonerd.org.uk/hacks/fixterms/) key
-binding support
+* Ditto [@leonerd](/leonerd)'s
+[fixterms](http://www.leonerd.org.uk/hacks/fixterms/) key binding support
* Try to get someone to look at my patches & bug reports.