summaryrefslogtreecommitdiff
path: root/README
blob: 69591291ba15c9ba1597dd0e74cd638bd2c276fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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