Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
A
asdf
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
16
Issues
16
List
Boards
Labels
Service Desk
Milestones
Merge Requests
8
Merge Requests
8
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Operations
Operations
Incidents
Environments
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
asdf
asdf
Commits
786dcea1
Commit
786dcea1
authored
Feb 17, 2019
by
Robert Goldman
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Clarify need for lower case system names.
parent
442e75c9
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
22 additions
and
9 deletions
+22
-9
doc/asdf.texinfo
doc/asdf.texinfo
+22
-9
No files found.
doc/asdf.texinfo
View file @
786dcea1
...
...
@@ -934,15 +934,17 @@ ASDF hooks into the @code{cl:require} facility and you can just use:
(
require
:@
var
{
foo
})
@
end
example
Note
that
the
canonical
name
of
a
system
is
a
string
,
conventionally
lowercase
.
A
system
name
can
also
be
specified
as
a
symbol
(
including
a
keyword
),
in
which
case
its
@
code
{
symbol
-
name
}
is
taken
and
lowercased
.
Note
that
the
canonical
name
of
a
system
is
a
string
,
in
@
emph
{
lowercase
}.
System
names
can
also
be
specified
as
symbols
(
including
keyword
symbols
).
If
a
symbol
is
given
as
argument
,
its
package
is
ignored
,
its
@
code
{
symbol
-
name
}
is
taken
,
and
converted
to
lowercase
.
The
name
must
be
a
suitable
value
for
the
@
code
{:
name
}
initarg
to
@
code
{
make
-
pathname
}
in
whatever
filesystem
the
system
is
to
be
found
.
The
lower
-
casing
-
symbols
behaviour
is
unconventional
,
Using
lowercase
as
canonical
is
unconventional
,
but
was
selected
after
some
consideration
.
The
type
of
systems
we
want
to
support
The
type
of
file
systems
we
support
either
have
lowercase
as
customary
case
(
Unix
,
Mac
,
Windows
)
or
silently
convert
lowercase
to
uppercase
(
lpns
).
@
c
so
this
makes
more
sense
than
attempting
to
use
@
code
{:
case
:
common
},
...
...
@@ -1505,8 +1507,15 @@ feature-expression := keyword
@subsection Component names
Component names (@code{simple-component-name})
may be either strings or symbols.
Component names (@code{simple-component-name}) may be either strings or
symbols. It is safest to use lower case exclusively for component
names, and avoid underscores. Note that system names @emph{must} be
lower case, and symbols will be interpreted as shorthand for the string
that is their @code{symbol-name}, converted to lower case.
Violating these constraints may lead to systems or components being
impossible to find, especially for users who have configured ASDF using
logical pathnames.
@subsection Component types
@anchor{Component types}
...
...
@@ -1642,13 +1651,17 @@ If a symbol is given, it will be translated into a string,
and
downcased
in
the
process
.
The
downcasing
of
symbols
is
unconventional
,
but
was
selected
after
some
consideration
.
Observations
suggest
that
the
type
of
systems
we
want
to
support
either
have
lowercase
as
customary
case
(
Unix
,
Mac
,
w
indows
)
The
file
systems
we
support
either
have
lowercase
as
customary
case
(
Unix
,
Mac
,
W
indows
)
or
silently
convert
lowercase
to
uppercase
(
lpns
),
so
this
makes
more
sense
than
attempting
to
use
@
code
{:
case
:
common
}
as
argument
to
@
code
{
make
-
pathname
},
which
is
reported
not
to
work
on
some
implementations
.
Please
avoid
using
underscores
in
system
names
,
or
component
(
module
or
file
)
names
,
since
underscores
are
not
compatible
with
logical
pathnames
(@
pxref
{
Using
logical
pathnames
}).
Pathname
objects
may
be
given
to
override
the
path
for
a
component
.
Such
objects
are
typically
specified
using
reader
macros
such
as
@
code
{#
p
}
or
@
code
{#.(
make
-
pathname
...)}.
...
...
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