--- rxvt-unicode/doc/rxvtc.1.man.in 2006/02/02 00:24:14 1.3 +++ rxvt-unicode/doc/rxvtc.1.man.in 2014/12/31 14:12:44 1.20 @@ -1,15 +1,7 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp @@ -25,11 +17,11 @@ .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- @@ -48,22 +40,25 @@ . ds R" '' 'br\} .\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" .\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. -.if \nF \{\ +.ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na +.el \{\ +. de IX +.. +.\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -128,8 +123,12 @@ .rm #[ #] #H #V #F C .\" ======================================================================== .\" -.IX Title "rxvt 1" -.TH rxvt 1 "2006-02-02" "7.5" "RXVT-UNICODE" +.IX Title "@@RXVT_NAME@@ 1" +.TH @@RXVT_NAME@@ 1 "2014-12-31" "@@RXVT_VERSION@@" "RXVT-UNICODE" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh .SH "NAME" @@RXVT_NAME@@c \- control the @@RXVT_NAME@@d daemon .SH "SYNOPSIS" @@ -144,10 +143,14 @@ contacting the daemon. .SH "OPTIONS" .IX Header "OPTIONS" +If the first option is \fB\-k\fR, \fB@@RXVT_NAME@@c\fR tries to kill the +daemon process and returns. +.PP All options that are valid for \fB@@RXVT_NAME@@\fR are valid for -\&\fB@@RXVT_NAME@@c\fR, too. Please note that all options are currently -interpreted in the context of the daemon process, which makes a difference -for options that specify a file descriptor (such as \fB\-pty\-fd\fR). +\&\fB@@RXVT_NAME@@c\fR, too. Please note that options are interpreted in the +context of the daemon process. However, as current working directory, +process environment and any file descriptor (e.g. for \f(CW\*(C`\-pty\-fd\*(C'\fR) are +preserved, this rarely makes a difference. .SH "EXIT STATUS" .IX Header "EXIT STATUS" If everything went well, @@RXVT_NAME@@c returns with an exit status of \f(CW0\fR. @@ -156,7 +159,16 @@ .PP This can be used to implement auto-starting behaviour, by checking for an exit status of \f(CW2\fR, running \f(CW\*(C`@@RXVT_NAME@@d \-f \-q\*(C'\fR and retrying the call -to @@RXVT_NAME@@c. +to @@RXVT_NAME@@c, like this: +.PP +.Vb 6 +\& #!/bin/sh +\& @@RXVT_NAME@@c "$@" +\& if [ $? \-eq 2 ]; then +\& @@RXVT_NAME@@d \-q \-o \-f +\& @@RXVT_NAME@@c "$@" +\& fi +.Ve .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" All environment variables of the current process will be made available @@ -167,7 +179,7 @@ Both @@RXVT_NAME@@c and @@RXVT_NAME@@d use the environment variable \&\fI\s-1RXVT_SOCKET\s0\fR to create a listening socket and to contact the @@RXVT_NAME@@d, respectively. If the variable is missing, -\&\fI$HOME/.rxvt\-unicode\-\fI\fI\fR is used. The variable must +\&\fI\f(CI$HOME\fI/.urxvt/urxvtd\-\fI\fI\fR is used. The variable must specify the absolute path of the socket to create. .SH "SEE ALSO" .IX Header "SEE ALSO"