/*
 * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
 * and is available at http://www.eclipse.org/legal/epl-v10.html
 */
package org.opendaylight.yangtools.concepts;

/**
 * Builder object which produces a product.
 *
 * @param <P> Product of builder
 *
 * @author Tony Tkacik &lt;ttkacik@cisco.com&gt;
 */
public interface Builder<P> extends Mutable {
    /**
     * Returns instance of the product.  Multiple calls to this method are not required to return
     * same instance if the state of the builder has changed.
     *
     * @return Newly-built instance
     */
    P build();
}

@@ -580,17 +580,16 @@
 product.
- 
  Multipl
@@ -637,23 +637,16 @@
 o return
-%0A     *
  same in
@@ -654,16 +654,23 @@
 tance if
+%0A     *
  the sta
@@ -726,9 +726,11 @@
 urn 
-N
+A n
 ewly
@@ -745,16 +745,108 @@
 nstance%0A
+     * @throws IllegalStateException if the builder's state is not sufficiently initialized%0A
      */%0A

Document Builder.build() method to throw IllegalStateException