<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Feb 11, 2016, at 11:35, Douglas Gregor via swift-evolution <<a href="mailto:swift-evolution@swift.org" class="">swift-evolution@swift.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class=""><br class=""><blockquote type="cite" class="">On Feb 11, 2016, at 10:53 AM, Dave Abrahams via swift-evolution <<a href="mailto:swift-evolution@swift.org" class="">swift-evolution@swift.org</a>> wrote:<br class=""><br class=""><br class="">on Thu Feb 11 2016, Charles Kissinger <<a href="mailto:swift-evolution@swift.org" class="">swift-evolution@swift.org</a>> wrote:<br class=""><br class="">That's nice! What do you think about moving “of” back out of the<br class="">parens? Does that help or hurt?<br class=""></blockquote><br class=""><br class="">And lo!, a diff appeared!<br class=""><br class=""><span class="Apple-tab-span" style="white-space:pre"> </span><a href="https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f" class="">https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f</a><br class=""><br class=""><span class="Apple-tab-span" style="white-space:pre"> </span>- Doug<br class=""></div></div></blockquote></div><div><br class=""></div><div>I think they almost all read better with “of” inside the parens, except for ones that end up with a standalone “of", like this:</div><div><br class=""></div><div><span class="pl-k" style="box-sizing: border-box; color: rgb(167, 29, 93); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">func</span><span style="color: rgb(51, 51, 51); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre; background-color: rgb(255, 236, 236);" class=""> </span><span class="pl-en x x-first" style="box-sizing: border-box; color: rgb(121, 93, 163); border-top-left-radius: 0.2em; border-bottom-left-radius: 0.2em; background-color: rgb(248, 203, 203); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">column</span><span class="x x-last" style="box-sizing: border-box; border-top-right-radius: 0.2em; border-bottom-right-radius: 0.2em; background-color: rgb(248, 203, 203); color: rgb(51, 51, 51); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">(of </span><span class="pl-smi" style="box-sizing: border-box; color: rgb(51, 51, 51); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">matrix</span><span style="color: rgb(51, 51, 51); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre; background-color: rgb(255, 236, 236);" class="">: NSMatrix) </span><span class="pl-k" style="box-sizing: border-box; color: rgb(167, 29, 93); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">-></span><span style="color: rgb(51, 51, 51); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre; background-color: rgb(255, 236, 236);" class=""> </span><span class="pl-c1" style="box-sizing: border-box; color: rgb(0, 134, 179); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;">Int</span></div><div><span class="pl-c1" style="box-sizing: border-box; color: rgb(0, 134, 179); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;"><span class="pl-k" style="box-sizing: border-box; color: rgb(167, 29, 93);">func</span><span style="color: rgb(51, 51, 51); background-color: rgb(234, 255, 234);" class=""> </span><span class="pl-en x x-first" style="box-sizing: border-box; color: rgb(121, 93, 163); border-top-left-radius: 0.2em; border-bottom-left-radius: 0.2em; background-color: rgb(166, 243, 166);">columnOf</span><span class="x x-last" style="box-sizing: border-box; border-top-right-radius: 0.2em; border-bottom-right-radius: 0.2em; background-color: rgb(166, 243, 166); color: rgb(51, 51, 51);">(</span><span style="color: rgb(51, 51, 51); background-color: rgb(234, 255, 234);" class="">matrix: NSMatrix) </span><span class="pl-k" style="box-sizing: border-box; color: rgb(167, 29, 93);">-></span><span style="color: rgb(51, 51, 51); background-color: rgb(234, 255, 234);" class=""> </span><span class="pl-c1" style="box-sizing: border-box;">Int</span></span></div><div><span class="pl-c1" style="box-sizing: border-box; color: rgb(0, 134, 179); font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; white-space: pre;"><span class="pl-c1" style="box-sizing: border-box;"><br class=""></span></span></div><div><span style="white-space: pre;" class="">To my eyes the red line reads worse in this case.</span></div><div><br class=""></div><div>Matt</div><br class=""></body></html>