X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/de7fa86f6692ae017293079b92f90631e2e4e261..5b2ab63f7873b27229a5617d0c208a526b25cd2c:/doc/shortcuts.mdwn?ds=inline

diff --git a/doc/shortcuts.mdwn b/doc/shortcuts.mdwn
index ab3fb1031..fd27544a3 100644
--- a/doc/shortcuts.mdwn
+++ b/doc/shortcuts.mdwn
@@ -2,6 +2,12 @@
      then="This wiki has shortcuts **enabled**."
      else="This wiki has shortcuts **disabled**."]]
 
+Some examples of using shortcuts include:
+
+	\[[google foo]]
+	\[[wikipedia War_of_1812]]
+	\[[debbug 12345]]
+
 This page controls what shortcut links the wiki supports.
 
 * [[shortcut name=google url="http://www.google.com/search?q=%s"]]
@@ -16,14 +22,18 @@ This page controls what shortcut links the wiki supports.
 * [[shortcut name=debpts url="http://packages.qa.debian.org/%s"]]
 * [[shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]]
 * [[shortcut name=debrt url="https://rt.debian.org/Ticket/Display.html?id=%s"]]
+* [[shortcut name=debss url="http://snapshot.debian.net/package/%s"]]
+  * Usage: `\[[debss package]]`, `\[[debss package#version]]`, or `\[[debss package/version]]`.  See http://snapshot.debian.net for details.
 * [[shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]]
 * [[shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]]
 * [[shortcut name=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]]
 * [[shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]]
+* [[shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]]
+* [[shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]]
 * [[shortcut name=marcmsg url="http://marc.info/?i=%s"]]
 * [[shortcut name=marclist url="http://marc.info/?l=%s"]]
 * [[shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]]
-* [[shortcut name=gmanemsg url="http://news.gmane.org/find-root.php?message_id=%s"]]
+* [[shortcut name=gmanemsg url="http://mid.gmane.org/%s"]]
 * [[shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]]
 * [[shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]]
 * [[shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]]
@@ -47,13 +57,15 @@ This page controls what shortcut links the wiki supports.
 * [[shortcut name=zooomr url="http://www.zooomr.com/photos/%s"]]
   * Note: You have to include the username and number in here, such as `bob/123455`.
 
-To add a new shortcut, use the `shortcut` [[PreprocessorDirective]]. "%s" is
-replaced with the text passed to the named shortcut. The optional `desc`
-parameter controls the description of the link.
+To add a new shortcut, use the `shortcut`
+[[ikiwiki/PreprocessorDirective]]. In the url, "%s" is replaced with the
+text passed to the named shortcut, after url-encoding it, and '%S' is
+replaced with the raw, non-encoded text. The optional `desc` parameter
+controls the description of the link.
 
 Remember that the `name` you give the shortcut will become a new
-[[PreprocessorDirective]].  Avoid using a `name` that conflicts with an
-existing directive.
+[[ikiwiki/PreprocessorDirective]].  Avoid using a `name` that conflicts
+with an existing directive.
 
 If you come up with a shortcut that you think others might find useful,
 consider contributing it to the [[iki shortcuts]] page on the ikiwiki