Texinfo documentation, website and asciicasts

[paster.git] / doc / features.texi

diff --git a/doc/features.texi b/doc/features.texi
new file mode 100644 (file)
index 0000000..56bcfa6
--- /dev/null
+++ b/doc/features.texi
@@ -0,0 +1,31 @@
+@node Features
+@unnumbered Features
+
+@itemize
+
+@item It uses file system for storing the pastes
+
+@item Pastes are shared through the external program (HTTP, FTP, Gopher, ...)
+
+@item Paste files have an extension (@file{.txt} by default), that can
+    be overriden for the given paste. So your HTTP service can answer
+    with varying @code{Content-Types}. You can share images for example,
+    not only plaintext
+
+@item No excessive HTTP protocol: just send
+    @url{https://en.wikipedia.org/wiki/Bencode, bencode}-ed dictionary
+    with the data over the TCP
+
+@item Newline is appended for @file{.txt}/@file{.url} pastes, if it is missing
+
+@item SHA512/2 checksum is sent back to you, for integrity checking
+
+@item Intended to be run as a @url{https://cr.yp.to/ucspi-tcp.html, UCSPI-TCP}
+    service @url{http://cr.yp.to/daemontools.html, daemontools}-like supervisor
+
+@item Can automatically generate HTML files with the links for automatic
+    @url{https://asciinema.org/, asciicasts} playback.
+
+@item You can clear an old ones with simple:
+    @code{find pastes -ctime XXX -delete}
+@end itemize