NAME

zoryn-gen-watch - Generate watch file from Debian, Gentoo or Arch sources.

SYNOPSIS

zoryn gen watch [OPTION]… [PACKAGE]

DESCRIPTION

Generate watch file from multiple sources: Debian, Gentoo ebuild, or Arch PKGBUILD. By default, queries all sources and shows a comparison table.

The watch file describes how to find new upstream versions and download tarballs. It is used by 'zoryn up --tarball' for tarball-based updates.

Priority order: Debian (most complete format) > Gentoo (newer version) > Arch. When multiple sources are found, displays a comparison table showing URL patterns.

If package name is not specified, it is auto-detected from the spec file in current directory.

After saving, the command also adds 'copy: .gear/watch' to .gear/rules and 'Source999: watch' to spec file if not already present.

ARGUMENTS

PACKAGE

Package name (auto-detect from spec if omitted).

OPTIONS

--arch-pkg=NAME

Specify Arch Linux package name explicitly.

-C DIR

Change to directory DIR before running.

-d, --debug

Enable debug output.

--debian-pkg=NAME

Specify Debian package name explicitly. Use when ALT and Debian package names differ.

-f, --force

Force update existing watch file.

--gentoo-pkg=NAME

Specify Gentoo package name explicitly (e.g., media-sound/mac).

--no-compare

Don't show comparison table, use first found source.

-p, --print

Print watch file content without saving.

COMMON OPTIONS

--help[=FMT] (default=auto)

Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.

--version

Show version information.

EXIT STATUS

zoryn gen watch exits with:

0

on success.

123

on indiscriminate errors reported on standard error.

124

on command line parsing errors.

125

on unexpected internal errors (bugs).

EXAMPLES

Fetch watch file for current package (searches all sources):

  zoryn gen watch

Fetch watch file for specific package:

  zoryn gen watch nginx

Fetch from package not in Debian (uses Gentoo/Arch):

  zoryn gen watch mac

Specify Gentoo package explicitly:

  zoryn gen watch --gentoo-pkg media-sound/mac

Preview watch file without saving:

  zoryn gen watch --print nginx

Force update existing watch file:

  zoryn gen watch --force

SEE ALSO

zoryn-up(1)

zoryn(1)