From 930adcd596cf28b41ee26c8ffdc98640dfc9b4bd Mon Sep 17 00:00:00 2001 From: Darren Bane Date: Thu, 10 Dec 2020 00:05:39 +0000 Subject: Making changes --- doc/Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/Makefile') diff --git a/doc/Makefile b/doc/Makefile index 4139f63..6e549c5 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -29,4 +29,4 @@ clean: .PHONY: push push: $(GEMINI) - scp $^ dbane@republic.circumlunar.space:/usr/home/dbane/gemini/lsp_doc + scp -6 $^ dbane@republic.circumlunar.space:/usr/home/dbane/gemini/lsp_doc -- cgit 1.4.1-2-gfad0 From f16f553f2effb7ac8120fb8a15b59bcdd480a97d Mon Sep 17 00:00:00 2001 From: Darren Bane Date: Thu, 10 Dec 2020 00:30:32 +0000 Subject: Nicer gemini output --- doc/Makefile | 5 +++-- doc/breaking_rules.md | 10 +++++----- 2 files changed, 8 insertions(+), 7 deletions(-) (limited to 'doc/Makefile') diff --git a/doc/Makefile b/doc/Makefile index 6e549c5..8716885 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -6,7 +6,8 @@ GEMINI := breaking_rules.gmi bane.20.cdr15.gmi .PHONY: all -all: $(GEMINI) lkbib.txt +all: $(GEMINI) +# lkbib.txt can be made manually as needed # Write gfm. # Beyond that, YAGNI. @@ -18,7 +19,7 @@ lkbib.txt: macros.ms lkbib.ms refs.i groff -Tutf8 -R -ms -k -Kutf8 macros.ms lkbib.ms > $@ %.gmi: %.md - md2gemini -m $^ > $@ + md2gemini -m -l copy $^ > $@ refs.i: refs indxbib $^ diff --git a/doc/breaking_rules.md b/doc/breaking_rules.md index 7cfc99c..0c34594 100644 --- a/doc/breaking_rules.md +++ b/doc/breaking_rules.md @@ -55,8 +55,8 @@ without earning money. ## Design Decisions The programming language chosen is a particular style of Common Lisp. -A clean subset of CL is desired, -so cleave as [close to ISLisp](bane.20.cdr15.md) as practical[5]. +For readability my +[ISLisp-like subset of CL](bane.20.cdr15.md) should be followed where practical[5]. Reasons for this decision include: * Contrary to a lot of other languages, Lisp is fairly paradigm-agnostic. @@ -92,7 +92,7 @@ Even though this is a prototype, attention should be paid to basic craftsmanship * Use `declare` to check the types of parameters in public interfaces (see below). * Indent all the source code using Emacs. -* Some minimal documentation, at least an overview [README](https://tom.preston-werner.com/2010/08/23/readme-driven-development.html) file +* Some minimal documentation, at least an overview like in [README driven development](https://tom.preston-werner.com/2010/08/23/readme-driven-development.html) and man (actually, [mdoc](https://manpages.bsd.lv/toc.html)) pages[7]. * Certain parts of a system justify greater detail for a *complete* specification. These are (newly-designed) network protocols and complex persistent data models. @@ -204,8 +204,8 @@ For productisation you may want to add more features. Although the official ANSI standard is moribund, quasi-standard libaries are recommended on the -[awesome list](https://github.com/CodyReichert/awesome-cl), -or [portability layers](http://portability.cl/). +[Awesome-CL list](https://github.com/CodyReichert/awesome-cl), +or [CL portability layers](http://portability.cl/). Usage should be limited as follows, in order of preference. The language/library split isn't as clear in CL as in some other languages, -- cgit 1.4.1-2-gfad0 d='n10' href='#n10'>10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121