Update pages and do some spellchecking

[pages] / tools / vpaste.md

diff --git a/tools/vpaste.md b/tools/vpaste.md
index 5626f90dfdfbeca1c533cd93ba1d1660d52951a3..95ff6be5a17b0b05f11c0362a6cc3773682b87a5 100644 (file)
--- a/tools/vpaste.md
+++ b/tools/vpaste.md
@@ -1,3 +1,45 @@
 vpaste is a pastebin that uses Vim for syntax highlighting.
 
-<http://vpaste.net/>
+The pastebin
+------------
+* <http://vpaste.net/>
+
+Source Code
+-----------
+Source code is available in git and [gitweb](/git/?p=vpaste)
+
+    git clone git://pileus.org/vpaste
+
+Embedding examples
+------------------
+vpaste allows pastes to be embedded in external websites:
+
+<script type="text/javascript" src="http://vpaste.net/embed.js?ft=sh">
+       #!/bin/bash
+
+       echo Hello, World > test.txt
+</script>
+
+This can be done by including code in the script tag itself, as in the above
+example, or by linking to an existing paste:
+
+<script type="text/javascript" src="http://vpaste.net/embed.js?vpaste"></script>
+
+A third way to use the embedding script is to include it once, possibly in the
+in the header, and then call the `format_code('pre','vpaste')` function later
+on to perform syntax highlighting on all the `<pre class="vpaste">` tags.
+
+In this case, slightly more care must be taken to properly escape HTML
+characters scuh as `<` and `>`.
+
+<pre class="vpaste" title="ft=c">
+       #include &lt;stdio.h&gt;
+
+       int main(int argc, char **argv)
+       {
+               printf("hello, world");
+               return 0;
+       }
+</pre>
+
+<script type="text/javascript">format_code('pre', 'vpaste');</script>