Skip to content
Snippets Groups Projects
Commit b918e3af authored by Francois-Rene Rideau's avatar Francois-Rene Rideau
Browse files

Clarify documentation a bit. This should be moved from FAQ to specification. Sigh.

parent 1a0e6645
No related branches found
No related tags found
No related merge requests found
...@@ -1436,21 +1436,26 @@ in the spatial-trees ASDF system definition: ...@@ -1436,21 +1436,26 @@ in the spatial-trees ASDF system definition:
(:static-file "TODO"))) (:static-file "TODO")))
@end example @end example
All of the files in the @code{tree-impls} module are at the top level,
instead of in a @code{tree-impls/} subdirectory.
Note that the argument to @code{:pathname} can be either a pathname object or a string. Note that the argument to @code{:pathname} can be either a pathname object or a string.
A pathname object can be constructed with the @code{#p"foo/bar/"} syntax, A pathname object can be constructed with the @code{#p"foo/bar/"} syntax,
but this is discouraged because the results are not portable. but this is discouraged because the results of parsing a namestring are not portable.
It can only be portably constructed with such syntax as A pathname can only be portably constructed with such syntax as
@code{#.(make-pathname :directory '(:relative "foo" "bar"))}, @code{#.(make-pathname :directory '(:relative "foo" "bar"))},
and similarly the current directory can only be portably specified as and similarly the current directory can only be portably specified as
@code{#.(make-pathname :directory '(:relative "foo" "bar"))}. @code{#.(make-pathname :directory '(:relative))}.
As of ASDF 1.623, however, you can portably use a string, However, as of ASDF 1.624, you can portably use a string to denote a pathname.
which will be parsed as a @code{/}-separated path from the current directory, The string will be parsed as a @code{/}-separated path from the current directory,
such that the empty string @code{""} denotes the current directory, and such that the empty string @code{""} denotes the current directory, and
@code{"foo/bar"} (no trailing @code{/} required in the case of modules) @code{"foo/bar"} (no trailing @code{/} required in the case of modules)
portably denotes the same subdirectory as above. portably denotes the same subdirectory as above.
When files are specified, the last @code{/}-separated component is interpreted
All of the files in the @code{tree-impls} module are at the top level, either as the name component of a pathname
instead of in a @code{tree-impls/} subdirectory. (if the component class specifies a pathname type),
or as a name component plus optional dot-separated type component
(if the component class doesn't specifies a pathname type).
@end itemize @end itemize
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment