(optional) specify where to draw the legend; this
parameter may be a string (or equivalent but obsolete an
integer). It can also be a vector [x,y]
which gives the coordinates (in user units) of the upper
left corner of the legend box.

In the first case the possible valuesare:

1 or "in_upper_right": the legend is drawn in the upper right-hand corner
(default). This is the default value.

2 or "in_upper_left":the legend is drawn in the upper left-hand
corner.

3 or "in_lower_left": the legend is drawn in the lower left-hand
corner.

4 or "in_lower_right": the legend is drawn in the lower right-hand
corner.

5 or "by_coordinates": interactive placement with the mouse .

-1 or "out_upper_right": the legend is drawn at the right of the upper right-hand
corner.

-2 or "out_upper_left": the legend is drawn at the left of the upper left-hand
corner.

-3 or "out_lower_left": the legend is drawn at the left of the lower left-hand
corner.

-4 or "out_lower_right": the legend is drawn at the right of the lower right-hand
corner.

-5 or "upper_caption": the legend is drawn above the upper left-hand
corner.

-6 or "lower_caption": the legend is drawn below the lower left-hand
corner.

boxed

a boolean (default value %t) which sets ot not the drawing of
the box.

hl

a handle, points to the Compound containing all the legend
.

Description

Puts a legend on the current plot using the specified strings as
labels. legend prepends labels by a recall of the corresponding line or
patch. The recall type and properties are recovered from the given
handles:

when called without handle argument (or with a handle on an axes
entity) the function first build the vectors of handle on polylines
entities which are the children of the given axes.

In the interactive placement mode (opt=5) move the legend box with
the mouse and press the left button to release it.