C++ Readability for grt.

chrome/installer/util/copy_reg_key_work_item.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_INSTALLER_UTIL_COPY_REG_KEY_WORK_ITEM_H_
 #define CHROME_INSTALLER_UTIL_COPY_REG_KEY_WORK_ITEM_H_
 #pragma once
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "base/compiler_specific.h"
 #include "chrome/installer/util/registry_key_backup.h"
 #include "chrome/installer/util/work_item.h"
 
 // A WorkItem subclass that replaces the contents of one registry key with that
 // of another (i.e., the destination is erased prior to the copy).  Be aware
 // that in the event of rollback the destination key's values and subkeys are
 // restored but the key and its subkeys take on their default security
 // descriptors.
 class CopyRegKeyWorkItem : public WorkItem {
  public:
   virtual ~CopyRegKeyWorkItem();
   virtual bool Do() OVERRIDE;
   virtual void Rollback() OVERRIDE;
 
  private:
+  // Grant WorkItem access to the ctor (required by the existing WorkItem
+  // design).
   friend class WorkItem;
 
   // Neither |source_key_path| nor |dest_key_path| may be empty.
   // Only ALWAYS and IF_NOT_PRESENT are supported for |overwrite_option|.
   CopyRegKeyWorkItem(HKEY predefined_key,
                      const std::wstring& source_key_path,
                      const std::wstring& dest_key_path,
                      CopyOverWriteOption overwrite_option);
 
   // Root key in which we operate. The root key must be one of the predefined
   // keys on Windows.
   HKEY predefined_root_;
 
   // Path of the key to be copied.
   std::wstring source_key_path_;
 
   // Path of the destination key.
   std::wstring dest_key_path_;
 
+  // WorkItem::ALWAYS or WorkItem::IF_NOT_PRESENT.
   CopyOverWriteOption overwrite_option_;
 
   // Backup of the destination key.
   RegistryKeyBackup backup_;
 
   // Set to true after the destination is cleared for the copy.
   bool cleared_destination_;
 
   DISALLOW_COPY_AND_ASSIGN(CopyRegKeyWorkItem);
 };
 
 #endif  // CHROME_INSTALLER_UTIL_COPY_REG_KEY_WORK_ITEM_H_