.github/workflows/gw2dmk-build.yml

@@ -48,9 +48,7 @@ jobs:
       package_name: ${{ steps.package_and_version.outputs.package_name }}
       package_version: ${{ steps.package_and_version.outputs.package_version }}
     steps:
-      - uses: actions/checkout@v3
-        with:
-          submodules: true
+      - uses: actions/checkout@v4
 
       - id: package_and_version
         run: |
@@ -73,6 +71,8 @@ jobs:
         platform: [linux_x86_64, linux_armv7l, linux_aarch64, mswin32, mswin64]
         include:
           - platform: linux_x86_64
+            # Use crossbuild-aarch64 for native builds.
+            container: ${{ inputs.container_base }}/ubuntu-20.04-crossbuild-aarch64
             target_platform_name: linux
             target_platform: LINUX_X86_64
             target_arch: .x86_64
@@ -97,9 +97,7 @@ jobs:
     container:
       image: ${{ matrix.container }}
     steps:
-      - uses: actions/checkout@v3
-        with:
-          submodules: true
+      - uses: actions/checkout@v4
 
       - name: Build target
         id: build_target
@@ -109,7 +107,7 @@ jobs:
           echo "build_artifacts_name=${package}-${version}-${target_platform_full_name}-build-artifacts" >> $GITHUB_OUTPUT
 
       - name: Upload build artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ steps.build_target.outputs.build_artifacts_name }}
           path: build.${{ env.target_platform_full_name }}/${{ env.package }}-${{ env.version }}-${{ env.target_platform_full_name }}.tar.gz

.github/workflows/gw2dmk-release.yml

@@ -30,7 +30,7 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Show package name and version
         run: |
@@ -41,7 +41,7 @@ jobs:
         run: mkdir github_artifacts
 
       - name: Download build artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           path: github_artifacts
 

BUILDING.md

@@ -15,25 +15,26 @@ to install additional packages before you build.
 
 ### Installing packages
 
-First, you'll need to install packages for C development.
+First, you'll need to install packages for C development and generating
+PDFs.
 
 On Fedora and RHEL-like distros, run:
 
 ```
-$ sudo dnf install -y @c-development
+$ sudo dnf install -y @c-development groff-perl perl-IO-Compress
 ```
 
 On Debian, Ubuntu, and related distros, run:
 
 ```
 $ sudo apt-get update
-$ sudo apt-get install -y build-essential
+$ sudo apt-get install -y build-essential groff
 ```
 
-Then when cloning this repo, make sure to use the `--recursive` flag like so:
+To clone this repo, run:
 
 ```
-$ git clone --recursive git@github.com:qbarnes/gw2dmk.git
+$ git clone git@github.com:qbarnes/gw2dmk.git
 ```
 
 ### Building natively
@@ -79,10 +80,10 @@ $ sudo apt-get update
 $ sudo apt-get install -y build-essential mingw-w64 gcc-aarch64-linux-gnu gcc-arm-linux-gnueabi
 ```
 
-Then when cloning this repo, make sure to use the `--recursive` flag like so:
+To clone this repo, run:
 
 ```
-$ git clone --recursive git@github.com:qbarnes/gw2dmk.git
+$ git clone git@github.com:qbarnes/gw2dmk.git
 ```
 
 ### Cross-building
@@ -141,10 +142,10 @@ $ sudo apt-get update
 $ sudo apt-get install -y git make docker.io
 ```
 
-Then when cloning this repo, make sure to use the `--recursive` flag like so:
+To clone this repo, run:
 
 ```
-$ git clone --recursive git@github.com:qbarnes/gw2dmk.git
+$ git clone git@github.com:qbarnes/gw2dmk.git
 ```
 
 ### Using containers for building

Makefile.build

@@ -8,6 +8,12 @@ ifdef E
 LDLIBS  += -static -lregex
 endif
 
+nroff ?= nroff
+groff ?= groff
+
+nroff_txt_flags	?= -c
+groff_pdf_flags	?=
+
 build_dir	?= build
 
 ifndef top_dir
