@@ -10,12 +10,37 @@ Add new items at the end of the relevant section under **Unreleased**.
1010
1111--- 
1212
13+ ## [ 1.4.0]  - 2024-05-21 
14+ 
15+ ### Additions  
16+ 
17+ -  Adds support for subcommand aliases via a new ` CommandConfiguration.aliases `  
18+   parameter. Aliases are shown in help text and used during command parsing. For
19+   example, a subcommand like "average" from the example "math" tool can be
20+   defined with the aliases ` ["avg"] ` . The resulting subcommand can now be
21+   invoked with either of ` math stats average `  and ``math stats avg`. See the
22+   updated documentation and example for additional details. ([ #627  ] )
23+ -  Adds a new API ` usageString `  to ` ParsableArguments `  and ` ParsableCommand `  for
24+   retrieving their usage text, allowing for more flexible construction of error
25+   screens. ([ #634  ] )
26+ -  Adds support for passing custom arguments to ` AsyncParsableCommand.main() ` 
27+   with a new ` static func main(_ arguments: [String]?) async `  method. ([ #568  ] )
28+ 
29+ ### Fixes  
30+ 
31+ -  Removes default parameter values from deprecated CommandConfiguration
32+   initializers to prevent them from being selected as overloads. Some niche
33+   invalid deprecation warnings should no longer occur. ([ #636  ] )
34+ 
35+ The 1.4.0 release includes contributions from [ Austinpayne] , [ dcantah] ,
36+ [ KS1019] , [ natecook1000] , [ rauhul] , and [ revolter] . Thank you!
37+ 
1338## [ 1.3.1]  - 2024-03-16 
1439
1540### Changes  
1641
1742-  The ` CommandConfiguration `  type is now designated as ` Sendable ` . ([ #615  ] )
18- -  The library uses ` internal `  imports instead of `` @_ implementationOnly` annotations
43+ -  The library uses ` internal `  imports instead of ` @_implementationOnly `  annotations
1944  in Swift versions where permitted. ([ #616  ] )
2045
2146### Fixes  
@@ -867,7 +892,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
867892
868893<!--  Link references for releases --> 
869894
870- [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.3.1...HEAD 
895+ [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.4.0...HEAD 
896+ [ 1.4.0 ] : https://github.com/apple/swift-argument-parser/compare/1.3.1...1.4.0 
871897[ 1.3.1 ] : https://github.com/apple/swift-argument-parser/compare/1.3.0...1.3.1 
872898[ 1.3.0 ] : https://github.com/apple/swift-argument-parser/compare/1.2.3...1.3.0 
873899[ 1.2.3 ] : https://github.com/apple/swift-argument-parser/compare/1.2.2...1.2.3 
@@ -964,6 +990,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
964990[ #552 ] : https://github.com/apple/swift-argument-parser/pull/552 
965991[ #554 ] : https://github.com/apple/swift-argument-parser/pull/554 
966992[ #565 ] : https://github.com/apple/swift-argument-parser/pull/565 
993+ [ #568 ] : https://github.com/apple/swift-argument-parser/pull/568 
967994[ #572 ] : https://github.com/apple/swift-argument-parser/pull/572 
968995[ #573 ] : https://github.com/apple/swift-argument-parser/pull/573 
969996[ #574 ] : https://github.com/apple/swift-argument-parser/pull/574 
@@ -986,6 +1013,9 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
9861013[ #617 ] : https://github.com/apple/swift-argument-parser/pull/617 
9871014[ #619 ] : https://github.com/apple/swift-argument-parser/pull/619 
9881015[ #621 ] : https://github.com/apple/swift-argument-parser/pull/621 
1016+ [ #627 ] : https://github.com/apple/swift-argument-parser/pull/627 
1017+ [ #634 ] : https://github.com/apple/swift-argument-parser/pull/634 
1018+ [ #636 ] : https://github.com/apple/swift-argument-parser/pull/636 
9891019
9901020<!--  Link references for contributors --> 
9911021
@@ -997,6 +1027,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
9971027[ allevato ] : https://github.com/apple/swift-argument-parser/commits?author=allevato 
9981028[ artemnovichkov ] : https://github.com/apple/swift-argument-parser/commits?author=artemnovichkov 
9991029[ atierian ] : https://github.com/apple/swift-argument-parser/commits?author=atierian 
1030+ [ Austinpayne ] : https://github.com/apple/swift-argument-parser/commits?author=Austinpayne 
10001031[ BradLarson ] : https://github.com/apple/swift-argument-parser/commits?author=BradLarson 
10011032[ buttaface ] : https://github.com/apple/swift-argument-parser/commits?author=buttaface 
10021033[ Chamepp ] : https://github.com/apple/swift-argument-parser/commits?author=Chamepp 
@@ -1008,6 +1039,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
10081039[ CypherPoet ] : https://github.com/apple/swift-argument-parser/commits?author=CypherPoet 
10091040[ d-ronnqvist ] : https://github.com/apple/swift-argument-parser/commits?author=d-ronnqvist 
10101041[ damuellen ] : https://github.com/apple/swift-argument-parser/commits?author=damuellen 
1042+ [ dcantah ] : https://github.com/apple/swift-argument-parser/commits?author=dcantah 
10111043[ dduan ] : https://github.com/apple/swift-argument-parser/commits?author=dduan 
10121044[ dirtyhabits97 ] : https://github.com/apple/swift-argument-parser/commits?author=dirtyhabits97 
10131045[ drewmccormack ] : https://github.com/apple/swift-argument-parser/commits?author=drewmccormack 
@@ -1055,6 +1087,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
10551087[ pegasuze ] : https://github.com/apple/swift-argument-parser/commits?author=pegasuze 
10561088[ randomeizer ] : https://github.com/apple/swift-argument-parser/commits?author=randomeizer 
10571089[ rauhul ] : https://github.com/apple/swift-argument-parser/commits?author=rauhul 
1090+ [ revolter ] : https://github.com/apple/swift-argument-parser/commits?author=revolter 
10581091[ rickrizzo ] : https://github.com/apple/swift-argument-parser/commits?author=rickrizzo 
10591092[ rjstelling ] : https://github.com/apple/swift-argument-parser/commits?author=rjstelling 
10601093[ robertmryan ] : https://github.com/apple/swift-argument-parser/commits?author=robertmryan 
0 commit comments