Skip to content

Latest commit

 

History

History
72 lines (45 loc) · 1.82 KB

README.md

File metadata and controls

72 lines (45 loc) · 1.82 KB

dash-fish

dash-fish is a toolchain for the generation of a Dash docset for the fish shell. It uses Sphinx to build HTML documentation from the source and Dashing to generate the docset from it.

Installation

Clone the repo with git:

git clone git@github.com:andreiborisov/dash-fish.git

System requirements

Install the dependencies with Homebrew (recommended):

brew bundle
Not using Homebrew?

dash-fish requires:

Usage

To generate the docset, run:

make build

This produces both the fish.docset itself and its archived version for submitting it to Dash user contributions.


dash-fish integrates docs source from fish shell repo in order to customise the Sphinx build by stripping out unnecessary elements.

To grab fresh commits from the upstream run:

make fetch_subtree

This will clone fish shell repo into a temporary folder, filter out unrelated commits and add related ones via git subtree. You can merge or rebase main branch after that and rebuild the docset:

git rebase fish-shell main
make build

To clean the working directory from build artifacts, run:

make clean

License

dash-fish is licensed under the MIT License.

fish shell docs and icon are licensed under the GNU General Public License, version 2.