relocate BLOCK.txt to move convenient location

fix stack build on windows

For whatever reason, putting Win32-2.13.4.0 in stack.yaml results in
stack blowing up with many unrelated dependency problems.
But making git-annex depend on that version lets stack resolve deps.

pin win32 to working version

fix build on windows

avoid cpp failure on windows

Seems that while the module is not imported by anything on windows, it
still gets cpped, and MIN_VERSION_unix is not defined so it failed to
preprocess.

enable TypeOperators

more warnings about ~ needing it in a future ghc release

add back utf8-string to setup build deps

Needed on Windows since Utility.FileSystemEncoding uses it

fix hang when built with unix-2.8

git-annex test hang when running git-annex add in an adjusted unlocked
branch. I couldn't seem to reproduce the hang outside the test suite.

Seems that the code added in 26a9ea12d11f85b43987d863449c790f7320d9d1
was buggy, and as that commit was made without testing it, building with
unix-2.8 exposed the bug.

I don't fully understand the bug, which involves fdToHandle
and then closing the fd, vs closing the handle. May somehow involve
laziness or forcing around the S.hGet? Using hClose solved it
in any case.

(Also eliminated checkcontentfollowssymlinks to fix a build warning
when it's not used.)

stack.yaml: Update to build with ghc-9.6.2 and aws-0.24

This enables some new features that need the new aws.

Use http-client-restricted-0.1.0 because it uses the crypton side of the
cryptonite/crypton fork, which seems to be needed for ghc-9.6.2.

Dependency on connection removed because of the cryptonite/crypton fork.
This avoids needing a build flag. It was only used to throw a typed
exception in Utility.Url, which nothing depended on.

Used a fork of bloomfilter because it's not being maintained and no longer
builds as-of this ghc version. (I have been trying to contact its
maintainer about it, and emailed him today suggesting I take over the
package.)

Sponsored-by: Brock Spratlen on Patreon

fix build with unix-2.8.0

Changed the parameters to openFd. So needed to add a small wrapper
library to keep supporting older versions as well.

enable TypeOperators

fix whitespace

Thanks to a compile warning from new ghc

enable TypeOperators

    The use of ‘~’ without TypeOperators
    will become an error in a future GHC release.

says new ghc

fix build with unix-2.8.0

got the arguments the wrong way around when I wrote this

also squelch a build warning

fix build with unix-2.8.0

It made UserInfo into a pattern to discourage manually constructing
them, so just to use UserInfo in a type signature of a function that
consumes them, have to import the new ByteString module.

fix build on windows

rewrap

support building with unix-compat 0.7

It removed System.PosixCompat.User.

Merge branch 'master' of ssh://git-annex.branchable.com

Setup.hs: Stop installing man pages, desktop files, and the git-annex-shell and git-remote-tor-annex symlinks

Anything still relying on that, eg via cabal v1-install will need to
change to using make install-home. Which was added back in 2019 in
6491b626140a9e5cc8e99fff4a1434d7c0e9bc39 because cabal new-build
(now the default) already didn't use Setup in a way that let its
installation of those things work.

Notably this means Setup does not need to depend on unix-compat, which is
useful because in 0.7 it removed System.PosixCompat.User, which Setup
needed to determine where to install the desktop files. See
https://github.com/haskell-pkg-janitors/unix-compat/issues/3

Add missing formatting backtick

onlyingroup

* Support "onlyingroup=" in preferred content expressions.
* Support --onlyingroup= matching option.

Sponsored-by: Jack Hill on Patreon

foo

comment

comment

mention --explain

Sponsored-by: Dartmouth College's DANDI project

display explanations in --debug too

When --explain is not enabled. This can be useful debugging information
as well.

Sponsored-by: Dartmouth College's DANDI project

--explain for numcopies checks

And closed the todo as completed.

Sponsored-by: Dartmouth College's DANDI project

Added a comment: onlyingroup also useful for offline backup drives

Added a comment

Added a comment: No built-in way for dropping all old versions of a file AFAIK

Suggest that git annex diffdriver fetches content to diff

Added a comment: Dropping all older versions of a file

Added a comment

Added a comment: --explain is very helpful 👍

Merge branch 'master' of ssh://git-annex.branchable.com

improve match explanations

Using == and != proved too hard to read, so went with [TRUE] and [FALSE]
after the term. I would kind of liked to have used emojis for a green
check and red X, but probably that is too fancy to be a good idea.

Make --explain output be inside [ ] with whitespace around them, to
avoid it ending with eg "[FALSE]]" and to make it easier to visually
find the start of it.

Sponsored-by: Dartmouth College's DANDI project

improve match result display simplifier

Sponsored-by: Dartmouth College's DANDI project

fix bug in match result display simplifier

Sponsored-by: Dartmouth College's DANDI project

--explain for preferred/required content matching

And annex.largefiles and annex.addunlocked.

Also git-annex matchexpression --explain explains why its input
expression matches or fails to match.

When there is no limit, avoid explaining why the lack of limit
matches. This is also done when no preferred content expression is set,
although in a few cases it defaults to a non-empty matcher, which will
be explained.

Sponsored-by: Dartmouth College's DANDI project

Added a comment: Workaround for listing dead remotes

Merge branch 'master' of ssh://git-annex.branchable.com

initial implementation of --explain

Currently it only displays explanations of options like --in and --copies.

In the future, it should explain preferred content expression evaluation
and other decisions.

The explanations of a few things could be better. In particular,
"standard" will just appear as-is (or as "!standard" if it doesn't
match), rather than explaining why the standard preferred content expression
for the group matches or not.

Currently as implemented, it goes to stdout, and so commands like
git-annex find that have custom output will not display --explain
information. Perhaps that should change, dunno.

Sponsored-by: Dartmouth College's DANDI project

Revert "use existing debug machinery for explain"

This reverts commit 409572c9e4c0c77814a5b448d26cf87054b07874.

use existing debug machinery for explain

explain is a kind of debug message, but not formatted in the same way.
So it makes sense to reuse the debug machinery for it, since that is
already quite optimised.

Sponsored-by: Dartmouth College's DANDI project

remove excess doubled parens in match description

Sponsored-by: Dartmouth College's DANDI project

parenthesize match description as needed to avoid ambiguity

While avoiding most unncessary parens.

Once case where unncessary parens are not avoided is:

not ( ( not foo and baz ) )

It would be good eventually to remove doubled parens like these.

Sponsored-by: Dartmouth College's DANDI project

list some Utility/ modules that are AGPL

accumulate description while matching

This is to be used to explain why something did or didn't match.

Note that this reimplements match in terms of matchMrun.
Implementing match' as a Writer and matchMrun' as a MonadWriter
resulted in nearly identical implementations, which collapsed into the
same thing thanks to Writer being WriterT Identity.

MAnd and MOr implement short circuiting. So an expression
like "not (foo and bar)" will be explained as [MatchedNot, MatchOperation "foo"]
when foo does not match; whether bar matches is irrelevant. Similarly
"foo or bar" will be explained as [MatchedOperation "foo"] when foo
matches. It seems like that will keep the explanations more
understandable. But also, matchMrun already did short circuiting, and it
could be considerably more work to check if bar matches in these cases.

Note that the type signature of matchMrun changed, but it was
over-generic before.

Note that these changes are licensed under the AGPL. Changed module
license accordingly.

Sponsored-by: Dartmouth College's DANDI project

tag option_to_explain dandi

See comment, this is a continuation of the other todo that was tagged
dandi and which I didn't fully address at the time.

Added a comment

gcrypt: Remove empty hash directories when dropping content

As was recently done with the directory special remote.

Note that the top directory passed to removeDirGeneric was changed to
avoid deleting .git/annex or .git/annex/objects if they ended up empty.

Sponsored-by: Brett Eisenberg on Patreon

typo

comment

remove spam

comment

directory: Remove empty hash directories when dropping content

Failure to remove is not treated as a problem, and no permissions
modifications are done, to avoid unexpected states.

Sponsored-by: Luke Shumaker on Patreon

dropunused: Support --jobs

Sponsored-by: Kevin Mueller on Patreon

deal with Amazon S3 breaking change for public=yes

* S3: Amazon S3 buckets created after April 2023 do not support ACLs,
  so public=yes cannot be used with them. Existing buckets configured
  with public=yes will keep working.
* S3: Allow setting publicurl=yes without public=yes, to support
  buckets that are configured with a Bucket Policy that allows public
  access.

Sponsored-by: Joshua Antonishen on Patreon

comment

Added a comment: thank

bug report

add PeerTube link to Yann's Git Annex talk @Tübix2023

Added a comment

Added a comment: unspecified default preferred content = present

Added a comment

comment

Suggest onlyingroup preferred content expression

Added a comment: git annex drop --unused --jobs=cpus works

comment

Merge branch 'master' of ssh://git-annex.branchable.com

add a warning and a related todo

arising from a conversation at FOSSY

fix formatting of \ continued shell examples in man pages

doc/git-annex-filter-branch.mdwn and one other file have these, and no
other files have \ at the end of line, so this should be safe

Added a comment: git mv to temporary name, commit, git mv back, commit, can resolve duplicates

Added a comment

Added a comment: Plumbing commands vs Porcelain commands

Merge branch 'master' of ssh://git-annex.branchable.com

comment

Added a comment

comment

Merge branch 'master' of ssh://git-annex.branchable.com

Added a comment

Added a comment

Added a comment: Alternative proposal for better backwards compatibility

Added a comment: Clarification

Added a comment: There is already something like fullsync: `git annex assist`, suggestion: new `metasync` command

Added a comment: Preferred content settings not really an alternative

Added a comment: History of change

Added a comment: Breaking change to "sync"

Added a comment

Added a comment

Added a comment: I have to agree that this change to `sync` is annoying