<div dir="ltr"><div dir="ltr">On Sat, Apr 3, 2021 at 5:22 PM <a href="mailto:Wowfunhappy@gmail.com">Wowfunhappy@gmail.com</a> <<a href="mailto:wowfunhappy@gmail.com">wowfunhappy@gmail.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div style="overflow-wrap: break-word;"><div>I know it's just one data point, but I thought the replies I got on this Hacker News comment today were interesting. I can understand why he/she got confused, and I wonder if there's anything MacPorts could do to make it clearer. <a href="https://news.ycombinator.com/item?id=26678498" target="_blank">https://news.ycombinator.com/item?id=26678498</a></div></div></blockquote><div><br></div><div>As worded, the FAQ text "the ports you install will be compiled only for the architecture you're currently running on" implies (in the linguistic rather than logical sense) that the compilation happens after you request installation. The minimal patch would be to change the tense to "will <b>have been</b> compiled only for", but an even better rewording might be something like</div><div><br></div></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div class="gmail_quote"><div>"…the ports' installed binaries will have been compiled for your computer's architecture…"</div></div></blockquote><div class="gmail_quote"><div><br></div><div>to avoid putting the user's computer in any active role in that sentence and to make it clear we're talking about the binaries and not the compilation process per se. Perhaps "will contain machine code for" would be even more rigorous, but it might be less familiar.</div><div><br></div><div>Of course, this sentence may not be the whole problem, but it's what I saw in that thread, it's likely <i>part</i> of the problem, and it made a good example of the kind of sentence that can be read differently by a reader not already familiar with the subjet.</div></div></div>