Quick Help Renders incomplete incorrect Markup Documentation

Originator:aaroncrespo
Number:rdar://31611366 Date Originated:4/13/17
Status:open Resolved:
Product:Developer Tools Product Version:
Classification: Reproducible:Always
 
aaron crespo13-Apr-2017 03:17 PM

Summary:
Quick Help Renders incomplete incorrect Markup from various annotations

Steps to Reproduce:
1. Code some swift with markup documentation
2. Ex:
```
/**
 Description

 - example: `Foo`
 
 - seealso: [link](www.apple.com)

**/
struct Foo {}
//        -^-cmd+click Foo
```
3. cmd click a definition for Quick Help ballon
4. or
5. open the Quick Help inspector

Expected Results:
All the written Documentation Appears in the quick help

Actual Results:
If using the example given in reproduction steps
seealso is missing
example is rendered incorrectly. 

Version:
Xcode 8.3.1 macOS Sierra 10.12.4 (16E195), swift 3.1

Notes:
See provided example.

Configuration:
Normal Xcode editing configuration

Attachments:

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!