Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
A
asdf
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
GitLab community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Peter Housel
asdf
Commits
b064304a
Commit
b064304a
authored
May 6, 2015
by
Francois-Rene Rideau
Browse files
Options
Downloads
Patches
Plain Diff
More README.md tweaks for both asdf and uiop.
parent
cb7be4c1
Branches
Branches containing commit
Tags
Tags containing commit
No related merge requests found
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
README.md
+37
-36
37 additions, 36 deletions
README.md
uiop/README.md
+2
-2
2 additions, 2 deletions
uiop/README.md
with
39 additions
and
38 deletions
README.md
+
37
−
36
View file @
b064304a
...
...
@@ -8,7 +8,7 @@ ASDF is the de facto standard build facility for Common Lisp.
Your Lisp implementation probably contains a copy of ASDF,
which you can load using
`(require "asdf")`
.
If you come from the C/C++ world,
the
ASDF covers a bit of what each of
If you come from the C/C++ world, ASDF covers a bit of what each of
make, autoconf, dlopen and libc do for C programs:
it orchestrates the compilation and dependency management,
handles some of the portability issues, dynamically finds and loads code,
...
...
@@ -25,15 +25,15 @@ will get you started as a simple user.
If you want to define your own systems, further read the section
Defining systems with defsystem.
The manual is also in the doc/ subdirectory, and can be prepared with:
The manual is also in the
[
doc/
](
doc/
)
subdirectory, and can be prepared with:
make doc
ASDF 3 now includes an extensive runtime support library:
UIOP, the Utilities for Implementation- and OS- Portability.
[
UIOP, the Utilities for Implementation- and OS- Portability
](
uiop/
)
.
Its documentation unhappily lies mainly in the source code and docstrings.
See
[
`
uiop/README.md
`
](
uiop/README.md
)
for an introduction.
See
[
uiop/README.md
](
uiop/README.md
)
for an introduction.
More information and additional links can be found on ASDF's home page at:
<http://common-lisp.net/project/asdf/>
...
...
@@ -62,7 +62,7 @@ or, assuming your implementation provides ASDF 3.1 or later:
~/common-lisp/asdf/
If you cloned our git repository, bootstrap a copy of build/asdf.lisp with:
If you cloned our git repository, bootstrap a copy of
`
build/asdf.lisp
`
with:
make
...
...
@@ -98,7 +98,7 @@ choose your most elaborate installed system $S, and try:
Debugging tip
-------------
To load ASDF in such a way that M-. will work, install the source code, and run:
To load ASDF in such a way that
`
M-.
`
will work, install the source code, and run:
(asdf:load-system :uiop) ;; loading uiop is simple
(map () 'load ;; loading asdf/defsystem is tricky
...
...
@@ -121,72 +121,73 @@ the `git log` for a detailed description of each commit.
How do I navigate this source directory?
----------------------------------------
*
`
asdf.asd
`
*
[
asdf.asd
](
asdf.asd
)
*
The system definition for building ASDF with ASDF.
*
`*.lisp`
*
The source code files for asdf/defsystem.
See asdf.asd for the order in which they are loaded.
*
The source code files for
`
asdf/defsystem
`
.
See
[
asdf.asd
](
asdf.asd
)
for the order in which they are loaded.
*
`
uiop/
`
*
[
uiop/
](
uiop/
)
*
Utilities of Implementation- and OS- Portability,
the portability layer of ASDF. It has its own
`
README
`
,
the portability layer of ASDF. It has its own
[
README
](
uiop/README.md
)
,
and functions all have docstrings.
*
`
Makefile
`
*
a minimal Makefile for bootstrapping purposes.
Most of the logic is in the asdf-tools system
*
[
Makefile
](
Makefile
)
*
a minimal
`
Makefile
`
for bootstrapping purposes.
Most of the logic is in the
[
asdf-tools
](
tools/asdf-tools.asd
)
system
.
*
`
tools/
`
*
[
tools/
](
tools/
)
*
Some scripts to help ASDF users
*
`
load-asdf.lisp
`
-- a build script to load, configure and use ASDF
*
`
install-asdf.lisp
`
-- replace and update an implementation's ASDF
*
`
cl-source-registry-cache.lisp
`
-- update a cache for the source-registry
*
[
load-asdf.lisp
](
tools/load-asdf.lisp
)
-- a build script to load, configure and use ASDF
*
[
install-asdf.lisp
](
install-asdf.lisp
)
-- replace and update an implementation's ASDF
*
[
cl-source-registry-cache.lisp
](
cl-source-registry-cache.lisp
)
-- update a cache for the source-registry
*
`
build.xcvb
`
*
[
build.xcvb
](
build.xcvb
)
*
The system definition for building ASDF with XCVB.
It hasn't been tested or maintained for years and has bitrotten.
*
`
version.lisp-expr
`
*
[
version.lisp-expr
](
version.lisp-expr
)
*
The current version. Bumped up every time the code changes, using:
./tools/asdf-builder bump
*
`
doc/
`
*
[
doc/
](
doc/
)
*
documentation for ASDF, including:
*
`index.html`
-- the web page for
<http://common-lisp.net/project/asdf/>
*
`asdf.texinfo`
-- our manual
*
`Makefile`
-- how to build the manual
*
`cclan.png`
`lisp-logo120x80.png`
`style.css`
`favicon.ico`
-- auxiliaries of
`index.html`
*
`test/`
*
[
index.html
](
doc/index.html
)
-- the web page for
<http://common-lisp.net/project/asdf/>
*
[
asdf.texinfo
](
doc/asdf.texinfo
)
-- our manual
*
[
Makefile
](
doc/Makefile
)
-- how to build the manual
*
[
cclan.png
](
doc/cclan.png
)
[
lisp-logo120x80.png
]
(doc/lisp-logo120x80.png)
[
style.css
](
doc/style.css
)
[
favicon.ico
]
(doc/favicon.ico)
-- auxiliaries of
[
index.html
](
doc/index.html
)
*
[
test/
](
test/
)
*
regression test scripts (and ancillary files) for developers to check
that they don't unintentionally break any of the functionality of ASDF.
Far from covering all of ASDF.
*
`
contrib/
`
*
[
contrib/
](
contrib/
)
*
a few contributed files that show case how to use ASDF.
*
`
debian/
`
*
[
debian/
](
debian/
)
files for packaging on debian, ubuntu, etc.
*
`
build/
`
*
where the Makefile and asdf-tools store their output files, including
*
[
build/
](
build/
)
*
where the
`
Makefile
`
and
`
asdf-tools
`
store their output files, including
*
`asdf.lisp`
-- the current one-file deliverable of ASDF
*
`asdf-XXX.lisp`
-- for upgrade test purposes, old versions
*
`results/`
-- logs of tests that have been run
*
`fasls/`
-- output files while running tests.
*
`
ext/
`
*
[
ext/
](
ext/
)
*
external dependencies, that can be populated with
`make ext`
or equivalently with
`git submodule update --init`
.
*
`
README
`
*
[
README
.md
](
README.md
)
*
this file
*
`
TODO
`
*
[
TODO
](
TODO
)
*
plenty of ideas for how to further improve ASDF.
Last updated
Sun
day, Ma
rch 22nd
, 2015.
Last updated
Wednes
day, Ma
y 6th
, 2015.
This diff is collapsed.
Click to expand it.
uiop/README.md
+
2
−
2
View file @
b064304a
...
...
@@ -93,13 +93,13 @@ At this time, the interface is not great: it isn't obvious at all that you can i
use a scrollbar on the right of the top left side panel to navigate the many packages;
once you click on the package you're interested in, you can see its defined symbols:
*
[
http://bimib.disco.unimib.it/people/Marco.Antoniotti/Projects/CL/HELAMBDAP/tests/asdf-uiop/docs/html/dictionary/dictionary.html
](
http://bimib.disco.unimib.it/people/Marco.Antoniotti/Projects/CL/HELAMBDAP/tests/asdf-uiop/docs/html/dictionary/dictionary.html
)
*
<
http://bimib.disco.unimib.it/people/Marco.Antoniotti/Projects/CL/HELAMBDAP/tests/asdf-uiop/docs/html/dictionary/dictionary.html
>
Another automated documentation tool is quickdocs, but unhappily, at the time of this writing,
it only extracts information from the first package
(see
[
bug #24
](
https://github.com/fukamachi/quickdocs/issues/24
)
):
*
[
http://quickdocs.org/uiop/api
](
http://quickdocs.org/uiop/api
)
*
<
http://quickdocs.org/uiop/api
>
Help wanted extracting working documentation from UIOP's docstrings.
...
...
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
sign in
to comment