diff --git a/objectstore/ArchiveRequest.cpp b/objectstore/ArchiveRequest.cpp
index 54d143eb749baf710a5a5cf780b0c6cf3d1b1b7d..fd3145a6d36d85d48e61293806d5f6900ffcc206 100644
--- a/objectstore/ArchiveRequest.cpp
+++ b/objectstore/ArchiveRequest.cpp
@@ -151,6 +151,9 @@ auto ArchiveRequest::addTransferFailure(uint16_t copyNumber,
   throw NoSuchJob ("In ArchiveRequest::addJobFailure(): could not find job");
 }
 
+//------------------------------------------------------------------------------
+// ArchiveRequest::addReportFailure()
+//------------------------------------------------------------------------------
 auto ArchiveRequest::addReportFailure(uint16_t copyNumber, uint64_t sessionId, const std::string& failureReason,
     log::LogContext& lc) -> EnqueueingNextStep {
   checkPayloadWritable();
diff --git a/objectstore/RetrieveRequest.cpp b/objectstore/RetrieveRequest.cpp
index 1fd833af40820ca9f17c6638f49e2d1ffb3610e7..c9c8d5320308dac0318bb53acb5bcc13e1b98f48 100644
--- a/objectstore/RetrieveRequest.cpp
+++ b/objectstore/RetrieveRequest.cpp
@@ -582,17 +582,6 @@ std::string RetrieveRequest::eventToString(JobEvent jobEvent) {
 
 //------------------------------------------------------------------------------
 // RetrieveRequest::determineNextStep()
-//
-// We have to determine which next step should be taken:
-//
-// * When transfer succeeds or fails:
-//   - If the job got transferred and is not the last (other(s) remain to transfer), it becomes complete.
-//   - If the job failed and is not the last, we will queue it as "failed" in the failed jobs queue.
-//   - If the job is the last and all jobs succeeded, this jobs becomes ToReportForTransfer
-//   - If the job is the last and any (including this one) failed, this job becomes ToReportForFailure.
-//
-// * When report completes or fails:
-//   - If the report was for a failure, the job is 
 //------------------------------------------------------------------------------
 auto RetrieveRequest::determineNextStep(uint16_t copyNumberUpdated, JobEvent jobEvent, 
     log::LogContext& lc) -> EnqueueingNextStep