summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorLouie S <louie@example.com>2024-01-16 08:39:58 -0500
committerLouie S <louie@example.com>2024-01-16 08:39:58 -0500
commit10a6815096b5101618d22c518dcc72331831d231 (patch)
tree42313030e450f067ce85b1a6c18f5b8dcfb3699d /README
parent8fb96e377ed2fa0c0ab707425b862363a29be859 (diff)
First commit as Meson docset generator
Diffstat (limited to 'README')
-rw-r--r--README19
1 files changed, 19 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..6959129
--- /dev/null
+++ b/README
@@ -0,0 +1,19 @@
+Here is a script and a Makefile for generating a Meson docset for Dash. The script is based on the dash-docset-generation-template
+
+- Meson: https://mesonbuild.com/
+- Dash: https://kapeli.com/dash
+- dash-docset-generation-template: https://github.com/lshprung/dash-docset-generation-template
+
+To generate a docset from the latest edition of the Meson Manual:
+1. Build an offline copy of the Meson official docs from https://github.com/mesonbuild/meson/tree/master/docs by following their instructions.
+2. Create a .tar.gz file called `Meson.src.tgz` containing everything from the `built_docs/Meson documentation-doc/html` directory, and place it in the same directory as this README.
+ - Do not name it `Meson.tgz` because that is what the packaged Dash docset will be called
+3. Now simply execute `make` from the same directory as this README file.
+
+Requirements:
+
+- any POSIX-compliant shell
+- curl - https://curl.se/
+- make - https://www.gnu.org/software/make/
+- pup - https://tracker.debian.org/pkg/pup
+- sqlite3 - https://www.sqlite.org/index.html