<table><tr><td style="">davidhurka created this revision.<br />davidhurka added a reviewer: Okular.<br />Herald added a project: Okular.<br />Herald added a subscriber: okular-devel.<br />davidhurka requested review of this revision.
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D21266">View Revision</a></tr></table><br /><div><strong>REVISION SUMMARY</strong><div><p>This shall improve the documentation of several area classes,<br />
including NormalizedPoint, NormalizedRect, RegularArea, RegularAreaRect.</p>

<p>This shall also clarify when absolute coordinates and when normalized<br />
coordinates are used.</p>

<p>Also found some potential bugs in functions which are currently unused.</p>

<p>Todo:<br />
There are these ObjectRect classes, and I don’t know what makes them<br />
better than NormalizedRect in their current applications.</p>

<p>Also see my (inline) comments.</p></div></div><br /><div><strong>TEST PLAN</strong><div><p>Run doxygen</p></div></div><br /><div><strong>REPOSITORY</strong><div><div>R223 Okular</div></div></div><br /><div><strong>BRANCH</strong><div><div>improve-area-classes-documentation-phabricator</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D21266">https://phabricator.kde.org/D21266</a></div></div><br /><div><strong>AFFECTED FILES</strong><div><div>core/area.h</div></div></div><br /><div><strong>To: </strong>davidhurka, Okular<br /><strong>Cc: </strong>okular-devel, joaonetto, tfella, ngraham, darcyshen, aacid<br /></div>