summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoreudoxia <uplink@distress.network>2022-05-02 12:44:32 -0400
committereudoxia <uplink@distress.network>2022-05-02 12:44:32 -0400
commite55119ff9fbe717c8b35672e9450cf2e42727174 (patch)
tree66ff19b353cb0be1a1784c214a317572e398d2ca
parentdbe6cb4ca49d2e90279bdad090327230dee3aafc (diff)
literary: docs syncing
-rwxr-xr-xsitemap.xml2
-rwxr-xr-xsoftware/literary/data.html1
-rw-r--r--software/literary/index.html7
-rwxr-xr-xsoftware/literary/src.md5
4 files changed, 6 insertions, 9 deletions
diff --git a/sitemap.xml b/sitemap.xml
index 3653710..5fcfbb8 100755
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -16,7 +16,7 @@ xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://distress.network/software/</loc><lastmod>2022-04-25T02:08:26-04:00</lastmod></url>
-<url><loc>https://distress.network/software/literary/</loc><lastmod>2022-04-25T01:40:46-04:00</lastmod></url>
+<url><loc>https://distress.network/software/literary/</loc><lastmod>2022-05-02T12:34:01-04:00</lastmod></url>
<url><loc>https://distress.network/software/web/</loc><lastmod>2022-03-31T23:30:21-04:00</lastmod></url>
diff --git a/software/literary/data.html b/software/literary/data.html
index 3453250..9fddef4 100755
--- a/software/literary/data.html
+++ b/software/literary/data.html
@@ -243,7 +243,6 @@ while (iterator.next()) |line| {
log(.err, "section '{s}' not found", .{name});
return error.NotFound;
}
-// TODO return last match instead?
</code></pre>
<h2 id="parsing">Parsing</h2>
diff --git a/software/literary/index.html b/software/literary/index.html
index 3b15363..eb0dec3 100644
--- a/software/literary/index.html
+++ b/software/literary/index.html
@@ -10,7 +10,7 @@
<link rel="icon" type="image/png" sizes="16x16" href="/favicon/favicon-16x16.png">
<link rel="manifest" href="/favicon/site.webmanifest">
<title>Literary &mdash; DistressNetwork°</title>
-<meta http-equiv="last-modified" content="2022-04-25 01:40:46-04:00" />
+<meta http-equiv="last-modified" content="2022-05-02 12:34:01-04:00" />
</head>
<body>
<div class="contentlevel">
@@ -40,7 +40,7 @@
<h2 id="usage">Usage</h2>
-<p>These programs are intended to be intermediary text processing functions, used as components within build automation routines or shell scripts. The build processes for this tool itself, <code>build.sh</code> and <code>gen_freestanding.sh</code>, serve as example use cases.</p>
+<p>These programs are intended to be intermediary text processing functions, used as components within build automation routines or shell scripts. The build processes for this tool itself, <code>build.sh</code> and <code>gen-docs.sh</code>, serve as example use cases.</p>
<h1 id="dependencies">Dependencies</h1>
@@ -126,7 +126,7 @@
<h1 id="literate-source-code">Literate Source Code</h1>
-<p>The source code of this tool is rendered as a set of literate program documents, listed below. Additionally, freestanding versions of these documents exist in the <code>doc/freestanding</code> source directory for offline use.</p>
+<p>The source code of this tool is rendered as a set of literate program documents, listed below.</p>
<ul>
<li><a href="/software/literary/data.html">data.lp</a></li>
@@ -147,7 +147,6 @@
<ul>
<li>The treatment of whitespace within formatting and configuration commands is currently rather strict, as no trimming of leading or trailing whitespace around the command contents is applied. This may be changed for the sake of convenience, at the expense of added parsing complexity.</li>
-<li>In a document with duplicate section names, references to such sections are resolved to the section with that name which appears first within the document. It may be more useful to have these resolve to the matching section which appears last in the document instead, which would permit some amount of name reuse.</li>
</ul>
</main>
<nav>
diff --git a/software/literary/src.md b/software/literary/src.md
index 3a5bd0d..a008409 100755
--- a/software/literary/src.md
+++ b/software/literary/src.md
@@ -8,7 +8,7 @@ This tool consists of two programs, `tangle` and `weave`, both of which accept a
## Usage
-These programs are intended to be intermediary text processing functions, used as components within build automation routines or shell scripts. The build processes for this tool itself, `build.sh` and `gen_freestanding.sh`, serve as example use cases.
+These programs are intended to be intermediary text processing functions, used as components within build automation routines or shell scripts. The build processes for this tool itself, `build.sh` and `gen-docs.sh`, serve as example use cases.
# Dependencies
@@ -78,7 +78,7 @@ The format strings may contain the following control sequences:
# Literate Source Code
-The source code of this tool is rendered as a set of literate program documents, listed below. Additionally, freestanding versions of these documents exist in the `doc/freestanding` source directory for offline use.
+The source code of this tool is rendered as a set of literate program documents, listed below.
- [data.lp](/software/literary/data.html)
- [log.lp](/software/literary/log.html)
@@ -94,4 +94,3 @@ The source code of this tool is rendered as a set of literate program documents,
# Future Work
- The treatment of whitespace within formatting and configuration commands is currently rather strict, as no trimming of leading or trailing whitespace around the command contents is applied. This may be changed for the sake of convenience, at the expense of added parsing complexity.
-- In a document with duplicate section names, references to such sections are resolved to the section with that name which appears first within the document. It may be more useful to have these resolve to the matching section which appears last in the document instead, which would permit some amount of name reuse.