Project

General

Profile

Backlogs error: Couldn't find RbRelease with 'id'=69 (ActiveRecord::RecordNotFound)
Actions

Story #19939

open

Fully document, illustrate how to use arv-mount --exec

Added by Brett Smith almost 2 years ago. Updated almost 2 years ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
Documentation
Target version:
-
Start date:
Due date:
% Done:

0%

Estimated time:

Description

There's nothing in our documentation that actually tells you how to use arv-mount --exec. Some of arv-mount --help sort of hints at it, and you can figure it out if you're very familiar with the underlying conventions, but we can do better.

  • Consider writing our own usage line(s) for arv-mount, rather than relying on the one generated by argparse. There are so many options that the generated one is unhelpfully long anyway. One should illustrate how to use arv-mount --exec. Others can illustrate other common operation modes.
  • The help string for --exec should specify:
    • It reads the command as multiple arguments, until it reaches the end of arguments or --.
    • The command is not run through the shell. (This is important because it means your command can't use shell constructs, globs, etc.)
  • If possible without writing new code, write a metavar for --exec that better illustrates that multiple arguments are used. There was a previous attempt at this (metavar is a tuple) but it doesn't work as intended, it just gets rendered as ....
  • There should be no need for epilog text after these changes. We shouldn't expect users to read documentation in two places to learn how to use one feature.
  • Add a section to doc/user/tutorials/tutorial-keep-mount-gnu-linux.html that illustrates how to use arv-mount --exec with a basic example.

Related issues 1 (1 open0 closed)

Related to Arvados - Bug #8294: [FUSE] arv-mount usage message shows incorrect order for [--exec ...] optionNew01/26/2016

Actions
Actions

Also available in: Atom PDF