From 52857f08b9881ced1ee980b3a5aa0f159b165e86 Mon Sep 17 00:00:00 2001
From: johnny <johnny@3ecf2c5c-341e-0410-92b4-d18e462d057c>
Date: Fri, 24 Feb 2006 12:22:25 +0000
Subject: [PATCH] - More documentation

git-svn-id: svn://svn.gna.org/svn/sgpemv2/trunk@437 3ecf2c5c-341e-0410-92b4-d18e462d057c
---
 src/backend/dummy_policy.cc |  3 ++-
 src/backend/dummy_policy.hh | 43 ++++++++++++++++++++-----------------
 2 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/src/backend/dummy_policy.cc b/src/backend/dummy_policy.cc
index f256478..54a510b 100644
--- a/src/backend/dummy_policy.cc
+++ b/src/backend/dummy_policy.cc
@@ -19,6 +19,7 @@
 // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 
 #include "dummy_policy.hh"
+
 using namespace std;
 using namespace sgpem;
 
@@ -42,7 +43,7 @@ DummyPolicy::configure()
 Glib::ustring
 DummyPolicy::get_description() const
 {
-	return "Questa è una STUPIDISSIMA politica implementata in C++. Serve solo per debug.";
+	return "This is a dummy policy implemented in C++. It is just needed as a debug stub.";
 }
 
 bool
diff --git a/src/backend/dummy_policy.hh b/src/backend/dummy_policy.hh
index 4e2e51e..49a2c2b 100644
--- a/src/backend/dummy_policy.hh
+++ b/src/backend/dummy_policy.hh
@@ -29,25 +29,28 @@
 
 namespace sgpem
 {
+  class DummyPolicy;
 
-	class DummyPolicy;
-	
-	class SG_DLLEXPORT DummyPolicy : public Policy
-	{
-	public:
-		virtual ~DummyPolicy();
-				
-		virtual void			configure();
-		virtual void 			sort_queue(sgpem::Scheduler::event) const;
-		virtual Glib::ustring 	get_description() const;
-		virtual bool 			is_pre_emptive() const;
-		virtual int				get_time_slice() const;
-		virtual void 			set_time_slice(const int&);
-				
-	private:
-		int _time_slice;
-	};
-	
-}//~ namespace sgpem
+  /** \brief This is a trivial policy for demostration purposes only
+   *
+   * This trivial schedulation policy was needed during initial development
+   * as stub. It is now maintained as an example of how built-in policy can
+   * be implemented in C++.
+   */
+  class SG_DLLEXPORT DummyPolicy : public Policy
+  {
+  public:
+    virtual ~DummyPolicy();
+    virtual void configure();
+    virtual void sort_queue(sgpem::Scheduler::event) const;
+    virtual Glib::ustring get_description() const;
+    virtual bool is_pre_emptive() const;
+    virtual int get_time_slice() const;
+    virtual void set_time_slice(const int&);
 
-#endif
+  private:
+    int _time_slice;
+  };
+} //~ namespace sgpem
+
+#endif // DUMMYPOLICY_HH