abduco

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | LICENSE

commit 0ca1a36cbce7785e607300b70cfbab1f58fbc24f
parent ba2e6a424849e171d6ca6eb6a3ed36c6fd01cec3
Author: Marc André Tanner <mat@brain-dump.org>
Date:   Fri, 20 Jun 2014 13:24:57 +0200

Man page tweaks

Diffstat:
abduco.1 | 52+++++++++++++++++++++++++++++++++++++---------------
1 file changed, 37 insertions(+), 15 deletions(-)

diff --git a/abduco.1 b/abduco.1 @@ -4,33 +4,33 @@ abduco .SH SYNOPSIS .B abduco -.RB [ \-e +.RB [ \-e .IR detachkey ] -.RB \-c +.RB \-c .RB name .RB command .RI [ args \ ... "" ] .br .B abduco .RB [ \-r ] -.RB [ \-e +.RB [ \-e .IR detachkey ] -.RB \-n +.RB \-n .RB name .RB command .RI [ args \ ... "" ] .br .B abduco -.RB [ \-e +.RB [ \-e .IR detachkey ] -.RB \-A +.RB \-A .RB name .RB command .RI [ args \ ... "" ] .br .B abduco .RB [ \-r ] -.RB [ \-e +.RB [ \-e .IR detachkey ] .RB \-a .RB name @@ -38,18 +38,18 @@ abduco .SH DESCRIPTION .B abduco provides a way to disconnect a given application from its controlling -terminal thus it provides roughly the same session attach/detach support as +terminal, thus it provides roughly the same session attach/detach support as .BR screen(1) , " tmux(1)" " or" " dtach(1)". If the .BR command to execute is not specified, the environment variable .BR $ABDUCO_CMD -is checked, if it is not set +is examined, if it is not set .BR dvtm(1) is executed. -By default all session related information is stored in +By default all session related information is stored in .B $HOME/.abduco with .BR $TMPDIR/.abduco @@ -57,9 +57,8 @@ as a fallback and .BR /tmp/.abduco as a last resort. -However if a given session name starts either with a dot or a forward slash -it is interpreted as a path name and used unmodified i.e. relatively to the -current working directory. +However if a given session name represents either a relative or absolute path +it is used unmodified. If for some reason the .BR unix(7) @@ -72,12 +71,16 @@ printed sorted by their respective creation date. Lines starting with an asterik .BR * indicate that at least one client is connected. +A plus sign +.BR + +indicates that the cmd terminated while no client was connected, attach +to get its exit status. .TP .B \-v Print version information to standard output and exit. .TP .B \-r -Readonly session, i.e. no user input is ignored. +Readonly session, i.e. user input is ignored. .TP .BI \-e \ detachkey Set the key to detach which by default is set to CTRL+\\ i.e. ^\\ to detachkey. @@ -91,7 +94,26 @@ Create a new session but do not attach to it. .BI \-A Try to connect to an existing session, upon failure create said session and attach immediately to it. .TP -.BI \-a +.BI \-a Attach to an existing session. +.SH EXAMPLE +Start a new session (assuming +.BR dvtm(1) +is in +.BR $PATH ) +with +.nf + +.B abduco -c my-session + +.fi +do some work, then detach by pressing +.B CTRL+\e +and later reattach with +.nf + +.B abduco -a my-session + +.fi .SH AUTHOR abduco is written by Marc André Tanner <mat at brain-dump.org>