MDC InformationTips

Revision as of 09:01, 24 May 2006 by Paulb (Talk | contribs) (Functions)


This document details the customization of the balloon tips provided by the Eiffel Metadata Consumer.

Requirements

Balloon tips are supported in the 2.0, or greater, release of the .NET framework. This means you will either need to build the Metadata Consumer using the 2.0 (using the configuration target 'consumer_20') or be using the 64bit version of EiffelStudio.

Configuration

Currently configuration is provide via a system environment variable only. This variable is MDC_BALLOON_TIP. The variable can contain any text and can contain message functions, which are in the form ${namespace:function}. There is no escaping provided as the balloon tips are more of a debug/awareness tool.

Functions

There are a number of functions encompassed on three namespaces.

Message functions are case-insensitive, but use the lower-case Eiffel-like convention.

module Namespace

The module namespace pertains to the Metadata consumer tool itself, so provides information on the consumer binary only.

Here are a list of functions:

  • name: Assembly name.
  • version: Assembly version.
  • culture: Assembly locale.
  • key: Assembly public key token.
  • full_name: Assembly fusion name.
  • path: Path where assembly was loaded from.
  • clr: Version of the CLR the assembly was loaded under.

assembly Namespace

The assembly namespace pertains to the assembly being consumed at any point during the consumer instatiated lifespan.

Here are a list of functions:

  • name: Assembly name.
  • version: Assembly version.
  • culture: Assembly locale.
  • key: Assembly public key token.
  • full_name: Assembly fusion name.
  • path: Path where assembly was loaded from.

consume Namespace

The consume namespace pertains to information on the consume process.

Here are a list of functions:

  • reason: A brief description of why the assembly is being consumed.
  • cache_id: An Eiffel Assembly Cache ID (in the form of a GUID) for an assembly being consumed.
  • cache_path: Full path to an Eiffel Assembly Cache the Metadata Consumer was initialized with.

Final Note

Balloon tips are limited to 256 character (255 printable and 1 null character). This is a Micrsoft API limitation in the Win32 API. Given that a file path can be up to 256 character you should pay attention to what message functions you use.