[SR-3281] The Swift Man Page Is Woefully Out Of Date

[CodaFi]

Previous ID	SR-3281
Radar	None
Original Reporter	@CodaFi
Type	Improvement
Status	Closed
Resolution	Done

Additional Detail from JIRA

Votes	0
Component/s	Compiler
Labels	Improvement, StarterBug
Assignee	contraultra (JIRA)
Priority	Medium

md5: ca5847c3757d9b69faea339dda8a8066

Issue Description:

This is our current man page.

swift(1)                    Swift Documentation                    swift(1)

NAME
       swift - the amazingly new programming language

SYNOPSIS
       swift [-help] [input-filename [program-arguments]]

       swiftc [-emit-object|-emit-assembly|-emit-library]
         [-help]
         -o output-file
         input-filenames

       The full list of supported options is available via "swift -help" or
       "swiftc -help".

DESCRIPTION
       Swift is a new, high performance systems programming language.  It
       has a clean and modern syntax, and offers seamless access to
       existing C and Objective-C code and frameworks, and is memory safe
       (by default).

       Although inspired by Objective-C and many other languages, Swift is
       not itself a C-derived language. As a complete and independent
       language, Swift packages core features like flow control, data
       structures, and functions, with high-level constructs like objects,
       protocols, closures, and generics.  Swift embraces modules,
       eliminating the need for headers and the code duplication they
       entail.

swift 3.0.1                      2016-10-11                        swift(1)

While I like to think Swift is still "amazingly new", it has grown in the nearly 2 years since this page was updated and the man page should reflect that with a modern rewrite.

[CodaFi]

This branch shows an example of what needs to be done to edit the files that generate this page.

[swift-ci]

Comment by Geoffrey Wiseman (JIRA)

Maybe this is worth discussion on Swift Evolution about what this man page should look like these days?

[swift-ci]

Comment by nate (JIRA)

Update to the Swift man page has been merged.