Skip to content

Commit 60b11f9

Browse files
committed
Updated documentation
1 parent 1d6995d commit 60b11f9

3 files changed

Lines changed: 79 additions & 95 deletions

File tree

README.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
2+
3+
# NAME
4+
5+
ql-https — HTTPS support for Quicklisp via curl
6+
7+
8+
# VERSION
9+
10+
0.5.0
11+
12+
13+
# SYNOPSIS
14+
15+
(asdf:load-system "ql-https")
16+
17+
18+
# DESCRIPTION
19+
20+
21+
## PREREQUISITES
22+
23+
- [Quicklisp](https://www.quicklisp.org/beta/)
24+
- curl (refer to your system package manager)
25+
26+
27+
## INSTALLATION
28+
29+
1. `mkdir ~/quicklisp` and `cd ~/quicklisp`
30+
2. Go to <https://beta.quicklisp.org/client/quicklisp.sexp> and lookup `:client-tar` URL, download it, verify
31+
hash and untar.
32+
3. Clone ql-https from <https://github.com/rudolfochrist/ql-https.git> to
33+
to `~/common-lisp/ql-https`
34+
4. Disconnect internet. (Prevent that anything leaks over HTTP during the installation)
35+
5. Start a fresh REPL and (require 'asdf)
36+
6. Load `~/common-lisp/ql-https/ql-setup.lisp`
37+
7. Eval `(asdf:load-system "ql-https")`
38+
8. Inspect `ql-http:*fetch-scheme-functions*` and verify everything was registered properly. Both `http` and
39+
`https` have `ql-https:fetcher` registered.
40+
9. Connect internet.
41+
10. Eval `(quicklisp:setup)` - use the USE-HTTPS restart if you hit the network.
42+
43+
Removing the *Missing client-info.sexp, using mock info* warning.
44+
45+
1. Eval `(ql:update-client)`
46+
2. move `~/quicklisp/tmp/client-info.sexp` to `~/quicklisp`
47+
48+
49+
## STARTUP
50+
51+
(let ((quicklisp-init #p"~/common-lisp/ql-https/ql-setup.lisp"))
52+
(when (probe-file quicklisp-init)
53+
(load quicklisp-init)
54+
(asdf:load-system "ql-https")
55+
(uiop:symbol-call :quicklisp :setup)))
56+
57+
;; optional
58+
#+ql-https
59+
(setf ql-https:*quietly-use-https* t)
60+
61+
62+
# AUTHOR
63+
64+
Sebastian Christ (<mailto:rudolfo.christ@pm.me>)
65+
66+
67+
# COPYRIGHT
68+
69+
Copyright (c) 2022 Sebastian Christ (rudolfo.christ@pm.me)
70+
71+
72+
# LICENSE
73+
74+
Released under the MIT license.
75+

README.txt

Lines changed: 0 additions & 92 deletions
This file was deleted.

doc/README.org

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#+STARTUP: showall
2-
#+EXPORT_FILE_NAME: ../README.txt
2+
#+EXPORT_FILE_NAME: ../README.md
33
#+OPTIONS: toc:nil author:nil
44
# This is just the template README. Export to txt to get the real README.
55
* NAME
@@ -27,7 +27,7 @@ cat ../version
2727

2828
** INSTALLATION
2929

30-
1. =mkdir ~/quicklis= and =cd ~/quicklisp=
30+
1. =mkdir ~/quicklisp= and =cd ~/quicklisp=
3131
2. Go to [[https://beta.quicklisp.org/client/quicklisp.sexp]] and lookup =:client-tar= URL, download it, verify
3232
hash and untar.
3333
3. Clone ql-https from https://github.com/rudolfochrist/ql-https.git to
@@ -36,7 +36,8 @@ cat ../version
3636
5. Start a fresh REPL and (require 'asdf)
3737
6. Load =~/common-lisp/ql-https/ql-setup.lisp=
3838
7. Eval ~(asdf:load-system "ql-https")~
39-
8. Inspect ~ql-http:*scheme-functions*~ and verify everything was registered properly.
39+
8. Inspect ~ql-http:*fetch-scheme-functions*~ and verify everything was registered properly. Both =http= and
40+
=https= have =ql-https:fetcher= registered.
4041
9. Connect internet.
4142
10. Eval ~(quicklisp:setup)~ - use the USE-HTTPS restart if you hit the network.
4243

0 commit comments

Comments
 (0)