Function

Summary

Gets or sets a registry path for use with your software.

Package

system

Signature

product-registry-path product => path-string

Signature

(setf product-registry-path) path product => path

Arguments

product

A Lisp object.

Values

path

The path as a string or a list of strings.

path-string

The path as a string.

Description

The function product-registry-path returns the registry subpath defined for the product denoted by product, as a string.

The function (setf product-registry-path) sets the registry subpath for the product denoted by product.

If path is a string it can contain backslash \ or forward slash / as directory separators - these are translated internally to the separator appropriate for the system. Note that any backslash will need escaping (with another backslash) if you input the string value via the Lisp reader.

If path is a list of strings, then it is interpreted like the directory component of a pathname.

This registry subpath is used when reading and storing user preferences with user-preference.

Note that while product can be any Lisp object, values of product are compared by eq, so you should use keywords.

Notes

To store CAPI window geometries under the registry path for your product, see the entry for capi:top-level-interface-geometry-key. in the CAPI User Guide and Reference Manual .

Example

(setf (sys:product-registry-path :deep-thought)

      (list "Deep Thought" "1.0"))

Then, on non-Windows systems:

(sys:product-registry-path :deep-thought)

=>

"Deep Thought/1.0"

And on Microsoft Windows:

(sys:product-registry-path :deep-thought)

=>

"Deep Thought\\1.0"

See also

copy-preferences-from-older-version
user-preference