git-annex/doc
Joey Hess 1d1054faa6
added -z
Added -z option to git-annex commands that use --batch, useful for
supporting filenames containing newlines.

It only controls input to --batch, the output will still be line delimited
unless --json or etc is used to get some other output. While git often
makes -z affect both input and output, I don't like trying them together,
and making it affect output would have been a significant complication,
and also git-annex output is generally not intended to be machine parsed,
unless using --json or a format option.

Commands that take pairs like "file key" still separate them with a space
in --batch mode. All such commands take care to support filenames with
spaces when parsing that, so there was no need to change it, and it would
have needed significant changes to the batch machinery to separate tose
with a null.

To make fromkey and registerurl support -z, I had to give them a --batch
option. The implicit batch mode they enter when not provided with input
parameters does not support -z as that would have complicated option
parsing. Seemed better to move these toward using the same --batch as
everything else, though the implicit batch mode can still be used.

This commit was sponsored by Ole-Morten Duesund on Patreon.
2018-09-20 16:11:47 -04:00
..
android
Android
assistant Added a comment: Diagnosing local pairing issues. 2018-07-30 18:54:56 +00:00
automatic_conflict_resolution
backends Added a comment 2018-09-19 16:50:05 +00:00
bare_repositories
benchmarking close bug; copy benchmarking info to new page 2017-10-31 13:13:40 -04:00
bugs Support newlines in filenames. 2018-09-20 13:45:44 -04:00
coding_style
contribute
copies
design Added a comment 2018-09-19 18:19:22 +00:00
devblog devblog 2018-09-13 15:50:16 -04:00
direct_mode Added a comment 2018-09-19 19:12:58 +00:00
download
ekg
encryption Added a comment: headless configs 2018-05-17 21:02:32 +00:00
footer
forum Added a comment 2018-09-19 11:40:57 +00:00
future_proofing
git-annex-add Added a comment: Sounds great! 2018-05-21 18:09:35 +00:00
git-annex-addurl response 2018-05-30 12:31:24 -04:00
git-annex-adjust answer 2017-11-07 16:22:25 -04:00
git-annex-checkpresentkey Added a comment 2018-09-19 17:40:16 +00:00
git-annex-config response 2018-03-06 13:40:00 -04:00
git-annex-copy
git-annex-direct
git-annex-drop Added a comment: re: drop everything but subdirectory 2018-09-07 20:13:03 +00:00
git-annex-enableremote
git-annex-importfeed
git-annex-metadata comment 2018-09-11 12:35:20 -04:00
git-annex-move Added a comment: 3rd party "mover" / speed up git annex move 2018-09-17 12:16:08 +00:00
git-annex-preferred-content
git-annex-reinject
git-annex-rmurl Added a comment 2018-09-19 03:40:06 +00:00
git-annex-sync Added a comment: when push fails due to non-fast-forward merge, pull and retry? 2018-09-12 17:56:41 +00:00
git-annex-unannex
git-annex-undo
git-annex-unused
git-annex-whereis Added a comment 2018-09-19 18:57:14 +00:00
how_it_works
install Added a comment: Cannot upgrade to v6 2018-09-15 10:20:58 +00:00
internals Added a comment 2018-09-19 16:07:45 +00:00
license
links
metadata
news add news item for git-annex 6.20180913 2018-09-13 15:51:37 -04:00
not
polls
preferred_content response 2018-04-04 12:24:32 -04:00
required_content
scalability
security response 2018-09-11 12:49:41 -04:00
special_remotes response 2018-09-11 13:37:28 -04:00
stickers
sync
templates
testimonials
thanks update 2018-08-05 21:37:16 -04:00
tips link to webdav more explicitely 2018-09-06 01:01:04 +00:00
todo better exceptions to annex.security.allow-unverified-downloads 2018-09-19 15:49:57 +00:00
trust
tuning
upgrades
use_case
users blindly adding yarikoptic to authors to show since I think I've not annotated all of the issues properly 2018-07-31 14:23:04 +00:00
videos
walkthrough response 2018-03-02 15:10:51 -04:00
Android.mdwn
assistant.mdwn
automatic_conflict_resolution.mdwn
backends.mdwn comment and clarification 2018-09-11 12:55:31 -04:00
bare_repositories.mdwn
benchmarking.mdwn close bug; copy benchmarking info to new page 2017-10-31 13:13:40 -04:00
bugs.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
builds.mdwn windows autobuilder no longer firewalled 2017-10-16 15:07:51 -04:00
chunking.mdwn
coding_style.mdwn
comments.mdwn
contact.mdwn
contribute.mdwn
copies.mdwn
design.mdwn
devblog.mdwn
direct_mode.mdwn
distributed_version_control.mdwn
download.mdwn
ekg.mdwn
encryption.mdwn
favicon.ico
forum.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
future_proofing.mdwn Fixed typo: "repisitory" 2017-11-02 20:39:05 +00:00
git-annex-add.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-addunused.mdwn
git-annex-addurl.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-adjust.mdwn
git-annex-assistant.mdwn
git-annex-calckey.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-checkpresentkey.mdwn
git-annex-config.mdwn annex.merge-annex-branches 2018-02-22 14:25:32 -04:00
git-annex-contentlocation.mdwn
git-annex-copy.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-dead.mdwn
git-annex-describe.mdwn
git-annex-diffdriver.mdwn improve 2018-02-06 13:45:14 -04:00
git-annex-direct.mdwn
git-annex-drop.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-dropkey.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-dropunused.mdwn
git-annex-edit.mdwn
git-annex-enable-tor.mdwn
git-annex-enableremote.mdwn
git-annex-examinekey.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-expire.mdwn
git-annex-export.mdwn S3 versioning=yes config 2018-08-30 13:45:28 -04:00
git-annex-find.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-findref.mdwn
git-annex-fix.mdwn
git-annex-forget.mdwn
git-annex-fromkey.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-fsck.mdwn document the -A shorthand for --all 2018-04-03 23:12:04 -04:00
git-annex-fuzztest.mdwn
git-annex-get.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-group.mdwn
git-annex-groupwanted.mdwn document that multiple groupwanted are not combined 2018-06-12 12:44:53 -04:00
git-annex-import.mdwn man page link fixes 2018-07-06 12:51:18 -04:00
git-annex-importfeed.mdwn default to not using youtube-dl, for security 2018-06-17 14:51:02 -04:00
git-annex-indirect.mdwn
git-annex-info.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-init.mdwn .noannex file 2017-12-13 14:34:32 -04:00
git-annex-initremote.mdwn
git-annex-inprogress.mdwn document the -A shorthand for --all 2018-04-03 23:12:04 -04:00
git-annex-list.mdwn
git-annex-lock.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-log.mdwn document the -A shorthand for --all 2018-04-03 23:12:04 -04:00
git-annex-lookupkey.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-map.mdwn
git-annex-matchexpression.mdwn
git-annex-matching-options.mdwn Added --accessedwithin matching option. 2018-08-01 15:34:03 -04:00
git-annex-merge.mdwn
git-annex-metadata.mdwn make --batch honor matching options 2018-08-08 12:07:06 -04:00
git-annex-migrate.mdwn
git-annex-mirror.mdwn document the -A shorthand for --all 2018-04-03 23:12:04 -04:00
git-annex-move.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-multicast.mdwn man page link fixes 2018-07-06 12:51:18 -04:00
git-annex-numcopies.mdwn
git-annex-p2p.mdwn add docs about p2p --pair being broken in old versions 2018-07-05 11:52:52 -04:00
git-annex-post-receive.mdwn
git-annex-pre-commit.mdwn
git-annex-preferred-content.mdwn man page link fixes 2018-07-06 12:51:18 -04:00
git-annex-proxy.mdwn
git-annex-readpresentkey.mdwn
git-annex-registerurl.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-reinit.mdwn
git-annex-reinject.mdwn
git-annex-rekey.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-remotedaemon.mdwn
git-annex-repair.mdwn
git-annex-required.mdwn man page link fixes 2018-07-06 12:51:18 -04:00
git-annex-resolvemerge.mdwn
git-annex-rmurl.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex-schedule.mdwn
git-annex-semitrust.mdwn
git-annex-setkey.mdwn
git-annex-setpresentkey.mdwn setpresentkey: Added --batch support (for ronnypfa) 2018-05-27 14:56:14 -04:00
git-annex-shell.mdwn remove todo link 2018-07-06 12:32:58 -04:00
git-annex-smudge.mdwn
git-annex-status.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-sync.mdwn document the -A shorthand for --all 2018-04-03 23:12:04 -04:00
git-annex-test.mdwn add links 2017-11-09 11:34:53 -04:00
git-annex-testremote.mdwn add links 2017-11-09 11:34:53 -04:00
git-annex-transferkey.mdwn
git-annex-transferkeys.mdwn
git-annex-trust.mdwn
git-annex-unannex.mdwn
git-annex-undo.mdwn
git-annex-ungroup.mdwn
git-annex-uninit.mdwn
git-annex-unlock.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-untrust.mdwn
git-annex-unused.mdwn unused --from: Allow specifiying a repository by uuid or description. 2018-07-11 16:01:35 -04:00
git-annex-upgrade.mdwn
git-annex-vadd.mdwn
git-annex-vcycle.mdwn
git-annex-version.mdwn
git-annex-vfilter.mdwn
git-annex-vicfg.mdwn
git-annex-view.mdwn
git-annex-vpop.mdwn
git-annex-wanted.mdwn
git-annex-watch.mdwn
git-annex-webapp.mdwn
git-annex-whereis.mdwn added -z 2018-09-20 16:11:47 -04:00
git-annex.mdwn response 2018-09-12 15:31:03 -04:00
git-remote-tor-annex.mdwn
git-union-merge.mdwn
how_it_works.mdwn
index.mdwn
install.mdwn Add Guix to the installation instructions, as there is now package available! 2018-06-01 14:38:16 +00:00
internals.mdwn per-remote metadata storage 2018-08-31 12:23:22 -04:00
license.mdwn
location_tracking.mdwn
logo-old-bw.svg
logo-old.png
logo-old.svg
logo-old_small.png
logo.mdwn
logo.svg
logo_16x16.png
logo_32x32.png
logo_small.png
meta.mdwn
metadata.mdwn
news.mdwn add security page with current and past security holes 2018-06-18 14:19:58 -04:00
not.mdwn Update boar link 2018-01-12 01:15:23 +00:00
polls.mdwn
preferred_content.mdwn
privacy.mdwn
publicrepos.mdwn we grew up to over 50TB 2018-09-14 02:53:11 +00:00
related_software.mdwn Add AnnexRemote to the list 2018-07-31 13:44:27 +00:00
repomap.png
required_content.mdwn fsck: Warn when required content is not present in the repository that requires it. 2018-02-08 14:08:41 -04:00
scalability.mdwn
security.mdwn add security page with current and past security holes 2018-06-18 14:19:58 -04:00
shortcuts.mdwn
sidebar.mdwn
sitemap.mdwn
special_remotes.mdwn create an rclone page, since that's actually a thing 2018-09-06 00:54:40 +00:00
stickers.mdwn
submodules.mdwn
summary.mdwn
sync.mdwn
testimonials.mdwn
thanks.mdwn updates 2018-01-02 16:28:33 -04:00
tips.mdwn
todo.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
transferring_data.mdwn
trust.mdwn
tuning.mdwn
upgrades.mdwn remove broken link 2018-06-15 17:53:37 -04:00
users.mdwn
videos.mdwn
Void.mdwn
walkthrough.mdwn
workflow.mdwn