Automic VaultAutomic Vault

brew

Install yelp-tools with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Tools that help create and edit Mallard or DocBook documentation. Version 42.1 via Homebrew; verified 2026-04-22.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install yelp-tools

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install yelp-tools

MacPorts ports tree · gnome/yelp-tools/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add yelp-tools

Alpine Linux edge package indexes · yelp-tools · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%
sudo apt install yelp-tools

Debian stable package indexes · yelp-tools · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install yelp-tools

Fedora Rawhide package metadata · yelp-tools · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#yelp-tools

nixpkgs package indexes · pkgs/by-name/ye/yelp-tools/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%
sudo pacman -S yelp-tools

Arch Linux sync databases · yelp-tools · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%
sudo zypper install yelp-tools

openSUSE Tumbleweed package metadata · yelp-tools · source: download.opensuse.org

overview

Package summary

Tools that help create and edit Mallard or DocBook documentation

Commands and aliases

  • yelp-build
  • yelp-check
  • yelp-new

history

Project history and usage

yelp-tools is GNOME's small toolset for creating, checking, managing, and publishing Mallard or DocBook documentation. Its visible commands include `yelp-build`, `yelp-check`, and `yelp-new`, plus build-system integration through `yelp.m4`.

Project history

Yelp itself is GNOME's help viewer, and the GNOME wiki describes Yelp development as having produced related tools and XSLT modules under the Yelp umbrella. Yelp-tools separated the authoring and build utilities from the viewer so documentation teams could generate and validate help content without launching the application.

The yelp-tools NEWS file begins with a 3.1.1 initial release in 2011. Early 3.x development quickly added Mallard page status checks, EPUB generation, itstool and xmllint checks, faster HTML/cache generation, href validation, stricter validation, and DocBook link support.

The toolset followed GNOME's help-stack evolution: support for Mallard Sites appeared in the 3.17 series, Mallard stack files arrived in the 3.31 series, and the 40.alpha cycle converted `yelp-build`, `yelp-check`, and `yelp-new` to Python while moving to Meson and adding `.yelp-tools.cfg` support.

Adoption history

Adoption follows GNOME documentation infrastructure. The wiki presents yelp-tools as the package for creating and publishing Mallard or DocBook documentation, and downstream package indexes show it distributed broadly across Linux, BSD, MSYS2, Homebrew, MacPorts, Nix, and other ecosystems.

Because many GNOME and GTK-adjacent projects ship localized help, yelp-tools is more important than its small executable list suggests. It packages the boring but essential checks that keep help pages buildable, linkable, translatable, and publishable.

How it is used

`yelp-build` creates output such as HTML and EPUB from Mallard or DocBook sources. The GNOME wiki documents HTML generation from page files, directories of Mallard pages, or a top-level DocBook file.

`yelp-check` validates documents, checks links and hrefs, detects orphaned pages, checks media, statuses, page IDs, comments, licenses, and custom checks. `yelp-new` creates new documents and pages from templates, while `yelp.m4` helps integrate help builds into Autotools-era projects.

Why package nerds care

yelp-tools is package-nerd significant because it is infrastructure for documentation packages, not the documentation itself. It turns GNOME help authoring conventions into repeatable build and validation commands that distributions can rely on.

It is also a good example of a desktop project splitting runtime viewing, XSLT transformation, translation extraction, validation, and templates into separate packages so maintainers can depend on only the build-time pieces they need.

Timeline

  • 2011-05-08: The NEWS file records yelp-tools 3.1.1 as the initial release.
  • 2011-05-23: The 3.1.3 line adds Mallard status checking and EPUB building.
  • 2012-03-26: The 3.4.0 line adds DocBook support for `yelp-check` links and hrefs commands.
  • 2015: The 3.17 series adds Mallard Sites support across yelp-build and yelp-check.
  • 2019: The 3.31 series adds initial support for Mallard 1.2 stack files.
  • 2021-02-06: The 40.alpha line moves to Meson, converts the main tools to Python, adds improved templates, and introduces `.yelp-tools.cfg`.
  • 2022-10-30: The 42.1 tag fixes a DocBook path issue and remains a widely packaged line.

Related projects

  • Related projects include Yelp, yelp-xsl, Mallard, Project Mallard, DocBook, itstool, xmllint, GNOME Help, GNOME Documentation Project workflows, ScrollKeeper/Rarian-era help infrastructure, and Autotools/Meson documentation builds.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 4 runtime dependencies.
  • Build metadata lists 3 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
