logical-pathname-translations-database-pathnames

$Revision: 5.0.2.4 $

Function

Package: EXCL

Arguments: nil

Returns a list of pathnames or strings naming files to be searched for translations of logical-pathname hosts. Initially, this function returns the list

("sys:hosts.cl")

This function is setf'able so standard operators such as push or pushnew may be used to add additional entries to the list. For example, to add "~/myhosts" to the list, evaluate:

(pushnew "~/myhosts" (excl:logical-pathname-translations-database-pathnames))

logical-pathname-translations-database-pathnames will now return

("~/myhosts" "sys:hosts.cl")

So long as the elements of the list can be coerced to pathnames, the searching done by load-logical-pathname-translations is well protected against errors. In particular, it is not an error if a pathname identifies a file (or a directory) that does not exist. Nor will specifying a file with a logical host for which no translation is known cause a problem. Users might consider adding a file such as "~/myhosts" prior to a call to dumplisp so that they can easily provide translations to the restarted image during startup (before the first prompt). Translations can be added using sys:hosts.cl, but many users cannot modify that file, since it is shared by all Lisp users.

The format of the file is (this is repeated from the definition of cl:load-logical-pathname-translations above):

host {translation}+

where host is a string naming a logical host (i.e., "src") and translation is a list which specifies the translation (i.e., a list of the source and target, such as (list "**;*.*" "sys:**;*.*")). translation is evaluated.

See 6.4 Details of cl:load-logical-pathname-translations in pathnames.htm.

The general documentation description is in introduction.htm. The index is in index.htm.