I know that whether to continue to include these inline was controversial -- but I tend to fall on the side of not duplicating this information everywhere.  If we do that, though, we need a clear link to the `LineProperties` class, and my suggested change for the `Returns` section above does that.