yelp-buildcliglobal executable
yelp-checkcliglobal executable
yelp-newcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version42.1
manager updated2026-04-22
local dataok
upstreamnot checked
latest detectednot detected

https://gitlab.gnome.org/GNOME/yelp-tools

install metadata

Package metadata

Package keybrew:yelp-tools
Version42.1
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/yelp-tools
Homepagehttps://gitlab.gnome.org/GNOME/yelp-tools
Repositoryhttps://gitlab.gnome.org/GNOME/yelp-tools
Upstream docshttps://wiki.gnome.org/Apps/Yelp/Tools
LicenseGPL-2.0-or-later
Source archivehttps://download.gnome.org/sources/yelp-tools/42/yelp-tools-42.1.tar.xz
Last updated2026-04-22T14:19:50Z
Pulseupdated
Dependenciesitstool, libxml2, python@3.14, yelp-xsl
Build dependenciesmeson, ninja, pkgconf
Uses from macOSlibxslt
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameyelp-tools
Version Scheme0
Revision3
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

yelp-tools 42.1-3

Yelp documentation tools

https://wiki.gnome.org/Apps/Yelp/Tools

sudo apt install yelp-tools
  • Section: gnome
  • Architecture: all
  • 8 dependencies
  • 2 optional deps
  • normalized package name match
  • Matched by: Yelp Tools
Debian stable package indexes · deb.debian.org · Debian stable package indexes: yelp-tools from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

yelp-tools

nix profile install nixpkgs#yelp-tools
  • normalized package name match
  • Matched by: Yelp Tools
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ye/yelp-tools/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

yelp-tools 42.1-2

Yelp documentation tools

https://wiki.gnome.org/Apps/Yelp/Tools

sudo apt install yelp-tools
  • Section: universe/gnome
  • Architecture: all
  • 8 dependencies
  • 2 optional deps
  • normalized package name match
  • Matched by: Yelp Tools
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: yelp-tools from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

yelp-tools 42.1-r2

Collection of utilities to help create documentation

https://gitlab.gnome.org/GNOME/yelp-tools

sudo apk add yelp-tools
  • License: GPL-2.0-or-later
  • Architecture: x86_64
  • Source Package: yelp-tools
  • 1 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Yelp Tools
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: yelp-tools from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
dnf95%

yelp-tools 42.1-12.fc45

Create, manage, and publish documentation for Yelp

https://wiki.gnome.org/Apps/Yelp/Tools

sudo dnf install yelp-tools
  • License: GPL-2.0-or-later
  • Category: Unspecified
  • Architecture: noarch
  • Source Package: yelp-tools
  • 7 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Yelp Tools
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: yelp-tools from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
pacman95%

yelp-tools 42.1-2

Collection of tools for building and converting documentation

https://gitlab.gnome.org/GNOME/yelp-tools

sudo pacman -S yelp-tools
  • License: GPL
  • Architecture: any
  • 6 dependencies
  • normalized package name match
  • Matched by: Yelp Tools
Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: yelp-tools from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz
zypper95%

yelp-tools 42.1-2.5

Collection of utilities to help create documentation

https://projects.gnome.org/yelp/

sudo zypper install yelp-tools
  • License: GPL-2.0-or-later
  • Category: Development/Tools/Other
  • Architecture: noarch
  • Source Package: yelp-tools
  • 4 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Yelp Tools
openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: yelp-tools from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst
MacPorts95%

yelp-tools

sudo port install yelp-tools
  • normalized package name match
  • Matched by: Yelp Tools
MacPorts ports tree · api.github.com · MacPorts ports tree: gnome/yelp-tools/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • itstoolRuntime dependency declared by Homebrew.
  • libxml2Runtime dependency declared by Homebrew.
  • python@3.14Runtime dependency declared by Homebrew.
  • mesonBuild dependency declared by Homebrew.
  • ninjaBuild dependency declared by Homebrew.
  • pkgconfBuild dependency declared by Homebrew.

Same workflow

  • docbook-xslShares av.db curated category or tags: cli, developer-tools, docbook, documentation.
  • gtk-docShares av.db curated category or tags: cli, developer-tools, documentation, gnome.
  • kdoctoolsShares av.db curated category or tags: cli, developer-tools, docbook, documentation.
  • action-docsShares av.db curated category or tags: cli, developer-tools, documentation.
  • adr-toolsShares av.db curated category or tags: cli, developer-tools, documentation.
  • adr-viewerShares av.db curated category or tags: cli, developer-tools, documentation.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment