On this page:
6.1 Package creation tools
6.1.1 Git  Host2Metadata
6.1.1.1 About
6.1.1.2 Console usage
6.1.2 Interactive
6.1.2.1 About
6.1.2.2 Console usage
6.1.3 UL2PKG
6.1.3.1 About
6.1.3.2 Console usage
6.2 Repository maintenance tools
6.2.1 Clean Versions
6.2.1.1 About
6.2.1.2 Console usage
6.2.2 Commit
6.2.2.1 About
6.2.2.2 Console usage
6.2.3 Fix Head
6.2.3.1 About
6.2.3.2 Console usage
6.2.4 Manifest
6.2.4.1 About
6.2.4.2 Console usage
6.2.5 Modify metadata
6.2.5.1 About
6.2.5.2 Console usage
6.2.6 PKGName
6.2.6.1 About
6.2.6.2 Console usage
6.3 Miscellaneous tools
6.3.1 Dispatcher (racket-ebuild)
6.3.1.1 About
6.3.1.2 Console usage
9.3.0.10

6 Ebuild Tools🔗ℹ

6.1 Package creation tools🔗ℹ

6.1.1 GitHost2Metadata🔗ℹ

 (require ebuild/tools/githost2metadata-exe)
  package: ebuild-tools

6.1.1.1 About🔗ℹ

Create a PMS package metadata file from Git hosting service repository.

6.1.1.2 Console usage🔗ℹ
  • --c or --create — create (save) the metadata

  • --s or --show — show (display) the metadata

  • --d ‹directory-path› or --dir ‹directory-path› — directory where the created metadata file should be saved

  • -v or --verbose — be verbose (detailed console output)

  • -q --quiet — be quiet (minimal/no console output)

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

githost2metadata also expects two arguments given last in the command invocation. First is the git hosting domain (e.g.: github.com, gitlab.com, ...). Second is the repository path (e.g.: xgqt/racket-ebuild, gentoo/gentoo, ...).

6.1.2 Interactive🔗ℹ

 (require ebuild/tools/interactive-exe)
  package: ebuild-tools

6.1.2.1 About🔗ℹ

Interactively creates packages.

6.1.2.2 Console usage🔗ℹ
  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.1.3 UL2PKG🔗ℹ

 (require ebuild/tools/url2pkg-exe) package: ebuild-tools

6.1.3.1 About🔗ℹ

Creates a package from given URL based on different heuristic tactics.

Quality: very experimental.

6.1.3.2 Console usage🔗ℹ
  • --pn ‹package-name› or --package-name ‹package-name› — package name

  • --pv ‹package-version› or --package-version ‹package-version› — package version

  • --save — save generated package

  • --show — show generated package

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2 Repository maintenance tools🔗ℹ

6.2.1 Clean Versions🔗ℹ

 (require ebuild/tools/clean-versions-exe)
  package: ebuild-tools

6.2.1.1 About🔗ℹ

Cleans up old versions of ebuilds from a repository.

6.2.1.2 Console usage🔗ℹ
  • -m ‹number› or --max ‹number› — maximum number of ebuilds to keep

  • -r ‹path› or --repository ‹path› — directory path to ebuild repository

  • -s or --simulate — simulate, show only what would be deleted

  • -n or --no-simulate — do not simulate, delete the files (defaults to current unless a directory is specified by --repository)

  • -q --quiet — be quiet (minimal/no console output)

  • -v or --verbose — be verbose (detailed console output)

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2.2 Commit🔗ℹ

 (require ebuild/tools/commit-exe) package: ebuild-tools

6.2.2.1 About🔗ℹ

Create a commit.

This utility is inspired by repoman commit and new utility meant to take place of repoman - pkgdev commit.

