Tasks
=====

General Cleanup
---------------

  * Eliminate metadata caching.
  * General code auditing and cleanup:
    - Protect against command operands beginning with "-", e.g.:
      * `[ "x${foo}" = 'xbar' ]` instead of `[ "${foo}" = 'bar' ]`
      * `mkdir -p -- "${foo}"` instead of `mkdir -p "${foo}"`
    - Add more error handling.
  * Write manual pages for functions and utilities.
  * Change/update option letters for `ob_parse_dep()`.

Functional Changes
------------------

  * ob-installdocs: Handle non-directory non-regular files?
  * ob-applypatches: Fix to not fall over when it runs too much.
    - Current behavior: "I've been here already!  What do?  *trip*"
    - Track applied patches in ob-applypatches.
      * Copy each patch into the opkbuild cache.
      * Compare cached and current patches, and skip applied patches.
        - `ob-applypatches: Skipping applied patch "01_foo.patch"...`
        - `ob-applypatches: Warning: Patch "01_foo.patch" has been modified since it was applied`
  * ob-buildopk: Build internal archives with ar, not tar.
  * ob-buildopk, ob-genchanges, ob-gencontrol, opkbuild: s/src-/src:/
  * Split distribution packaging from upstream sources in source packages.
    - Non-native package:
      * `src:foo` is the distribution packaging, and it depends on
        `src:foo:upstream`
      * If the revision isn't "1", don't build and upload upstream sources.
    - Native package:
      * `src:foo` is the whole package.
      * Upload everything always.
  * Drop mksysconf.
  * ob-unpacksource: Support xz upstream archive decompression.
  * ob-unpacksource: Maybe call separate decompressor utilities instead of using
    tar's seamless decompression.  This enables support for xz with
    BusyBox < 1.21.0 (commit dfc2473).  (Not really needed, since ProteanOS has
    used a sufficiently recent BusyBox since early 2014.)

Copyright
=========

Copyright (C) 2012, 2018, 2019  Patrick McDermott

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.