SDP creates non-headerdoc compatible comments

Originator:orta.therox
Number:rdar://26877999 Date Originated:18-Jun-2016 08:33
Status:Open Resolved:
Product:Dev Tools Product Version:
Classification: Reproducible:
 
Summary:
Currently running `sdef /Applications/Xcode-beta.app | sdp -fh --basename Xcode` gives you output like:

```
// A setting that controls how products are built.
@interface XcodeBuildSetting : SBObject <XcodeGenericMethods>

@property (copy) NSString *name;  // The unlocalized build setting name (e.g. DSTROOT).
@property (copy) NSString *value;  // A string value for the build setting.


@end
```

It would be awesome for readability for that to move to be more like
```
/// A setting that controls how products are built.
@interface XcodeBuildSetting : SBObject <XcodeGenericMethods>

/// The unlocalized build setting 
@property (copy) NSString *name; name (e.g. DSTROOT).
/// A string value for the build 
@property (copy) NSString *value; setting.

@end
```

Which would mean the documentation is attached throughout Xcode.

Steps to Reproduce:
Once Xcode is installed
`def /Applications/Xcode-beta.app | sdp -fh --basename Xcode`

Expected Results:
Comments that I can use with documentation throughout the Xcode project I am using it in. 

Actual Results:
Comments that I can see only inside the header file

Version:
10.12 / Xcode 8 seed 1

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!