Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
A
asdf
Project overview
Project overview
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
1
Issues
1
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Mark Evenson
asdf
Commits
e4586127
Commit
e4586127
authored
Jan 31, 2016
by
Robert Goldman
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add documentation for :BUILD-OPERATION
parent
68ed031d
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
21 additions
and
3 deletions
+21
-3
doc/asdf.texinfo
doc/asdf.texinfo
+21
-3
No files found.
doc/asdf.texinfo
View file @
e4586127
...
...
@@ -1005,12 +1005,17 @@ Starting with ASDF 3.1, this function @code{make} is also available.
The default behaviour is to load the system as if by @code
{
load-system
}
;
but system authors can override this default in their system definition
they may specify an alternate operation as the intended use of their system,
with a @code
{
:build-operation
}
argument in the @code
{
defsystem
}
form,
and an intended output pathname for that operation with @code
{
:build-pathname
}
.
with a @code
{
:build-operation
}
option in the @code
{
defsystem
}
form
(@pxref
{
The defsystem grammar, build-operation
}
),
and an intended output pathname for that operation with
@code
{
:build-pathname
}
.
@c Document :build-operation in the defsystem section.
@c Document in the extension section that for richer programmatic access, you may instead use an overriding
@c @code
{
(defmethod component-depends-on ((o build-op) (s system)) ...)
}
.
@c @code
{
(defmethod component-depends-on ((o build-op) (s system))
@c ...)
}
.
This function is experimental and largely untested. Use at your own risk.
@end defun
@cindex build-operation
@defun require-system system @Arest
{}
keys @Akey
{}
@AallowOtherKeys
{}
@code
{
require-system
}
skips any update to systems that have already been loaded,
...
...
@@ -1391,6 +1396,7 @@ system-definition := ( defsystem system-designator @var{system-option}* )
system-option := :defsystem-depends-on system-list
| :weakly-depends-on @var
{
system-list
}
| :class class-name (see discussion below)
| :build-operation @var
{
operation-name
}
| system-option
| module-option
| option
...
...
@@ -1508,6 +1514,18 @@ must be loaded @emph{before} the system definition is processed.
Typically this is used to load an ASDF extension that is used in the
system definition.
@subsection Build-operation
@cindex :build-operation
The @code
{
:build-operation
}
option to @code
{
defsystem
}
allows the
programmer to specify an operation that will be applied, in place of
@code
{
load-op
}
when @code
{
make
}
(@pxref
{
Convenience Functions, make
}
)
is run on the system. The option
value should be the name of an operation. E.g., @code
{
:build-operation doc-op
}
This feature is
experimental and largely untested. Use at your own risk.
@subsection Weakly depends on
@cindex :weakly-depends-on
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment