<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div class=""><blockquote type="cite" class=""><div dir="ltr" class="" style="font-family: Calibri; font-size: 16px;"><div class=""><div class="">The language itself uses many abbreviations as its keywords. If you search for 'var' on web, for example, you won't easily find it stands for 'variable'. Does it mean it violates the guidelines?</div></div></div></blockquote></div><div class=""><br class=""></div>Actually, a Google search for just ‘var’ yields results pointing to JavaScript, C#, and HTML on the first page. A search for ‘init’ immediately describes the init process on Unix systems, as well as many other programming related results. Following any of these will let you understand the meaning of ‘init’ or ‘var’ pretty quickly. OTOH, ‘subs’ gives lots of results for sandwiches, but nothing programming related.<div class=""><br class=""></div><div class="">As a concert example of confusion that can arise, String implements subscript(), but ‘subs’ could just as easily stand for ‘substring’ in this context.</div><div class=""><br class=""></div><div class="">FKL</div><div class=""><br class=""><div class=""><div><blockquote type="cite" class=""><div class="">On Dec 10, 2015, at 10:09 PM, Feijian Sun 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 dir="ltr" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">Thanks for your suggestion! <div class=""><br class=""></div><div class="">But you're talking about the guidelines for Swift API Design while I'm proposing a keyword change in the language itself. I think they are not the same subjects.<div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""><div class=""><hr id="stopSpelling" class="">From:<span class="Apple-converted-space"> </span><a href="mailto:sethfri@gmail.com" class="">sethfri@gmail.com</a><br class="">Date: Thu, 10 Dec 2015 18:58:45 -0800<br class="">Subject: Re: [swift-evolution] Proposal for Replacing Keyword "subscript" with "subs"<br class="">To:<span class="Apple-converted-space"> </span><a href="mailto:feijian_sun@hotmail.com" class="">feijian_sun@hotmail.com</a>;<span class="Apple-converted-space"> </span><a href="mailto:jackl@apple.com" class="">jackl@apple.com</a><br class="">CC:<span class="Apple-converted-space"> </span><a href="mailto:swift-evolution@swift.org" class="">swift-evolution@swift.org</a><br class=""><br class=""><div dir="ltr" class="">I encourage you to read the <a href="https://swift.org/documentation/api-design-guidelines.html" target="_blank" class="">Swift API Design Guidelines</a>, as there are a couple of things there that discourage what you are suggesting:<div class=""><ul class=""><li class="">"<strong class="">Clarity is more important than brevity</strong>. Although Swift code can be compact, it is a <em class="">non-goal</em> to enable the smallest possible code with the fewest characters. Brevity in Swift code, where it occurs, is a side-effect of the strong type system and features that naturally reduce boilerplate."</li><li style="padding: 0px;" class=""><div style="margin: 0px; padding: 0px;" class=""><strong class="">Avoid abbreviations</strong>. Abbreviations, especially non-standard ones, are effectively terms-of-art, because understanding depends on correctly translating them into their non-abbreviated forms.</div><blockquote style="padding: 0px 0px 0px 2em; border-left-width: 3px; border-left-color: rgb(243, 243, 243); border-left-style: solid; color: rgb(51, 51, 51);" class=""><div style="margin: 0px; padding: 0px;" class="">The intended meaning for any abbreviation you use should be easily found by a web search.</div></blockquote></li></ul><div class="">Thanks,</div><div class="">Seth</div><div class=""><br class=""><div class="ecxgmail_quote"><div dir="ltr" class="">On Thu, Dec 10, 2015 at 6:52 PM Feijian Sun via swift-evolution <<a href="mailto:swift-evolution@swift.org" target="_blank" class="">swift-evolution@swift.org</a>> wrote:<br class=""></div><blockquote class="ecxgmail_quote" style="border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex;"><div class=""><div dir="ltr" class="">Thank you for responding so late!<div class=""><br class=""></div><div class="">I agree with you that "subs" is not very obvious for subscript. While learning swift, I have a feeling that it contains so many long words as the keywords, such as</div><div class=""><br class=""></div><div class="">fallthrough, dynamicType, associativity, convenience, nonmutating, precedence, etc..</div><div class=""><br class=""></div><div class="">I understand there is a need for clarity. But I think it's also important to keep a concise and simple naming style where it's possible.</div><div class=""><br class=""></div><div class="">Thanks again.</div><div class=""><br class=""><div class=""><hr class="">Subject: Re: [swift-evolution] Proposal for Replacing Keyword "subscript" with "subs"<br class="">From:<span class="Apple-converted-space"> </span><a href="mailto:jackl@apple.com" target="_blank" class="">jackl@apple.com</a><br class="">Date: Thu, 10 Dec 2015 18:22:55 -0800<br class="">CC:<span class="Apple-converted-space"> </span><a href="mailto:swift-evolution@swift.org" target="_blank" class="">swift-evolution@swift.org</a><br class="">To:<span class="Apple-converted-space"> </span><a href="mailto:feijian_sun@hotmail.com" target="_blank" class="">feijian_sun@hotmail.com</a></div></div></div></div><div class=""><div dir="ltr" class=""><div class=""><div class=""><br class=""><br class="">It’s non-obvious to me that “subs” is short for subscript, whereas “init” and “func” have only one obvious expansion.<div class=""><br class=""></div><div class="">Jack <br class=""><div class=""><blockquote class=""><div class="">On Dec 10, 2015, at 6:12 PM, Feijian Sun via swift-evolution <<a href="mailto:swift-evolution@swift.org" target="_blank" class="">swift-evolution@swift.org</a>> wrote:</div><br class=""><div class=""><div dir="ltr" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class=""><div dir="ltr" class=""><span style="color: rgb(68, 68, 68); font-size: 15px; line-height: 21.3px; background-color: rgb(255, 255, 255);" class="">Hello, </span><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">I have a proposal to replace the long keyword "subscript" with the shorter version, "subs". The idea is to keep the concise naming style on the language keywords, like "init" and "func".</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">So, Instead of:</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">subscript(index: Int) -> Int {</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""> ... ...</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">}</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">we could simply do:</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">subs(index: Int) -> Int{</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><div style="line-height: 21.3px;" class=""> ... ...</div><div style="line-height: 21.3px;" class="">}</div></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">Does this mean a big change on the parser side? what do you think?</div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class=""><br style="line-height: 21.3px;" class=""></div><div style="line-height: 21.3px; color: rgb(68, 68, 68); font-size: 15px; background-color: rgb(255, 255, 255);" class="">Thank you!</div><div dir="ltr" class=""></div></div></div><img src="https://u2002410.ct.sendgrid.net/wf/open?upn=fPHCHxM8OEqkFI0LoY8YMuXDKRTx6ILsXcJMmyHEOCKoTIfmBG-2BB29EKJ66isdwzGloc7ZFX7-2BF4OLFKGhYR452GcWvMK0zfSjEY7yDYXwTU-2BqOF3eg0yWlwBqzUBGHwi6g1BOj7opXk2sLJPbrnwlBuFcyEcyjSnpyPqmtTNTT3mulfq22DLIXezmou8RS-2Fu8xZDmt9bQjdElFmd01-2F3yStFIKMb-2FJgynEvhIuAqv0-3D" alt="" width="1" height="1" border="0" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; min-height: 1px !important; width: 1px !important; border-width: 0px !important; padding: 0px !important;" class=""><span style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; display: inline !important;" class=""><span class=""> </span>_______________________________________________</span><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class=""><span style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; display: inline !important;" class="">swift-evolution mailing list</span><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class=""><a href="mailto:swift-evolution@swift.org" target="_blank" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class="">swift-evolution@swift.org</a><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class=""><a href="https://lists.swift.org/mailman/listinfo/swift-evolution" target="_blank" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px;" class="">https://lists.swift.org/mailman/listinfo/swift-evolution</a></div></blockquote></div><br class=""></div></div></div></div></div><div class=""><div dir="ltr" class=""><div class=""><div class=""></div></div></div><img src="https://u2002410.ct.sendgrid.net/wf/open?upn=Ply6uBspjl13OmIYIyGVsx1PNWVM6Ks10N2aYOZ94k6oQjgn9dAxzli7ONoBmWCrg7DazqackxXQcsxkc4ILlM8bVOEsSqhNIyYA2VDDJnRJXVFTM9aiwsaHSvaO-2Fmi3RnB0pJv9TXuz0nnNV7W6sPnLwekrEBOymZ-2F3TWljS5gURIlcQUOxFaHbvtZa3RczzTGonhyxxtG9ewSjUQjl7pA-2FgsCBvQTreIjOk6sEeGI-3D" alt="" width="1" height="1" border="0" style="min-height: 1px !important; width: 1px !important; border-width: 0px !important; padding: 0px !important;" class=""></div>_______________________________________________<br class="">swift-evolution mailing list<br class=""><a href="mailto:swift-evolution@swift.org" target="_blank" class="">swift-evolution@swift.org</a><br class=""><a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank" class="">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br class=""></blockquote></div></div></div></div></div></div></div></div><img src="https://u2002410.ct.sendgrid.net/wf/open?upn=xuNk3-2BDhTcLCDO7Sfs7vOKuwzOflxLPAwbEhxryZnGcAZkCD1Nqr7IFdvfQhqZQ1sewoyH7O3zgYhruj5hkCoNCV-2FTY2rDDme58A0MZNEvlXc-2B1uym0Cy7ylViDk-2FcH-2B14dudOaCFWOtX0l-2BKC1C6SPY-2FmSSab-2Fbumi6OjeF31cHlQyHPtGQAq-2BLXyPfRySF0uPtv9mqk8I9vaSbDq0c4A-3D-3D" alt="" width="1" height="1" border="0" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; height: 1px !important; width: 1px !important; border-width: 0px !important; margin: 0px !important; padding: 0px !important;" class=""><span style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class=""><span class="Apple-converted-space"> </span></span><span style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">_______________________________________________</span><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">swift-evolution mailing list</span><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><a href="mailto:swift-evolution@swift.org" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">swift-evolution@swift.org</a><br style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><a href="https://lists.swift.org/mailman/listinfo/swift-evolution" style="font-family: Calibri; font-size: 16px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">https://lists.swift.org/mailman/listinfo/swift-evolution</a></div></blockquote></div><br class=""></div></div></body></html>