From 35d641795bc2210e6cfe29c14327a2bc12ad5694 Mon Sep 17 00:00:00 2001 From: Nick Daly Date: Wed, 23 May 2012 20:58:55 -0500 Subject: [PATCH] Documentation updates. --- ugly_hacks/santiago/README.rst | 27 ++++++++++++--------------- ugly_hacks/santiago/santiago.py | 14 +++++++++++++- 2 files changed, 25 insertions(+), 16 deletions(-) diff --git a/ugly_hacks/santiago/README.rst b/ugly_hacks/santiago/README.rst index e80f2ffb2..47c00c523 100644 --- a/ugly_hacks/santiago/README.rst +++ b/ugly_hacks/santiago/README.rst @@ -1,26 +1,23 @@ .. -*- mode: rst; fill-column: 80; mode: auto-fill; -*- -========== - Santiago -========== ----------------------------- -Less Discoverable Discovery? ----------------------------- +========================= +Person-Focused Networking +========================= +----------------------- +The FreedomBuddy System +----------------------- -This file is distributed under a Creative Commons Attribution-ShareAlike 3.0 -Unported, Version 3 license. This CC-By-SA license is available in both full_ -and summarized_ versions from Creative Commons. This file is also distributed -under the `GNU Free Documentation License`_, version 1.3 or later. +:Author: Nick Daly, 2012 +:License: This file is distributed under a Creative Commons + Attribution-ShareAlike 3.0 Unported, Version 3 license. This CC-By-SA + license is available in both full_ and summarized_ versions from Creative + Commons. This file is also distributed under the `GNU Free Documentation + License`_, version 1.3 or later. .. _full: http://creativecommons.org/licenses/by-sa/3.0/legalcode .. _summarized: http://creativecommons.org/licenses/by-sa/3.0/ .. _GNU Free Documentation License: http://www.gnu.org/licenses/fdl.html -Disclaimer -========== - -**The following is an incomplete hack. Beware!** - Santiago's Map ============== diff --git a/ugly_hacks/santiago/santiago.py b/ugly_hacks/santiago/santiago.py index 3a32b8b06..9536d996b 100644 --- a/ugly_hacks/santiago/santiago.py +++ b/ugly_hacks/santiago/santiago.py @@ -26,7 +26,19 @@ We don't: :FIXME: allow multiple listeners and senders per protocol (with different proxies) -This dead-drop is what came of my trying to learn from bug 4185. +This dead-drop approach is what came of my trying to learn from bug 4185. + +To see the system learn from itself, try running a few queries similar to: + +#. https://localhost:8080/where/D95C32042EE54FFDB25EC3489F2733F40928D23A/santiago +#. https://localhost:8080/provide/D95C32042EE54FFDB25EC3489F2733F40928D23A/santiago/localhost:8081 +#. https://localhost:8080/learn/D95C32042EE54FFDB25EC3489F2733F40928D23A/santiago +#. https://localhost:8080/where/D95C32042EE54FFDB25EC3489F2733F40928D23A/santiago + +#. See what services are currently available. +#. Start serving at the "localhost:8081" location. +#. Learn the 8081 location. +#. See what services are currently available, including the 8081 service. Santiago, he smiles like a Buddah, 'neath