DRILL-6843: Update SchemaBuilder comment to match implementation
The schema builder API evolved a while back. The class provides a detailed comment to explain usage. That comment was out of date. This fix updates the comment to match the code.
closes #1533