@@ -29,10 +35,17 @@ vpath %		$(top_dir)
 obj_targets	= gw2dmk.o dmk2gw.o gw.o gwx.o msg.o m2.o gwhisto.o \
 		   gwhist.o gwdetect.o crc.o
 
-targets		= gw2dmk$E dmk2gw$E gwhist$E m2$E
+bins		= gw2dmk dmk2gw gwhist
+bin_targets	= $(foreach b,$(bins), $b$E)
+
+man_txt_targets	 = $(foreach b,$(bins),$b.1.txt)
+man_pdf_targets	 = $(foreach b,$(bins),$b.1.pdf)
+man_html_targets = $(foreach b,$(bins),$b.1.html)
+man_targets	 = $(man_txt_targets) $(man_pdf_targets) $(man_html_targets)
+
+targets		= $(bin_targets) $(man_targets)
 
-#tar_files	= LICENSE README.md $(targets) $(tar_extras)
-tar_files	= LICENSE README.md gw2dmk$E dmk2gw$E gwhist$E $(tar_extras)
+tar_files	= LICENSE README.md $(targets) $(tar_extras)
 
 clean_files	= $(targets) $(obj_targets)
 
@@ -84,20 +97,30 @@ gw2dmk$E: msg.o gw.o gwx.o gwhisto.o gwdetect.o gwdecode.o gwmedia.o dmk.o \
 dmk2gw$E: msg.o gw.o gwx.o gwdetect.o gwmedia.o dmk.o dmkx.o secsize.o dmk2gw.o
 	$(LINK.c) $^ $(LOADLIBES) $(LDLIBS) -o '$@'
 
-gwhist$E: msg.o gw.o gwx.o gwhisto.o gwhist.o
+gwhist$E: msg.o gw.o gwx.o gwhisto.o gwdetect.o gwhist.o
 	$(LINK.c) $^ $(LOADLIBES) $(LDLIBS) -o '$@'
 
 m2$E: msg.o m2.o gw.o gwx.o
 	$(LINK.c) $^ $(LOADLIBES) $(LDLIBS) -o '$@'
 
+%.txt: %
+	$(nroff) -man -Tascii $(nroff_txt_flags) $< | col -b | cat -s > $@
+
+%.pdf: %
+	$(groff) -man -Tpdf $(groff_pdf_flags) $< > $@
+
+%.html: %
+	$(groff) -man -Thtml $(groff_html_flags) $< > $@
+
+
 $(TARBALLGZ): $(tar_files)
 	tar -czP \
 		--transform='s:^$(top_dir)/::' \
 		-f '$@' $^
 
 
 clean clobber distclean:
-	$(call scrub_files_call,$($*_files))
+	$(call scrub_files_call,$($@_files))
 
 
 .PHONY: FORCE all release

dmk.h

@@ -43,7 +43,6 @@ extern "C" {
 #define DMKI_TRACKLEN_8SD  0x14e0 /* DMK_TKHDR_SIZE + 5216 (nominal 5208) */
 #define DMKI_TRACKLEN_8    0x2940 /* DMK_TKHDR_SIZE + 10432 (nominal 10416) */
 #define DMKI_TRACKLEN_3HD  0x3180 /* DMK_TKHDR_SIZE + 12544 (nominal 12500) */
-#define DMKI_TRACKLEN_MAX  DMKI_TRACKLEN_3HD
 
 
 /* Track lengths for reads from media.  Allows for 2% slower than nominal
@@ -58,6 +57,7 @@ extern "C" {
 #define DMKRD_TRACKLEN_8SD  0x1560 /* DMK_TKHDR_SIZE + 5344 (nominal 5208) */
 #define DMKRD_TRACKLEN_8    0x2A40 /* DMK_TKHDR_SIZE + 10688 (nominal 10416) */
 #define DMKRD_TRACKLEN_3HD  0x3260 /* DMK_TKHDR_SIZE + 12768 (nominal 12500) */
+#define DMKRD_TRACKLEN_MIN  DMKRD_TRACKLEN_5SD
 #define DMKRD_TRACKLEN_MAX  DMKRD_TRACKLEN_3HD