Return the lexicographically sorted list of files under DIR for which PRED returns true. PRED is passed two arguments: the absolute file name, and its stat buffer; the default predicate always returns true. PRED can also be a regular expression, in which case it is equivalent to (file-name-predicate PRED). STAT is used to obtain file information; using 'lstat' means that symlinks are not followed. If DIRECTORIES? is true, then directories will also be included. If FAIL-ON-ERROR? is true, raise an exception upon error.

Report to PORT about C, an '&invoke-error' condition, in a human-friendly way.

Insert the KEY/VALUE pair before the first occurrence of a pair whose key is REFERENCE in ALIST. Use KEY=? to compare keys. An error is raised when no such pair exists.

Create a desktop entry file at DESTINATION. You must specify NAME.

Values can be booleans, numbers, strings or list of strings.

Additionally, locales can be specified with an alist where the key is the locale. The #f key specifies the default. Example:

#:name '((#f "I love Guix") ("fr" "J'aime Guix"))

produces

Name=I love Guix Name[fr]=J'aime Guix

For a complete description of the format, see the specifications at https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html.

Set the atime/mtime of FILE to that specified by STAT.

This is like 'every', but process all the elements of LST instead of stopping as soon as PRED returns false. This is useful when PRED has side effects, such as displaying warnings or error messages.

Look for each of FILES of the given TYPE (a symbol as returned by 'stat:type') in INPUT-DIRS. Set ENV-VAR to a SEPARATOR-separated path accordingly. Example:

(set-path-environment-variable "PKG_CONFIG" '("lib/pkgconfig") (list package1 package2))

When PATTERN is not #f, it must be a regular expression (really a string) denoting file names to look for under the directories designated by FILES:

(set-path-environment-variable "XML_CATALOG_FILES" '("xml") (list docbook-xml docbook-xsl) #:type 'regular #:pattern "^catalog\\.xml$")

Return the complete file name for PROGRAM as found in $PATH, or #f if PROGRAM could not be found.

Find a file named FILE among the INPUTS and return its absolute file name.

FILE must be a string like "bin/sh". If FILE is not found, an exception is raised.

Atomically switch LINK, a symbolic link, to point to TARGET. Works both when LINK already exists and when it does not.

If FILE is a gzip file, reset its embedded timestamp (as with 'gzip --no-name') and return true. Otherwise return #f. When KEEP-MTIME? is true, preserve FILE's modification time.

Return a predicate that returns true when passed a file name whose base name matches REGEXP.

Find a sub-directory named DIRECTORY among the INPUTS and return its absolute file name.

DIRECTORY must be a string like "xml/dtd/docbook". If DIRECTORY is not found, an exception is raised.

Return true if FILE starts with the right magic bytes.