From e8d33c033cafb36119379cdb85107b8987dc7e5c Mon Sep 17 00:00:00 2001 From: "Robert P. Goldman" <rpgoldman@sift.net> Date: Mon, 23 Mar 2015 09:51:37 -0500 Subject: [PATCH] COMPONENT-PATHNAME doc added. Fixed INPUT-FILES doc. --- doc/asdf.texinfo | 37 ++++++++++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo index 2360acb5..5af04230 100644 --- a/doc/asdf.texinfo +++ b/doc/asdf.texinfo @@ -2319,9 +2319,17 @@ An operation @emph{may} provide methods for the following generic functions: @findex input-files A method for this function is often not needed, since ASDF has a pretty clever default @code{input-files} mechanism. -You only need create a method if there are multiple ultimate input files, -and/or the bottom one doesn't depend -on the @code{component-pathname} of the component. +You only need create a method if there are multiple ultimate input +files. +Most operations inherit from @code{selfward-operation}, which +appropriately sets the input-files to include the source file itself. + +@c FIXME: Add documentation of built-in operation types. + +@defun input-files operation component +Return a list of pathnames that represent the input to @var{operation} +performed on @var{component}. +@end defun @item @code{operation-done-p} @findex operation-done-p @@ -2755,6 +2763,29 @@ does additional processing to set the filesystem location of the top component in that system. This is detailed elsewhere. @xref{Defining systems with defsystem}. +To find the CL pathname corresponding to a component, use + +@defun component-pathname component +Returns the pathname corresponding to @var{component}. For components +such as source files, this will be a filename pathname. For example: + +@lisp +CL-USER> (asdf:component-pathname (asdf:find-system "xmls")) +#P"/Users/rpg/lisp/xmls/" +@end lisp + +and + +@lisp +CL-USER> (asdf:component-pathname + (asdf:find-component + (asdf:find-system "xmls") "xmls")) +#P"/Users/rpg/lisp/xmls/xmls.lisp" +@end lisp +@end defun + + + @subsubsection properties -- GitLab