Reorder class members

[builder.git] / source / action.h

diff --git a/source/action.h b/source/action.h
index 5877e8947d4667270451298b323a6b64cd4eb03b..4ae787a505814137f960c2093268e2017e4e7b05 100644 (file)
--- a/source/action.h
+++ b/source/action.h
@@ -1,3 +1,10 @@
+/* $Id$
+
+This file is part of builder
+Copyright © 2006-2007, 2009  Mikko Rasa, Mikkosoft Productions
+Distributed under the LGPL
+*/
+
 #ifndef ACTION_H_
 #define ACTION_H_
 
@@ -15,19 +22,24 @@ public:
        /// Emitted when the action has finished
        sigc::signal<void> signal_done;
        
-       /**
-       Checks whether the action is done and emits signal_done if it is.
+protected:
+       Builder &builder;
+       
+       Action(Builder &b): builder(b) { }
+public:
+       virtual ~Action() { }
 
-       @return  0 on successful completion, 1 on error, -1 if the action is still
-                executing
+       /**
+       Checks whether the action is done and emits signal_done if it is.  Returns 0
+       if the action has completed successfully, 1 if an error was encountered and
+       -1 if it is still executing.
        */
        virtual int check()=0;
        
-       virtual ~Action() { }
 protected:
-       Builder &builder;
-       
-       Action(Builder &b): builder(b) { }
+       /**
+       Annouces the action by printing out the package name, tool and target name.
+       */
        void announce(const std::string &, const std::string &, const std::string &);
 };