The following BEFORE and AFTER chunks of code show that Doxygen mangles comments that occur inside Objective-C code blocks when processing a @snippet. In the AFTER chunk, note how the comment "// Reveal Show Payoff button to enable redirection to payoff." and the following line "//" have been moved outside the code block and the end-of-line characters for those two comment lines have been removed.

BEFORE (the source code):
    // Resolve payload.
    //
    [self.resolver resolve:payload completionBlock:^(DMResolveResult *result, NSError *error) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (error) {
                [self showError:error];
            } else {
                
                // Reveal Show Payoff button to enable redirection to payoff.
                //
                self.payoff = (DMPayoff *) result.payoff;
                self.showActivityIndicator = NO;
                self.showPayoffButton.hidden = NO;
            }
        });
    }];

AFTER (the presented code):
    // Resolve payload.
    //
    // Reveal Show Payoff button to enable redirection to payoff.//[self.resolver resolve:payload completionBlock:^(DMResolveResult *result, NSError *error) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (error) {
                [self showError:error];
            } else {
                
                
                
                self.payoff = (DMPayoff *) result.payoff;
                self.showActivityIndicator = NO;
                self.showPayoffButton.hidden = NO;
            }
        });
    }];