World: r3wp

Sorry, dozens of other subjects have also adopted the face metaphor, 
not just jewels. "Facet" is widely used.

The term is older than its application to jewel cutting.

irrelevant

The "face" of a jewel that the "facet" is a part of is a metaphor 
for its general appearance. "Face" is the root word for "facet".

The only word you have a legit complaint for is "faced", which is 
not a noun in English.

in what way is facet a bettter choice than attribute

Attribute of what? It's a documentation thing. Facet is clearly (and 
always) related to face.

However, I don't remember enough of the GUI model to know what the 
right word would be to use instead of "faced".

Attribute is too generic a term. There are many things in the GUI 
that have attributes.

To me there is an implication that a facet has an immutable nature

face attributes is confusing to you?

faced

, I think is used in relation to "facing", which means what facets 
are facing ... something. No I don't like the word either. :-)

From source:


faced:  ; OBJECT! - prototype of face/facets (face instance facets)
	object [
		area-size: 0x0
	]

attribute is a long word...

long words have less confusion about them

If it's hyphenated as face-attributes it would do, but there would 
be the question of why we aren't just using the term "facet", which 
is a legit English term that means a face attribute.

Short words are preferred in REBOL.

We have to type this stuff.

I find absolutely nothing confusing about facets. They are used in 
one single place in the system and they are used in hundreds of places 
inside styles as paths.

faced

 appears more to be a play on words and it should probably be replaced 
 with something else.

And technically, "attribute" is incorrect. "Attribute" means something 
that comes from the subject (is attributed to it). "Part" is right.

As long as "faced" is replaced with something specifically face-related, 
preferably with the word "face" in it, then cool.

since when has this been a requirement for anything?

faced are instance variables .. just call them locals

The currently used words for styles:

name:    ; WORD!   - style's name (identifies the style)

facets:  ; OBJECT! - the modifyable attributes of the style (properties)

draw:    ; BLOCK!  - draw block with facet words (from face and style)

actors:  ; MAP!    - face actor functions (e.g. on-click, on-resize)
options: ; OBJECT! - prototype of face/options object
parent:  ; WORD!   - parent style (if specified)

state:   ; BLOCK!  - prototype of (extensions to) face/state object
content: ; BLOCK!  - panel layout for composite styles

faced:  ; OBJECT! - prototype of face/facets (face instance facets)
about: "Not documented."

So faced isn't "locals", it's a prototype of the facet object.

Sorry, the object containing the facets.

hehe ... "the modifyable attributes of the style (properties)"

modifiable ...

about: "Not documented"  ... lol

that is soooo funny

About is the documentation of the style. Unless a derived style defines 
some documentation, it's "Not documented".

What (preferrably short) word means a prototype for a collection 
of facets? Perhaps "model"?

Graham, the word list is from the prototype, so "Not documented" 
would be accurate.

These are the words for a face instance:

style:   ; WORD!   - name of the style for this face

facets:  ; OBJECT! - properties unique to this face (from style/faced)
state:   ; OBJECT! - state variables (not properties)
gob:     ; GOB!    - graphical object(s) for this face
options: ; OBJECT! - optional facet changes as specified

; NOTE: optionally extended in face creation with:
;name    ; WORD!   - reference name
;reactors; BLOCK!  - block of user actions

; PANEL faces also add:
;grid    ; OBJECT! - layout parameters and limits
;faces   ; BLOCK!  - faces of the panel:
;triggers; BLOCK!  - triggers used by panels

template

mask

mold

Template is a good one, though it would need to be documented. Mask 
isn't quite right. Mold would be awkward because of MOLD.

about: "documentationi" would be better ...

no more confusing than 'copy or 'to in parse

well, possibly more ...

About "Documentation" would be more misleading when reading out the 
autogenerated help for the style.

You don't assign copy or to in parse to variables - they're keywords.

It's a prototype for a style. There default documentation for a style, 
so "Not documented" makes sense.

Graham, if you called it "mold" then the word 'mold would be bound 
in that object, which would make use of the function MOLD difficult 
in code that is bound to that object.

There default -> There is no default

Oh, I get it, "faced" is short for "prototype of the face visible 
properties (facets) collection". Perhaps "ideal" (in the Platonic 
sense).

The FACED block is similar to FACETS, but makes them local to each 
instance of the face. Now, they can be modified without effecting 
any other faces that are of the same CIRCLE style.

http://www.rebol.net/wiki/GUI_howto_styles

Right, I got the usage. I was just trying to find a good name.