From 56a7d1dad83bfa4ccb194fbe27c7cfbd6cd5387f Mon Sep 17 00:00:00 2001 From: "pellman.john@e59e5c6d98d49cd9632d6fbe0c5026ddc71d52fd" Date: Wed, 6 Feb 2019 20:53:00 +0000 Subject: [PATCH] Added a comment: Inconsistent idiom --- ..._46e1b62d37619521a60eb2339b8d094f._comment | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 doc/git-annex-addurl/comment_3_46e1b62d37619521a60eb2339b8d094f._comment diff --git a/doc/git-annex-addurl/comment_3_46e1b62d37619521a60eb2339b8d094f._comment b/doc/git-annex-addurl/comment_3_46e1b62d37619521a60eb2339b8d094f._comment new file mode 100644 index 0000000000..a5e3827b24 --- /dev/null +++ b/doc/git-annex-addurl/comment_3_46e1b62d37619521a60eb2339b8d094f._comment @@ -0,0 +1,21 @@ +[[!comment format=mdwn + username="pellman.john@e59e5c6d98d49cd9632d6fbe0c5026ddc71d52fd" + nickname="pellman.john" + avatar="http://cdn.libravatar.org/avatar/eaca2e5f6d5888d139129293c7293b1f" + subject="Inconsistent idiom" + date="2019-02-06T20:53:00Z" + content=""" +In using git-annex in the past, I've always found it counterintuitive that [rmurl](https://git-annex.branchable.com/git-annex-rmurl/) uses the following form to remove a URL from a file: + +``` +git annex rmurl [file] [url] +``` + +While, in contrast, addurl uses a flag to designate the file that a URL should be added to the list of URLs a file points to: + +``` +git annex addurl [url] --file=[file] +``` + +It would make sense (at least to me) to make the syntax for these more congruous so that both commands use either two positional arguments or one positional argument and one keyword argument / flag. +"""]]