.. -*- coding: utf-8; indent-tabs-mode: nil; -*-


In a aggregated directory checksum at the end of a block:
A path equals

  ``./@/``

      Symlink to directory

  ``./@``

      Symlink to other filesystem object

Other paths that *end* with:

  ``/./@/``

      Symlink to a directory

  ``/./@`

      Symlink to other filesystem object


Fields:

  ``FSENCODING``

      The result of :func:`os.getfilesystemencoding` that is in effect when
      generating treesum digests

   ``ERROR``

      Errors are reported:

      - For directories if the one of filenames has a filename problem

   ``FLAGS``

      Defaults without any flags:

      - not following any symlinks (but :option:`--no-follow-file-symlinks` is
        not yet supported and coerced to :option:`--follow-file-symlinks`)
      - no modes- no mtime
      - filenames are in filesystem encoding
      - no file size is printed

      Contains:

      - ``with-metadata-fullmode``: if a file mode is used completely as
        given by the OS for digest computation
      - ``with-metadata-mode``: if just the "portable" file modes are used
        for digest computation
      - ``with-metadata-mtime``: if the mtime as ISO-String and truncated to
        seconds is used in digest computation
      - ``print-size``: if the filesize is to to be printed also
      - ``utf8-mode``: the filenames are not in FS encoding but in UTF-8
      - ``follow-symlinks-XXX`: if symlinks are followed on the command
        line, while directory walking or for files
      - ``size-only``: if no digest is to be computed and only a file's size
        is printed and the accumulated file sizes for a directory tree


Offene Fragen
=============

VFAT und Encoding
-----------------

Verfolgung von Encoding-Einstellungen über Mount-Punkte hinweg -- gerade
für externe Medien mit VFAT/MSDOS-FS.

  Erst einmal zurückgestellt