librelib(7) -- Suite of Bash libraries
======================================

## SYNOPSIS

Overview of the librelib Bash library suite.

## DESCRIPTION

There are three parts to librelib:

 1. The `librelib`(1) executable.
 2. The non-executable libraries installed in `/usr/lib/libretools`
 3. The executable libraries installed in `/usr/bin`

The `librelib` executable isn't very exciting, it just finds the
libraries installed in `/usr/lib/libretools`.  Think of it as a sort
of dynamic-linker.

The 'core' of librelib are the libraries installed in
`/usr/lib/libretools`.  These are `Bash`(1) libraries that may be
sourced in Bash programs.

Some of these libraries also make sense as stand-alone programs, where
if they are invoked directly, the first argument is the library
routine to be executed.  For example, the `messages` library may be
included, or executed:

    . "$(librelib messages)"
    msg2 "Foo was found: %s" "$foo"
    # or
    libremessages msg2 "Foo was found: %s" "$foo"

The `blacklist` library is similar:

    . "$(librelib blacklist)"
    blacklist-update
    # or
    libreblacklist update

## SEE ALSO

 * librelib(1)
 * libremessages(1)/messages.sh(3)
 * libreblacklist(1)/blacklist.sh(3)
 * conf.sh(3)
 * common.sh(3)

<!--
  Copyright (C) 2013-2014, 2016, 2024  Luke T. Shumaker <lukeshu@parabola.nu>

  SPDX-License-Identifier: GPL-2.0-or-later

  This file is part of Parabola Libretools.

  Libretools is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 2 of the License, or
  (at your option) any later version.

  Libretools is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.
-->
