Skip to content
GitLab
Explore
Sign in
Register
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
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Didier Verna
asdf
Commits
98567572
Commit
98567572
authored
9 years ago
by
Francois-Rene Rideau
Browse files
Options
Downloads
Patches
Plain Diff
Explain the limitations of the HELAMBDAP documentation.
Make github happier with uiop/README
parent
78651616
No related branches found
No related tags found
No related merge requests found
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
doc/index.html
+4
-1
4 additions, 1 deletion
doc/index.html
uiop/README.md
+14
-14
14 additions, 14 deletions
uiop/README.md
with
18 additions
and
15 deletions
doc/index.html
+
4
−
1
View file @
98567572
...
@@ -86,7 +86,10 @@
...
@@ -86,7 +86,10 @@
See its
See its
<a
href=
"https://gitlab.common-lisp.net/asdf/asdf/tree/master/uiop/README.md"
>
README.md
</a>
for an overview,
<a
href=
"https://gitlab.common-lisp.net/asdf/asdf/tree/master/uiop/README.md"
>
README.md
</a>
for an overview,
and the documentation as extracted from its docstrings by
and the documentation as extracted from its docstrings by
<a
href=
"http://bimib.disco.unimib.it/people/Marco.Antoniotti/Projects/CL/HELAMBDAP/tests/asdf-uiop/docs/html/dictionary/dictionary.html"
>
HEΛP
</a>
.
<a
href=
"http://bimib.disco.unimib.it/people/Marco.Antoniotti/Projects/CL/HELAMBDAP/tests/asdf-uiop/docs/html/dictionary/dictionary.html"
>
HEΛP
</a>
(beware: you can, though it's not obvious, scroll the list of packages
with a scroll the right of the top-left pane, and then click on the one
you're interested in to browse its symbols).
</p>
</p>
<p><tt>
uiop
</tt>
is distributed as part of the
<tt>
ASDF
</tt>
,
<p><tt>
uiop
</tt>
is distributed as part of the
<tt>
ASDF
</tt>
,
its source code is transcluded in the single-file
<tt>
asdf.lisp
</tt>
being distributed
its source code is transcluded in the single-file
<tt>
asdf.lisp
</tt>
being distributed
...
...
This diff is collapsed.
Click to expand it.
uiop/README.md
+
14
−
14
View file @
98567572
...
@@ -7,7 +7,7 @@ between operating systems, and between what the standard provides and
...
@@ -7,7 +7,7 @@ between operating systems, and between what the standard provides and
what programmers actually need, to write portable Common Lisp programs.
what programmers actually need, to write portable Common Lisp programs.
It is organized by topic in many files, each of which defines its own package
It is organized by topic in many files, each of which defines its own package
according to its topic: e.g
[
`pathname.lisp
`
](
pathname.lisp
)
according to its topic: e.g
`
[
pathname.lisp](pathname.lisp)
`
will define package
`UIOP/PATHNAME`
and contain utilities related to
will define package
`UIOP/PATHNAME`
and contain utilities related to
the handling of pathname objects.
the handling of pathname objects.
All exported symbols are reexported in a convenience package
`UIOP`
,
All exported symbols are reexported in a convenience package
`UIOP`
,
...
@@ -16,26 +16,26 @@ We recommend package `UIOP` be used to access all the symbols.
...
@@ -16,26 +16,26 @@ We recommend package `UIOP` be used to access all the symbols.
The files that constitute UIOP are, in dependency loading order:
The files that constitute UIOP are, in dependency loading order:
*
[
`package
`
](
package.lisp
)
: deals with packages and their symbols, most notably including
*
`
[
package](package.lisp)
`
: deals with packages and their symbols, most notably including
`define-package`
, a variant of
`defpackage`
capable of hot-upgrade, or
`define-package`
, a variant of
`defpackage`
capable of hot-upgrade, or
`symbol-call`
and
`find-symbol*`
that are also useful for use in
`.asd`
files
`symbol-call`
and
`find-symbol*`
that are also useful for use in
`.asd`
files
before packages have been defined.
before packages have been defined.
*
[
`common-lisp
`
](
common-lisp.lisp
)
: lets you paper over various sub-standard implementations.
*
`
[
common-lisp](common-lisp.lisp)
`
: lets you paper over various sub-standard implementations.
Big offenders are Corman, GCL, Genera, MCL, all of them unmaintained.
Big offenders are Corman, GCL, Genera, MCL, all of them unmaintained.
Supported without serious issues are:
Supported without serious issues are:
ABCL, Allegro, CCL, CMUCL, CLASP, CLISP, ECL, LispWorks, MKCL, SBCL, SCL, XCL.
ABCL, Allegro, CCL, CMUCL, CLASP, CLISP, ECL, LispWorks, MKCL, SBCL, SCL, XCL.
*
[
`utility
`
](
utility.lisp
)
: provides macros and functions that do not involve I/O; it handles
*
`
[
utility](utility.lisp)
`
: provides macros and functions that do not involve I/O; it handles
control-flow, (p)lists, characters, strings, functions, classes, conditions,
control-flow, (p)lists, characters, strings, functions, classes, conditions,
"stamps" (real number or boolean for +/- infinity), versions, etc.
"stamps" (real number or boolean for +/- infinity), versions, etc.
It also sports
`uiop-debug`
, a useful tool to help you debug programs.
It also sports
`uiop-debug`
, a useful tool to help you debug programs.
*
[
`os
`
](
os.lisp
)
: extracts information from your environment, including
*
`
[
os](os.lisp)
`
: extracts information from your environment, including
an ABI identifier, features that distinguish Unix vs Windows,
an ABI identifier, features that distinguish Unix vs Windows,
`getenv`
,
`hostname`
,
`getcwd`
and
`chdir`
, etc.
`getenv`
,
`hostname`
,
`getcwd`
and
`chdir`
, etc.
*
[
`pathname
`
](
pathname.lisp
)
: overcomes the gruesome non-portability trap that are CL pathnames
*
`
[
pathname](pathname.lisp)
`
: overcomes the gruesome non-portability trap that are CL pathnames
(and their lovecraftian "logical" variant), offering a vast array of
(and their lovecraftian "logical" variant), offering a vast array of
functions and a sensible, usable abstraction to specify relative pathnames.
functions and a sensible, usable abstraction to specify relative pathnames.
It has a function
`merge-pathnames*`
to use instead of
`merge-pathnames`
, or
It has a function
`merge-pathnames*`
to use instead of
`merge-pathnames`
, or
...
@@ -43,38 +43,38 @@ The files that constitute UIOP are, in dependency loading order:
...
@@ -43,38 +43,38 @@ The files that constitute UIOP are, in dependency loading order:
of functions for dealing with pathnames being directory vs file,
of functions for dealing with pathnames being directory vs file,
physical vs logical, absolute vs relative, and more.
physical vs logical, absolute vs relative, and more.
*
[
`filesystem
`
](
filesystem.lisp
)
: provides portable access to the filesystem, inspecting it,
*
`
[
filesystem](filesystem.lisp)
`
: provides portable access to the filesystem, inspecting it,
only using truename when desired, using native OS namestrings,
only using truename when desired, using native OS namestrings,
atomic file renaming, creating or deleting directories, etc.
atomic file renaming, creating or deleting directories, etc.
*
[
`stream
`
](
stream.lisp
)
: portably deals with
`*stderr*`
vs
`*error-output*`
, character encodings
*
`
[
stream](stream.lisp)
`
: portably deals with
`*stderr*`
vs
`*error-output*`
, character encodings
(external formats), element types, safe
`read`
ing and
`write`
ing, opening files
(external formats), element types, safe
`read`
ing and
`write`
ing, opening files
or temporary files, providing
`format`
-like designators for streams,
or temporary files, providing
`format`
-like designators for streams,
flushing output buffers, consuming or copying streams, concatenating streams
flushing output buffers, consuming or copying streams, concatenating streams
or files, copying files, etc.
or files, copying files, etc.
*
[
`image
`
](
image.lisp
)
: portably deals with images, dumping them, restoring from them,
*
`
[
image](image.lisp)
`
: portably deals with images, dumping them, restoring from them,
registering hooks to run at suitable events in the image lifetime,
registering hooks to run at suitable events in the image lifetime,
printing backtraces, handling fatal conditions, using or avoiding debug modes,
printing backtraces, handling fatal conditions, using or avoiding debug modes,
accessing command line arguments or quitting the process.
accessing command line arguments or quitting the process.
*
[
`run-program
`
](
program.lisp
)
: portably spawns external processes and captures their output.
*
`
[
run-program](program.lisp)
`
: portably spawns external processes and captures their output.
Can also capture error-output, inject input, or let it all be interactive.
Can also capture error-output, inject input, or let it all be interactive.
*
[
`lisp-build
`
](
lisp-build.lisp
)
: portably compiles Common Lisp code, handles compilation results,
*
`
[
lisp-build](lisp-build.lisp)
`
: portably compiles Common Lisp code, handles compilation results,
muffles uninteresting conditions, saves and restores deferred warnings,
muffles uninteresting conditions, saves and restores deferred warnings,
runs hooks around compilation (to e.g. control optimizations or syntax),
runs hooks around compilation (to e.g. control optimizations or syntax),
identifies the pathname of the current file, combines FASLs, etc.
identifies the pathname of the current file, combines FASLs, etc.
*
[
`configuration
`
](
configuration.lisp
)
: portably locate and parse configuration files,
*
`
[
configuration](configuration.lisp)
`
: portably locate and parse configuration files,
using best practices to define and validate syntax, search standard paths,
using best practices to define and validate syntax, search standard paths,
let users specify pathnames or pathname patterns, etc.
let users specify pathnames or pathname patterns, etc.
*
[
`backward-driver
`
](
backward-driver.lisp
)
: provides backward-compatibility
*
`
[
backward-driver](backward-driver.lisp)
`
: provides backward-compatibility
with earlier incarnations of this library
with earlier incarnations of this library
(i.e. ASDF internals that have leaked, ASDF-UTILS, or older versions of UIOP).
(i.e. ASDF internals that have leaked, ASDF-UTILS, or older versions of UIOP).
*
[
`driver
`
](
driver.lisp
)
: reexports all the above utilities in a single package
`UIOP`
.
*
`
[
driver](driver.lisp)
`
: reexports all the above utilities in a single package
`UIOP`
.
Documentation
Documentation
...
...
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
register
or
sign in
to comment