product-registry-path Accessor

Summary

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

Package

system

Signatures

product-registry-path product => path-string

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

Arguments

Values

Description

The accessor product-registry-path gets or sets the registry subpath path defined for the product denoted by product.

The reader always returns a string.

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.

Examples

(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