6.2.2.2 Console usage🔗ℹ
  • --m ‹commit-message› or --–message ‹commit-message› — specify the main commit message

  • --M ‹commit-message› or --–aux-message ‹commit-message› — specify the auxiliary commit message, auto-line-wrapped

  • --b ‹gentoo-bug/url› or --–bug ‹gentoo-bug/url› — add "Bug" tag for a given Gentoo or upstream bug/URL

  • --c ‹gentoo-bug/url› or --–closes ‹gentoo-bug/url› — add "Closes" tag for a given Gentoo or upstream bug/URL

  • --d or --–dry-run — do not make commits

  • --e or --–edit — force editing the commit even if message is not empty

  • --E or --–editor — overwrite the EDITOR environment variable, EDITOR is used to edit the commit message when --–edit flag is enabled

  • --a or --–all — stage all changed/new/removed files

  • --u or --–update — stage all changed files

  • --T or --–test-build — test modified, staged ebuilds by executing their test phases, produces a lot of noise and requires portage user privileges and that the user is in portage group

  • --s or --–scan — scan using "pkgcheck"

  • --n or --–scan-nonfatal — do not fail when scanning with "pkgcheck"

  • --k or --–ask-continue — ask whether user wants to continue after failed "pkgcheck" scan, only effective if both --–scan and --–scan-nonfatal flags are enabled

  • --U or --–update-manifests — update Manifest files

  • --S or --–sign — sign the created commit

  • --B ‹package-version› or --–bump ‹package-version› — set the commit message to "bump to ‹package-version›" (use when updating ebuilds)

  • --–bump-copy — if doing a package bump, copy the latest ebuild as that version, works only in conjunction with the --B / --–bump flag

  • --D ‹package-version› or --–drop ‹package-version› — set the commit message to "drop old ‹package-version›" (use when removing ebuilds)

  • --–drop-remove — if doing a package drop, remove the specified ebuild version, works only in conjunction with the --D / --–drop flag

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2.3 Fix Head🔗ℹ

 (require ebuild/tools/fix-head-exe) package: ebuild-tools

6.2.3.1 About🔗ℹ

Fix the header of given Ebuild files.

6.2.3.2 Console usage🔗ℹ
  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2.4 Manifest🔗ℹ

 (require ebuild/tools/manifest-exe) package: ebuild-tools

6.2.4.1 About🔗ℹ

Regenerate Manifest files in given directories.

This program uses the ebuild command (that is included in portage).

6.2.4.2 Console usage🔗ℹ
  • -f or --force — force regeneration of distfiles

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2.5 Modify metadata🔗ℹ

 (require ebuild/tools/modify-metadata-exe)
  package: ebuild-tools

6.2.5.1 About🔗ℹ

Modify metadata.xml files.

6.2.5.2 Console usage🔗ℹ
  • -a ‹name› ‹contents› or --add ‹name› ‹contents› — add a field of name with contents

  • -r ‹name› or --remove ‹name› — remove a field with name

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

6.2.6 PKGName🔗ℹ

 (require ebuild/tools/pkgname-exe) package: ebuild-tools

6.2.6.1 About🔗ℹ

Shows package name for a given directory.

6.2.6.2 Console usage🔗ℹ
  • -c or --no-category — do not show package categories

  • -D or --debug — run with debugging turned on

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program

Also takes any number of of arguments not followed by flags that specify system paths to be passed to "pkgname".

6.3 Miscellaneous tools🔗ℹ

6.3.1 Dispatcher (racket-ebuild)🔗ℹ

 (require ebuild/tools/dispatcher-exe)
  package: ebuild-tools

6.3.1.1 About🔗ℹ

Invoked from command-line as racket-ebuild.

Dispatcher calls a Racket-Ebuild sub-command given as 1st argument with rest leftover arguments, similar to how git calls it’s sub-commands.

For example: when calling racket-ebuild commit -s the dispatcher will execute racket-ebuild-commit -s.

6.3.1.2 Console usage🔗ℹ
  • -l or --list — list available subcommands

  • -h or --help — show help information with usage options and exit

  • -V or --version — show the version of this program