bug#6113: 23.1.97; doc of :box face attibute

["Drew Adams" <drew.adams@oracle.com>]

> > The description of attribute :box does not say what the 
> > possible values
> > of :line-width are or what they mean.
> >
> > Take a look at face `mode-line-inactive', for instance.  It has a
> > `line-width' of -1.  There is no way to understand this unless it is
> > documented properly.  Even for positive values, we say nothing about
> > what the width units are (e.g. pixels).
> 
> I don't think the units need clarification, really -- I think all the
> width/height things when talking about faces would naturally 
> be assumed to be pixels.

The question is not what you would assume the units to be.  Please just state
what the units are.  A user will not necessarily assume anything about the
units.  They could be points or anything else.  It doesn't take much to tell
users what they are.  You need only add two words: "in pixels".

Search for "pixel" in the manual and you will see that this is standard
procedure.  It is normal for doc to tell users what the units of measurements or
quantities are.