Added documentation

modules/Bio/EnsEMBL/Hive/AnalysisJob.pm

@@ -154,6 +154,16 @@ sub autoflow {
 }
 
 
+=head2 create_new_attempt
+
+    Title   :  create_new_attempt
+    Function:  Create a new attempt for the given role on this job. If a database is
+               available (i.e. the job has an adaptor) the attempt will be stored and
+               and the job linked to it
+    Returns :  Bio::EnsEMBL::Hive::Attempt
+
+=cut
+
 sub create_new_attempt {
     my ($self, $role) = @_;
 

modules/Bio/EnsEMBL/Hive/Attempt.pm

@@ -8,6 +8,9 @@
 
     An object to describe an attempt of a job.
     It is stored in its own table (attempt) indexed by a dbID, and is thus Storable
+    In this model, a job (AnalysisJob) is the fixed representation of a task, and
+    an attempt is a runtime instance of this job. A job may still be tried several
+    times (have multiple attempts) before finally succeeding.
 
 =head1 LICENSE
 

modules/Bio/EnsEMBL/Hive/DBSQL/LogMessageAdaptor.pm

@@ -54,6 +54,15 @@ sub default_table_name {
 }
 
 
+=head2 store_attempt_message
+
+    Title   :  store_attempt_message
+    Function:  Add a new entry to the log_message table, by filling the fields from
+               the properties of the attempt (identified by its dbID).
+    Returns :  None
+
+=cut
+
 sub store_attempt_message {
     my ($self, $attempt_id, $msg, $message_class) = @_;