<p style="white-space: pre-wrap; word-wrap: break-word;">sorry, I hate comments</p><p><a href="https://review.coreboot.org/c/coreboot/+/30234">View Change</a></p><p>3 comments:</p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0;"><p><a href="https://review.coreboot.org/#/c/30234/2/src/soc/intel/broadwell/include/soc/systemagent.h">File src/soc/intel/broadwell/include/soc/systemagent.h:</a></p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0 0 0 16px;"><p style="margin-bottom: 4px;"><a href="https://review.coreboot.org/#/c/30234/2/src/soc/intel/broadwell/include/soc/systemagent.h@140">Patch Set #2, Line 140:</a> <code style="font-family:monospace,monospace">/* API to get TOLUD base address */</code></p><p style="white-space: pre-wrap; word-wrap: break-word;">I'm not a fan of comments that state the obvious.</p></li></ul></li><li style="margin: 0; padding: 0;"><p><a href="https://review.coreboot.org/#/c/30234/2/src/soc/intel/broadwell/systemagent.c">File src/soc/intel/broadwell/systemagent.c:</a></p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0 0 0 16px;"><p style="margin-bottom: 4px;"><a href="https://review.coreboot.org/#/c/30234/2/src/soc/intel/broadwell/systemagent.c@41">Patch Set #2, Line 41:</a> <code style="font-family:monospace,monospace"> /* All regions concerned for have 1 MiB alignment. */</code></p><p style="white-space: pre-wrap; word-wrap: break-word;">this comment only justifies that the code is weird</p></li><li style="margin: 0; padding: 0 0 0 16px;"><p style="margin-bottom: 4px;"><a href="https://review.coreboot.org/#/c/30234/2/src/soc/intel/broadwell/systemagent.c@42">Patch Set #2, Line 42:</a> <code style="font-family:monospace,monospace">       return ALIGN_DOWN(pci_read_config32(SA_DEV_ROOT, TOLUD), 1*MiB);</code></p><p style="white-space: pre-wrap; word-wrap: break-word;">What the ALIGN_DOWN() effectively does is masking out bits 19:0. Which is correct but the reason is wrong. Bit 0 is a lock bit and not part of the address, thus has to be masked out. I would accept either `& ~1` or something like `& 0xfff00000`. But talking about the MiB alignment here only hides the<br>fact that we have to mask bit 0 out.</p><p style="white-space: pre-wrap; word-wrap: break-word;">A comment that we have to mask the lock bit seems useful, though.</p></li></ul></li></ul><p>To view, visit <a href="https://review.coreboot.org/c/coreboot/+/30234">change 30234</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://review.coreboot.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://review.coreboot.org/c/coreboot/+/30234"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: coreboot </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I1a10a4f91b787b72f33150031b783d426148c25d </div>
<div style="display:none"> Gerrit-Change-Number: 30234 </div>
<div style="display:none"> Gerrit-PatchSet: 2 </div>
<div style="display:none"> Gerrit-Owner: Matt DeVillier <matt.devillier@gmail.com> </div>
<div style="display:none"> Gerrit-Reviewer: Matt DeVillier <matt.devillier@gmail.com> </div>
<div style="display:none"> Gerrit-Reviewer: Nico Huber <nico.h@gmx.de> </div>
<div style="display:none"> Gerrit-Reviewer: Patrick Rudolph <siro@das-labor.org> </div>
<div style="display:none"> Gerrit-Reviewer: Subrata Banik <subrata.banik@intel.com> </div>
<div style="display:none"> Gerrit-Reviewer: build bot (Jenkins) <no-reply@coreboot.org> </div>
<div style="display:none"> Gerrit-Comment-Date: Tue, 18 Dec 2018 22:44:48 +0000 </div>
<div style="display:none"> Gerrit-HasComments: Yes </div>
<div style="display:none"> Gerrit-Has-Labels: No </div>
<div style="display:none"> Gerrit-MessageType: comment </div>