cpphl
diff --git a/‎images/boost.png renamed to ‎_images/boost.png b/‎images/boost.png renamed to ‎_images/boost.png
diff --git a/‎static/boost.png renamed to ‎_images/boost1.png b/‎static/boost.png renamed to ‎_images/boost1.png
diff --git a/‎_images/ftp_uri.png
25 KB b/‎_images/ftp_uri.png
25 KB
diff --git a/‎_images/ftp_uri1.png
25 KB b/‎_images/ftp_uri1.png
25 KB
diff --git a/‎_images/http_uri.png
20.2 KB b/‎_images/http_uri.png
20.2 KB
diff --git a/‎_images/http_uri1.png
20.2 KB b/‎_images/http_uri1.png
20.2 KB
diff --git a/‎_images/mailto_uri.png
9.98 KB b/‎_images/mailto_uri.png
9.98 KB
diff --git a/‎_images/mailto_uri1.png
9.98 KB b/‎_images/mailto_uri1.png
9.98 KB
diff --git a/‎_sources/atom_reader.txt
Lines changed: 76 additions & 0 deletions b/‎_sources/atom_reader.txt
Lines changed: 76 additions & 0 deletions
diff --git a/‎sources/directives.txt renamed to ‎_sources/directives.txt b/‎sources/directives.txt renamed to ‎_sources/directives.txt
@@ -0,0 +1,76 @@
+.. _atom_reader:
+
+*************
+ Atom reader
+*************
+
+The next examples show some simple, more practical applications using
+the HTTP client.  The first one reads a simple Atom feed and prints
+the titles of each entry to the console.
+
+The code
+========
+
+.. code-block:: c++
+
+   #include "atom.hpp"
+   #include <boost/network/protocol/http/client.hpp>
+   #include <boost/foreach.hpp>
+   #include <iostream>
+
+   int main(int argc, char * argv[]) {
+       using namespace boost::network;
+
+       if (argc != 2) {
+           std::cout << "Usage: " << argv[0] << " <url>" << std::endl;
+           return 1;
+       }
+
+       try {
+           http::client client;
+           http::client::request request(argv[1]);
+           request << header("Connection", "close");
+           http::client::response response = client.get(request);
+           atom::feed feed(response);
+
+           std::cout << "Feed: " << feed.title()
+	   	     << " (" << feed.subtitle() << ")" << std::endl;
+           BOOST_FOREACH(const atom::entry &entry, feed) {
+               std::cout << entry.title()
+	       		 << " (" << entry.published() << ")" << std::endl;
+           }
+       }
+       catch (std::exception &e) {
+           std::cerr << e.what() << std::endl;
+       }
+
+       return 0;
+   }
+
+Building and running ``atom_reader``
+====================================
+
+.. code-block:: bash
+
+    $ cd ~/cpp-netlib-build
+    $ make atom_reader
+
+And to run the example from the command line to access the feed that
+lists of all the commits on cpp-netlib's master repository:
+
+.. code-block:: bash
+
+    $ ./example/atom_reader https://github.com/cpp-netlib/cpp-netlib/commits/master.atom
+
+Diving into the code
+====================
+
+Most of this will now be familiar.  The response is passed to the
+constructor to the ``atom::feed`` class, which parses the resultant
+XML.  To keep this example as simple as possible, `rapidxml`_, a
+header-only XML parser library, was used to parse the response.
+
+.. _`rapidxml`: http://rapidxml.sourceforge.net/
+
+A similar example using RSS feeds exists in
+``libs/network/example/rss``.