General comment cleaning / refactoring for Mac Installer

chrome/installer/mac/app/AuthorizedInstall.m

 // Copyright 2016 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.
 
 #import "AuthorizedInstall.h"
 
 @interface AuthorizedInstall () {
   NSFileHandle* communicationFile_;
   NSString* destinationAppBundlePath_;
 }
 @end
 
 @implementation AuthorizedInstall
-// Does the setup needed to authorize a tool to run as admin.
+// Does the setup needed to authorize a subprocess to run as root.
 - (OSStatus)setUpAuthorization:(AuthorizationRef*)authRef {
   OSStatus status = AuthorizationCreate(NULL, kAuthorizationEmptyEnvironment,
                                         kAuthorizationFlagDefaults, authRef);
 
   AuthorizationItem items = {kAuthorizationRightExecute, 0, NULL, 0};
   AuthorizationRights rights = {1, &items};
   AuthorizationFlags flags =
       kAuthorizationFlagDefaults | kAuthorizationFlagInteractionAllowed |
       kAuthorizationFlagPreAuthorize | kAuthorizationFlagExtendRights;
 
@@ skipping 50 matching lines @@
     if (![manager fileExistsAtPath:usersApplicationsDirectory]) {
       [manager createDirectoryAtPath:usersApplicationsDirectory
           withIntermediateDirectories:NO
                            attributes:nil
                                 error:nil];
     }
     return usersApplicationsDirectory;
   }
 }
 
-// Attempts to gain authorization to run installation tool with elevated
-// permissions.
-// Then starts the tool with the appropiate paths for the tools elevation
-// status.
 - (BOOL)loadInstallationTool {
   AuthorizationRef authRef = NULL;
   OSStatus status = [self setUpAuthorization:&authRef];
   BOOL isAuthorized = (status == errAuthorizationSuccess);
 
   NSString* toolPath =
       [[NSBundle mainBundle] pathForResource:@"copy_to_disk" ofType:@"sh"];
   NSFileManager* manager = [NSFileManager defaultManager];
   if (![manager fileExistsAtPath:toolPath]) {
     return false;
@@ skipping 11 matching lines @@
                        status:status];
   } else {
     NSArray* args = @[ applicationsDirectory ];
     [self startUnprivilegedTool:toolPath withArguments:args];
   }
 
   AuthorizationFree(authRef, kAuthorizationFlagDestroyRights);
   return true;
 }
 
-- (NSString*)startInstall:(NSString*)appBundlePath {
-  [self sendMessageToTool:appBundlePath];
-  return destinationAppBundlePath_;
-}
-
 // Sends a message to the tool's stdin. The tool is using 'read' to wait for
 // input. 'read' adds to its buffer until it receives a newline to continue so
 // append '\n' to the message to end the read.
 - (void)sendMessageToTool:(NSString*)message {
   [communicationFile_  writeData:[[message stringByAppendingString:@"\n"]
                dataUsingEncoding:NSUTF8StringEncoding]];
 }
 
+- (NSString*)startInstall:(NSString*)appBundlePath {
+  [self sendMessageToTool:appBundlePath];
+  return destinationAppBundlePath_;
+}
+
 @end