7 Commits

Author	SHA1	Message	Date
Zach Panzarino	e3a4147ac9	Update copyright date	2015-12-31 23:28:40 +00:00
practicalswift	cd7d8dfaff	Fix alignment as requested by @gribozavr in #692	2015-12-21 08:54:24 +01:00
practicalswift	176f487d76	Fix incorrect filenames in headers.	2015-12-20 23:59:05 +01:00
David Farler	e576dba665	Add missing continue statement when measuring tab indents in doc comments ... Actually look for more than one tab when measuring initial indentation in doc comments. rdar://problem/22209582 Swift SVN r32461	2015-10-06 08:51:57 +00:00
David Farler	794d9ed84d	Check both ends of doc comments before trimming ... Doc comments assume a prefix of /** and a suffix of */ but if a user accidentally types /**/, SourceKit can crash and bring down Xcode with certain timings. Check both ends of doc comments before dropping characters. rdar://problem/21105409 Swift SVN r29035	2015-05-26 18:25:19 +00:00
David Farler	09b486dbcd	ObjC Header missing comment markers for some newline cases ... Printing Doxygen isn't inside an XML tag, so we can't just print code block content, which may have new lines without a doc comment marker. Also, be more robust with indentation. + Tests. rdar://problem/20703026 Swift SVN r27851	2015-04-28 01:32:54 +00:00
David Farler	ca5876a866	swiftMarkup Library ... Replace ReST-flavored documentation comments with Markdown. rdar://problem/20180412 In addition to full Markdown support, the following extensions are supported. These appear as lists at the top level of the comment's "document". All of these extensions are matched without regard to case. Parameter Outlines ------------------ - Parameters: - x: ... - y: ... Separate Parameters ------------------- - parameter x: ... - parameter y: ... - Note: Parameter documentation may be broken up across the entire comment, with a mix of parameter documentation kinds - they'll be consolidated in the end. Returns ------- - returns: ... The following extensions are also list items at the top level, which will also appear in Xcode QuickHelp as first-class citizens: - Attention: ... - Author: ... - Authors: ... - Bug: ... - Complexity: ... - Copyright: ... - Date: ... - Experiment: ... - Important: ... - Invariant: ... - Note: ... - Postcondition: ... - Precondition: ... - Remark: ... - Remarks: ... - See: ... - Since: ... - Todo: ... - Version: ... - Warning: ... These match most of the extra fields in Doxygen, plus a few more per request. Other changes ------------- - Remove use of rawHTML for all markup AST nodes except for those not representable by the Xcode QuickHelp XSLT - <h>, <hr/>, and of course inline/block HTML itself. - Update the doc comment RNG schema to more accurately reflect Xcode QuickHelp. - Clean up cmark CMake configuration. - Rename "FullComment" to "DocComment" - Update the Swift Standard Documentation (in a follow-up commit) - Update SourceKit for minor changes and link against cmark (in a follow-up commit). Swift SVN r27727	2015-04-26 00:07:15 +00:00