diff --git a/README.mdown b/README.mdown
index 6faeab76..ccd3392d 100644
--- a/README.mdown
+++ b/README.mdown
@@ -132,6 +132,7 @@ Handlers
   [raven](https://packagist.org/packages/raven/raven).
 - _ZendMonitorHandler_: Logs records to the Zend Monitor present in Zend Server.
 - _NewRelicHandler_: Logs records to a [NewRelic](http://newrelic.com/) application.
+- _SyslogUdpHandler_: Logs records to a remote [Syslogd](http://www.rsyslog.com/) server.
 
 ### Logging in development
 
diff --git a/src/Monolog/Handler/SyslogUdpHandler.php b/src/Monolog/Handler/SyslogUdpHandler.php
index 8cb6e6c3..1188ca4a 100644
--- a/src/Monolog/Handler/SyslogUdpHandler.php
+++ b/src/Monolog/Handler/SyslogUdpHandler.php
@@ -14,6 +14,18 @@ namespace Monolog\Handler;
 use Monolog\Logger;
 use Monolog\Handler\SyslogUdp\UdpSocket;
 
+/**
+ * A Handler for logging to a remote syslogd server.
+ * Example usage (given you have a syslogd server on your local machine):
+ * <code>
+ * $logger = new \Monolog\Logger();
+ * $handler = new SyslogUdpHandler("local5", "127.0.0.1");
+ * $handler->setFormatter(new \Monolog\Formatter\LineFormatter());
+ * $logger->pushHandler($handler);
+ * $logger->warn("Hello from abroard!");
+ * </code>
+ */
+
 class SyslogUdpHandler extends AbstractProcessingHandler
 {
     protected $facility;