.\" .\" .\" .\" Title: maildirkw .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.74.0 .\" Date: 05/10/2009 .\" Manual: Double Precision, Inc. .\" Source: Double Precision, Inc. .\" Language: English .\" .TH "MAILDIRKW" "1" "05/10/2009" "Double Precision, Inc." "Double Precision, Inc." .\" ----------------------------------------------------------------- .\" * (re)Define some macros .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" toupper - uppercase a string (locale-aware) .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de toupper .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ \\$* .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SH-xref - format a cross-reference to an SH section .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de SH-xref .ie n \{\ .\} .toupper \\$* .el \{\ \\$* .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SH - level-one heading that works better for non-TTY output .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de1 SH .\" put an extra blank line of space above the head in non-TTY output .if t \{\ .sp 1 .\} .sp \\n[PD]u .nr an-level 1 .set-an-margin .nr an-prevailing-indent \\n[IN] .fi .in \\n[an-margin]u .ti 0 .HTML-TAG ".NH \\n[an-level]" .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 \." make the size of the head bigger .ps +3 .ft B .ne (2v + 1u) .ie n \{\ .\" if n (TTY output), use uppercase .toupper \\$* .\} .el \{\ .nr an-break-flag 0 .\" if not n (not TTY), use normal case (not uppercase) \\$1 .in \\n[an-margin]u .ti 0 .\" if not n (not TTY), put a border/line under subheading .sp -.6 \l'\n(.lu' .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SS - level-two heading that works better for non-TTY output .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de1 SS .sp \\n[PD]u .nr an-level 1 .set-an-margin .nr an-prevailing-indent \\n[IN] .fi .in \\n[IN]u .ti \\n[SN]u .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .ps \\n[PS-SS]u \." make the size of the head bigger .ps +2 .ft B .ne (2v + 1u) .if \\n[.$] \&\\$* .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" BB/BE - put background/screen (filled box) around block of text .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de BB .if t \{\ .sp -.5 .br .in +2n .ll -2n .gcolor red .di BX .\} .. .de EB .if t \{\ .if "\\$2"adjust-for-leading-newline" \{\ .sp -1 .\} .br .di .in .ll .gcolor .nr BW \\n(.lu-\\n(.i .nr BH \\n(dn+.5v .ne \\n(BHu+.5v .ie "\\$2"adjust-for-leading-newline" \{\ \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] .\} .el \{\ \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] .\} .in 0 .sp -.5v .nf .BX .in .sp .5v .fi .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" BM/EM - put colored marker in margin next to block of text .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de BM .if t \{\ .br .ll -2n .gcolor red .di BX .\} .. .de EM .if t \{\ .br .di .ll .gcolor .nr BH \\n(dn .ne \\n(BHu \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] .in 0 .nf .BX .in .fi .\} .. .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "Name" maildirkw \- set maildir message keywords .SH "Synopsis" .fam C .HP \w'\fBmaildirkw\fR\ 'u \fBmaildirkw\fR [\-c] [\-l] [\-a] [\-r] {\fImaildir\fR} {\fImessage\fR} [\fIkeyword\fR...] .fam .fam C .HP \w'\fBmaildirkw\fR\ 'u \fBmaildirkw\fR [\-c] {\-L} {\fImaildir\fR} .fam .SH "DESCRIPTION" .PP \fBmaildirkw\fR modifies the Courier IMAP server compatible maildir message keywords\&. This command allows an easy way to set or clear custom IMAP keywords associated with a particular message\&. \fImaildir\fR is the pathname to a maildir, or a maildir folder\&. The \fB\-L\fR option lists all messages in the maildir, and their associated keywords\&. \fImessage\fR specified which message\'s keywords should be set\&. One or more \fIkeyword\fRs specifies a list of keywords to be set for this message\&. The specified list of \fIkeyword\fRs replaces any keywords presently set for the \fImessage\fR, unless the \fB\-a\fR or the \fB\-r\fR option is specified\&. .PP The \fB\-a\fR option adds the \fIkeyword\fR to existing keywords that are set for \fImessage\fR\&. The \fB\-r\fR removes \fIkeyword\fRs from \fImessage\fR, leaving any remaining keywords set in place\&. .PP The \fB\-l\fR should be used if the Courier IMAP server\'s configuration file has the \FCIMAP_USELOCKS\F[] option set\&. \fB\-l\fR enables a compatible locking mechanism to update the message\'s keywords\&. .PP \fB\-c\fR enables case\-sensitive keywords\&. IMAP keywords are normally case insensitive\&. \fB\-c\fR needs to be used if the \m[blue]\fBSMAP1\fR\m[]\&\s-2\u[1]\d\s+2 protocol extension is used, which uses case sensitive keywords\&. .SH "SEE ALSO" .PP \m[blue]\fB\fBmaildiracl\fR(1)\fR\m[]\&\s-2\u[2]\d\s+2, \m[blue]\fB\fBmaildirmake\fR(1)\fR\m[]\&\s-2\u[3]\d\s+2\&. .SH "Notes" .IP " 1." 4 SMAP1 .RS 4 \%http://www.courier-mta.org/cone/smap1.html .RE .IP " 2." 4 \fBmaildiracl\fR(1) .RS 4 \%[set $man.base.url.for.relative.links]/maildiracl.html .RE .IP " 3." 4 \fBmaildirmake\fR(1) .RS 4 \%[set $man.base.url.for.relative.links]/maildirmake.html .RE