Description Jens Lideström 2019-10-13 11:52:50 EDT

The widget factories should have adequate Javadoc.

A suitable Javadoc scheme might be this:

* Copy the first sentence from the documentation on the widget setter.
* Copy the documentation of the parameters from the widget setter method.
* Add a link to the widget setter method with the @see Javadoc tag.

Like this:

/**
 * Specify the width of the sashes when the controls in the SashForm are
 * laid out.
 *
 * @param width the width of the sashes
 * @see SashForm#setSashWidth
 */