<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">It looks like those comments originated as an implementation remark:<div class=""><br class=""></div><div class=""><a href="https://github.com/apple/swift/blame/ef863136f311b113dc9b41da0c65cb771dadf18b/stdlib/public/core/Process.swift#L17" class="">https://github.com/apple/swift/blame/ef863136f311b113dc9b41da0c65cb771dadf18b/stdlib/public/core/Process.swift#L17</a></div><div class=""><br class=""></div><div class=""><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"><br class=""></div><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"></div><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"><div class="blob-num blame-blob-num js-line-number bg-gray-light" id="L16" style="box-sizing: border-box; background-color: rgb(250, 251, 252) !important; width: 50px; min-width: 50px; padding: 3px 10px; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; line-height: 20px; color: rgba(27, 31, 35, 0.298039); text-align: right; white-space: nowrap; vertical-align: top; cursor: pointer; -webkit-user-select: none;">16</div><div class="js-file-line blob-code-inner blob-code" id="LC16" style="box-sizing: border-box; position: relative; padding: 3px 10px; line-height: 20px; vertical-align: top; overflow: visible; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; word-wrap: normal; white-space: pre; -webkit-box-flex: 1; flex-grow: 1;"><span class="pl-c" style="box-sizing: border-box; color: rgb(106, 115, 125);"></span> <span class="pl-k" style="box-sizing: border-box; color: rgb(215, 58, 73);">public</span> <span class="pl-k" style="box-sizing: border-box; color: rgb(215, 58, 73);">static</span> <span class="pl-k" style="box-sizing: border-box; color: rgb(215, 58, 73);">let</span> arguments<span class="pl-k" style="box-sizing: border-box; color: rgb(215, 58, 73);">:</span> [<span class="pl-c1" style="box-sizing: border-box; color: rgb(0, 92, 197);">String</span>] <span class="pl-k" style="box-sizing: border-box; color: rgb(215, 58, 73);">=</span> {</div></div><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"><div class="blob-num blame-blob-num js-line-number bg-gray-light" id="L17" style="box-sizing: border-box; background-color: rgb(250, 251, 252) !important; width: 50px; min-width: 50px; padding: 3px 10px; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; line-height: 20px; color: rgba(27, 31, 35, 0.298039); text-align: right; white-space: nowrap; vertical-align: top; cursor: pointer; -webkit-user-select: none;">17</div><div class="highlighted blob-code blob-code-inner js-file-line" id="LC17" style="box-sizing: border-box; position: relative; padding: 3px 10px; line-height: 20px; vertical-align: top; overflow: visible; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; word-wrap: normal; white-space: pre; background-color: rgb(255, 251, 221); -webkit-box-flex: 1; flex-grow: 1;"> <span class="pl-c" style="box-sizing: border-box; color: rgb(106, 115, 125);"><span class="pl-c" style="box-sizing: border-box;">//</span> Use lazy initialization of static properties to safely initialize the</span></div></div><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"><div class="blob-num blame-blob-num js-line-number bg-gray-light" id="L18" style="box-sizing: border-box; background-color: rgb(250, 251, 252) !important; width: 50px; min-width: 50px; padding: 3px 10px; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; line-height: 20px; color: rgba(27, 31, 35, 0.298039); text-align: right; white-space: nowrap; vertical-align: top; cursor: pointer; -webkit-user-select: none;">18</div><div class="js-file-line blob-code-inner blob-code" id="LC18" style="box-sizing: border-box; position: relative; padding: 3px 10px; line-height: 20px; vertical-align: top; overflow: visible; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; word-wrap: normal; white-space: pre; -webkit-box-flex: 1; flex-grow: 1;"><span class="pl-c" style="box-sizing: border-box; color: rgb(106, 115, 125);"></span> <span class="pl-c" style="box-sizing: border-box; color: rgb(106, 115, 125);"><span class="pl-c" style="box-sizing: border-box;">//</span> public 'arguments' property on first use.</span></div></div><div class="d-flex flex-justify-start flex-items-start" style="box-sizing: border-box; color: rgb(36, 41, 46); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 14px; -webkit-box-pack: start !important; justify-content: flex-start !important; -webkit-box-align: start !important; align-items: flex-start !important; display: flex !important;"><div class="blob-num blame-blob-num js-line-number bg-gray-light" id="L19" style="box-sizing: border-box; background-color: rgb(250, 251, 252) !important; width: 50px; min-width: 50px; padding: 3px 10px; font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace; font-size: 12px; line-height: 20px; color: rgba(27, 31, 35, 0.298039); text-align: right; white-space: nowrap; vertical-align: top; cursor: pointer; -webkit-user-select: none;">19</div><br class=""></div></div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">Would you mind filing a bug on <a href="http://bugs.swift.org" class="">bugs.swift.org</a> for this? All of the properties on CommandLine could use some documentation attention.</div><div class=""><br class=""></div><div class="">-Kyle<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Jan 11, 2018, at 1:55 AM, Martin R via swift-users <<a href="mailto:swift-users@swift.org" class="">swift-users@swift.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="">The `CommandLine` documentation (<a href="https://developer.apple.com/documentation/swift/commandline" class="">https://developer.apple.com/documentation/swift/commandline</a>) states about the `arguments` property:<br class=""><br class=""> ... also use lazy initialization of static properties to safely initialize the swift arguments.<br class=""><br class="">Apparently this originates from the markup comments in <a href="https://github.com/apple/swift/blob/master/stdlib/public/core/CommandLine.swift#L48:" class="">https://github.com/apple/swift/blob/master/stdlib/public/core/CommandLine.swift#L48:</a><br class=""><br class=""> /// Access to the swift arguments, also use lazy initialization of static<br class=""> /// properties to safely initialize the swift arguments.<br class=""> public static var arguments: [String]<br class=""> = (0..<Int(argc)).map { String(cString: _unsafeArgv[$0]!) }<br class=""><br class=""><br class="">- Is this something the _user_ of `CommandLine` must know?<br class="">- If yes, what does it tell me?<br class="">- Or is it a remark about the _implementation_ (and should not be part of the public documentation)?<br class=""><br class="">Regards, Martin<br class=""><br class="">_______________________________________________<br class="">swift-users mailing list<br class=""><a href="mailto:swift-users@swift.org" class="">swift-users@swift.org</a><br class="">https://lists.swift.org/mailman/listinfo/swift-users<br class=""></div></div></blockquote></div><br class=""></div></body></html>