ci: Ensure manpages are generated with no diff (#594)

crystal-lang · Jul 23, 2023 · 4bf845f · 4bf845f
1 parent b55a827
commit 4bf845f
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 4 deletions.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -76,4 +76,6 @@ jobs:
       - name: Build manpages
         uses: Analog-inc/asciidoctor-action@master
         with:
-          shellcommand: "make manpages"
+          shellcommand: "make -B manpages SOURCE_DATE_EPOCH=\"$(date +%s --utc --date \"$(grep -m1 -o -E 'Date: .*' man/shard.yml.5 | cut -d' ' -f2)\")\""
+      - name: Ensure no changes
+        run: git diff --exit-code
diff --git a/man/shard.yml.5 b/man/shard.yml.5
@@ -1,7 +1,7 @@
 '\" t
 .\"     Title: shard.yml
 .\"    Author: [see the "AUTHOR(S)" section]
-.\" Generator: Asciidoctor 2.0.18
+.\" Generator: Asciidoctor 2.0.17
 .\"      Date: 2023-04-07
 .\"    Manual: File Formats
 .\"    Source: shards 0.17.3

diff --git a/man/shards.1 b/man/shards.1
@@ -1,7 +1,7 @@
 '\" t
 .\"     Title: shards
 .\"    Author: [see the "AUTHOR(S)" section]
-.\" Generator: Asciidoctor 2.0.18
+.\" Generator: Asciidoctor 2.0.17
 .\"      Date: 2023-04-07
 .\"    Manual: Shards Manual
 .\"    Source: shards 0.17.3
@@ -200,7 +200,9 @@ Disables colored output.
 .sp
 \-\-local
 .RS 4
-Don\(cqt update remote repositories, use the local cache only.
+Do not update remote repository cache. Instead, Shards will use the local copies
+already present in the cache (see \fBSHARDS_CACHE_PATH\fP).
+The command will fail if a depedency is unavailable in the cache.
 .RE
 .sp
 \-q, \-\-quiet