[cap-talk] Objects and Facets

[Charles Landau]

At 3:22 PM -0700 8/7/06, Norman Hardy wrote:
>When I implement an up-down counter I want to document it as follows:
>
>An up-down counter is an object whose mutable state is a 64 bit integer.
>Calling the UDCC creates a counter and returns three facets thereto: 
>Up, Down and Read.
>Invoking Up increments the integer, Invoking Down decrements the 
>integer. Read returns the integer.
>The counter's initial integer is 0.
>
>I would like to know how to document the up down counter in the other
>proposed was of speaking.

"An up-down counter is a composite ..." Everything else in your 
description works fine.

I would be happy if someone can suggest a more intuitive word to 
replace "composite". "Composite" implies that you are starting with 
the facets and grouping them together. That is not how most people 
would think of this situation. Most people think of the counter and 
divide it into facets.