Commit df43fea6 df43fea6439faa22f300489417d5cc6ea2113a8a by Wojciech Polak

Updated and fixed.

1 parent 4d8a689e
...@@ -476,9 +476,9 @@ The program uses following option groups: @xref{mailbox}. ...@@ -476,9 +476,9 @@ The program uses following option groups: @xref{mailbox}.
476 The following command line options alter the behavior of the program: 476 The following command line options alter the behavior of the program:
477 477
478 @table @option 478 @table @option
479 @item -f STRING 479 @item -f @var{string}
480 @itemx --field STRING 480 @itemx --field @var{string}
481 Display the header named by @var{STRING} instead of @code{From} @code{Subject} pair. 481 Display the header named by @var{string} instead of @code{From} @code{Subject} pair.
482 @item -l 482 @item -l
483 @itemx --to 483 @itemx --to
484 Include the contents of @code{To} header to the output. The output field 484 Include the contents of @code{To} header to the output. The output field
...@@ -497,12 +497,12 @@ Print a message only if there are unread messages in the mailbox. ...@@ -497,12 +497,12 @@ Print a message only if there are unread messages in the mailbox.
497 @item -S 497 @item -S
498 @itemx --summary 498 @itemx --summary
499 Print a summary line. 499 Print a summary line.
500 @item -s ATTR 500 @item -s @var{attr}
501 @itemx --status ATTR 501 @itemx --status @var{atrr}
502 Only display headers from messages with the given status. 502 Only display headers from messages with the given status.
503 @var{ATTR} may be one of the following: @samp{new}, @samp{read}, 503 @var{Attr} may be one of the following: @samp{new}, @samp{read},
504 @samp{unread}. It is sufficient to specify only first letter of 504 @samp{unread}. It is sufficient to specify only first letter of
505 an @var{ATTR}. Multiple @option{-s} options are allowed. 505 an @var{attr}. Multiple @option{-s} options are allowed.
506 @item -t 506 @item -t
507 @itemx --align 507 @itemx --align
508 Tidy mode. Currently is not implemented. Included for compatibility with 508 Tidy mode. Currently is not implemented. Included for compatibility with
...@@ -545,11 +545,11 @@ detail, see @ref{Reading Mail}. ...@@ -545,11 +545,11 @@ detail, see @ref{Reading Mail}.
545 General usage of @command{mail} program is: 545 General usage of @command{mail} program is:
546 546
547 @smallexample 547 @smallexample
548 mail [OPTION...] [address...] 548 mail [@var{option}...] [@var{address}...]
549 @end smallexample 549 @end smallexample
550 @noindent 550 @noindent
551 If [address...] part is present, @command{mail} switches to mail sending 551 If [@var{address}...] part is present, @command{mail} switches to
552 mode, otherwise it operates in mail reading mode. 552 mail sending mode, otherwise it operates in mail reading mode.
553 553
554 The program uses following option groups: @xref{mailbox}. 554 The program uses following option groups: @xref{mailbox}.
555 555
...@@ -561,9 +561,9 @@ The program uses following option groups: @xref{mailbox}. ...@@ -561,9 +561,9 @@ The program uses following option groups: @xref{mailbox}.
561 Return true if the mailbox contains some messages. Return false 561 Return true if the mailbox contains some messages. Return false
562 otherwise. 562 otherwise.
563 This is useful for writing shell scripts. 563 This is useful for writing shell scripts.
564 @item -f[FILE] 564 @item -f[@var{file}]
565 @itemx --file[=FILE] 565 @itemx --file[=@var{file}]
566 Operate on mailbox @var{FILE}. If this option is not specified, the default 566 Operate on mailbox @var{file}. If this option is not specified, the default
567 is user's system mailbox. If it is specified without argument, the 567 is user's system mailbox. If it is specified without argument, the
568 default is @file{$HOME/mbox}. 568 default is @file{$HOME/mbox}.
569 @emph{Please note}, that there should be no whitespace between the 569 @emph{Please note}, that there should be no whitespace between the
...@@ -603,18 +603,18 @@ quit ...@@ -603,18 +603,18 @@ quit
603 @item -q 603 @item -q
604 @itemx --quit 604 @itemx --quit
605 Cause interrupts to terminate program. 605 Cause interrupts to terminate program.
606 @item -s SUBJ 606 @item -s @var{subj}
607 @itemx --subject=SUBJ 607 @itemx --subject=@var{subj}
608 Send a message with a Subject of @var{SUBJ}. Valid only in sending mode. 608 Send a message with a Subject of @var{subj}. Valid only in sending mode.
609 @item -t 609 @item -t
610 @itemx --to 610 @itemx --to
611 Switch to sending mode. 611 Switch to sending mode.
612 @item -u USER 612 @item -u @var{user}
613 @itemx --user=USER 613 @itemx --user=@var{user}
614 Operate on @var{USER}'s mailbox. This is equivalent to: 614 Operate on @var{user}'s mailbox. This is equivalent to:
615 615
616 @smallexample 616 @smallexample
617 mail -f/@var{spool_path}/USER 617 mail -f/@var{spool_path}/@var{user}
618 @end smallexample 618 @end smallexample
619 619
620 @noindent 620 @noindent
...@@ -721,7 +721,6 @@ thus allowing for operating upon multiply-encoded messages. ...@@ -721,7 +721,6 @@ thus allowing for operating upon multiply-encoded messages.
721 721
722 The following are the examples of valid message lists: 722 The following are the examples of valid message lists:
723 723
724
725 @node Composing Mail 724 @node Composing Mail
726 @subsection Composing Mail 725 @subsection Composing Mail
727 726
...@@ -1302,20 +1301,20 @@ Edits each message in @var{msglist} with the editor, specified in ...@@ -1302,20 +1301,20 @@ Edits each message in @var{msglist} with the editor, specified in
1302 @subsubheading Aliasing 1301 @subsubheading Aliasing
1303 1302
1304 @table @samp 1303 @table @samp
1305 @item alias [alias [address...]] 1304 @item alias [alias [@var{address}...]]
1306 @itemx a [alias [address...]] 1305 @itemx a [alias [@var{address}...]]
1307 @itemx group [alias [address...]] 1306 @itemx group [alias [@var{address}...]]
1308 @itemx g [alias [address...]] 1307 @itemx g [alias [@var{address}...]]
1309 With no arguments, prints out all currently-defined aliases. 1308 With no arguments, prints out all currently-defined aliases.
1310 With one argument, prints out that alias. 1309 With one argument, prints out that alias.
1311 With more than one argument, creates a new alias or changes an old one. 1310 With more than one argument, creates a new alias or changes an old one.
1312 @item unalias [alias...] 1311 @item unalias [@var{alias}...]
1313 @itemx una [alias...] 1312 @itemx una [@var{alias}...]
1314 Takes a list of names defined by alias commands and discards the 1313 Takes a list of names defined by alias commands and discards the
1315 remembered groups of users. The alias names no longer have any 1314 remembered groups of users. The alias names no longer have any
1316 significance. 1315 significance.
1317 @item alternates name... 1316 @item alternates @var{name}...
1318 @itemx alt name... 1317 @itemx alt @var{name}...
1319 The alternates command is useful if you have accounts on several 1318 The alternates command is useful if you have accounts on several
1320 machines. It can be used to inform mail that the listed addresses are 1319 machines. It can be used to inform mail that the listed addresses are
1321 really you. When you reply to messages, mail will not send a copy of 1320 really you. When you reply to messages, mail will not send a copy of
...@@ -1328,8 +1327,8 @@ alternate names is displayed. ...@@ -1328,8 +1327,8 @@ alternate names is displayed.
1328 @subsubheading Replying 1327 @subsubheading Replying
1329 1328
1330 @table @samp 1329 @table @samp
1331 @item mail [address...] 1330 @item mail [@var{address}...]
1332 @itemx m [address...] 1331 @itemx m [@var{address}...]
1333 Switches to compose mode. After composing the message, sends messages to 1332 Switches to compose mode. After composing the message, sends messages to
1334 the specified addresses. 1333 the specified addresses.
1335 1334
...@@ -1918,8 +1917,8 @@ by default only the first one is presented. ...@@ -1918,8 +1917,8 @@ by default only the first one is presented.
1918 @itemx --debug 1917 @itemx --debug
1919 Display mailbox debugging information. 1918 Display mailbox debugging information.
1920 1919
1921 @item -f @var{MAILBOX} 1920 @item -f @var{mailbox}
1922 @itemx --folder=@var{MAILBOX} 1921 @itemx --folder=@var{mailbox}
1923 Specified the default mailbox. 1922 Specified the default mailbox.
1924 1923
1925 @item -h 1924 @item -h
...@@ -2123,7 +2122,7 @@ following search paths (in the order given): ...@@ -2123,7 +2122,7 @@ following search paths (in the order given):
2123 @item Mailutils module directory. By default it is 2122 @item Mailutils module directory. By default it is
2124 @file{$prefix/lib/mailutils}. 2123 @file{$prefix/lib/mailutils}.
2125 2124
2126 @item The value of the environment variable LTDL_LIBRARY_PATH. 2125 @item The value of the environment variable @env{LTDL_LIBRARY_PATH}.
2127 2126
2128 @item Additional search directories specified with the 2127 @item Additional search directories specified with the
2129 @code{#searchpath} directive. 2128 @code{#searchpath} directive.
...@@ -2131,12 +2130,11 @@ following search paths (in the order given): ...@@ -2131,12 +2130,11 @@ following search paths (in the order given):
2131 @item System library search path: The system dependent library 2130 @item System library search path: The system dependent library
2132 search path (e.g. on Linux it is set by the contents of the file 2131 search path (e.g. on Linux it is set by the contents of the file
2133 @file{/etc/ld.so.conf} and the value of the environment variable 2132 @file{/etc/ld.so.conf} and the value of the environment variable
2134 LD_LIBRARY_PATH). 2133 @env{LD_LIBRARY_PATH}).
2135
2136 @end enumerate 2134 @end enumerate
2137 2135
2138 The value of LTDL_LIBRARY_PATH and LD_LIBRARY_PATH must be a 2136 The value of @env{LTDL_LIBRARY_PATH} and @env{LD_LIBRARY_PATH} must be
2139 colon-separated list of absolute directories, for example, 2137 a colon-separated list of absolute directories, for example,
2140 @samp{"/usr/lib/mypkg:/lib/foo"}. 2138 @samp{"/usr/lib/mypkg:/lib/foo"}.
2141 2139
2142 In any of these directories, @command{sieve} first attempts to find 2140 In any of these directories, @command{sieve} first attempts to find
...@@ -2264,10 +2262,10 @@ scheme program saves it. ...@@ -2264,10 +2262,10 @@ scheme program saves it.
2264 @item guimb [@var{options}] --mailbox @var{defmbox} 2262 @item guimb [@var{options}] --mailbox @var{defmbox}
2265 The contents of @var{defmbox} is processed and is replaced with the resulting 2263 The contents of @var{defmbox} is processed and is replaced with the resulting
2266 mailbox contents. Useful for applying filters to user's mailbox. 2264 mailbox contents. Useful for applying filters to user's mailbox.
2267 @item guimb [@var{options}] --mailbox @var{defmbox} mailbox [mailbox...] 2265 @item guimb [@var{options}] --mailbox @var{defmbox} @var{mailbox} [@var{mailbox}...]
2268 The contents of specified mailboxes is processed, and the resulting 2266 The contents of specified mailboxes is processed, and the resulting
2269 mailbox contents is appended to @var{defmbox}. 2267 mailbox contents is appended to @var{defmbox}.
2270 @item guimb [@var{options}] --user @var{username} [mailbox...] 2268 @item guimb [@var{options}] --user @var{username} [@var{mailbox}...]
2271 The contents of specified mailboxes is processed, and the resulting 2269 The contents of specified mailboxes is processed, and the resulting
2272 mailbox contents is appended to the user's system mailbox. This allows 2270 mailbox contents is appended to the user's system mailbox. This allows
2273 to use @command{guimb} as a mail delivery agent. 2271 to use @command{guimb} as a mail delivery agent.
...@@ -2302,7 +2300,7 @@ the additional arguments may be passed to the Scheme program @option{-g} ...@@ -2302,7 +2300,7 @@ the additional arguments may be passed to the Scheme program @option{-g}
2302 (@option{--guile-arg}) command line option. For example: 2300 (@option{--guile-arg}) command line option. For example:
2303 2301
2304 @smallexample 2302 @smallexample
2305 guimb --guile-arg -opt --guile-arg 24 --file progfile 2303 guimb --guile-arg -opt --guile-arg 24 --file @var{progfile}
2306 @end smallexample 2304 @end smallexample
2307 2305
2308 In this example, the scheme procedure will see the following command line: 2306 In this example, the scheme procedure will see the following command line:
...@@ -2315,7 +2313,7 @@ Finally, if there are many arguments to be passed to Scheme, it is more ...@@ -2315,7 +2313,7 @@ Finally, if there are many arguments to be passed to Scheme, it is more
2315 convenient to enclose them in @option{-@{} and @option{-@}} escapes: 2313 convenient to enclose them in @option{-@{} and @option{-@}} escapes:
2316 2314
2317 @smallexample 2315 @smallexample
2318 guimb -@{ -opt 24 -@} --file progfile 2316 guimb -@{ -opt 24 -@} --file @var{progfile}
2319 @end smallexample 2317 @end smallexample
2320 2318
2321 @node Command Line Option Summary 2319 @node Command Line Option Summary
...@@ -2328,27 +2326,27 @@ This is a short summary of the command line options available to ...@@ -2328,27 +2326,27 @@ This is a short summary of the command line options available to
2328 @item -d 2326 @item -d
2329 @itemx --debug 2327 @itemx --debug
2330 Start with debugging evaluator and backtraces. 2328 Start with debugging evaluator and backtraces.
2331 @item -e EXPR 2329 @item -e @var{expr}
2332 @itemx --expression EXPR 2330 @itemx --expression @var{expr}
2333 Execute given Scheme expression. 2331 Execute given Scheme expression.
2334 @item -m @var{path} 2332 @item -m @var{path}
2335 @itemx --mail-spool=@var{path} 2333 @itemx --mail-spool=@var{path}
2336 Set path to the mailspool directory 2334 Set path to the mailspool directory
2337 @item -f PROGFILE 2335 @item -f @var{progfile}
2338 @itemx --file PROGFILE 2336 @itemx --file @var{progfile}
2339 Read Scheme program from @var{PROGFILE}. 2337 Read Scheme program from @var{progfile}.
2340 @item -g ARG 2338 @item -g @var{arg}
2341 @itemx --guile-command ARG 2339 @itemx --guile-command @var{arg}
2342 Append @var{ARG} to the command line passed to Scheme program. 2340 Append @var{arg} to the command line passed to Scheme program.
2343 @item -@{ ... -@} 2341 @item -@{ ... -@}
2344 Pass all command line options enclosed between @option{-@{} and @option{-@}} 2342 Pass all command line options enclosed between @option{-@{} and @option{-@}}
2345 to Scheme program. 2343 to Scheme program.
2346 @item -m 2344 @item -m
2347 @itemx --mailbox MBOX 2345 @itemx --mailbox @var{mbox}
2348 Set default mailbox name. 2346 Set default mailbox name.
2349 @item -u 2347 @item -u
2350 @itemx --user NAME 2348 @itemx --user @var{name}
2351 Act as local MDA for user @var{NAME}. 2349 Act as local MDA for user @var{name}.
2352 @item -h 2350 @item -h
2353 @itemx --help 2351 @itemx --help
2354 Display help message. 2352 Display help message.
...@@ -2379,13 +2377,12 @@ and appends the received data to the local mailboxes. ...@@ -2379,13 +2377,12 @@ and appends the received data to the local mailboxes.
2379 General usage of @command{mail.local} program is: 2377 General usage of @command{mail.local} program is:
2380 2378
2381 @smallexample 2379 @smallexample
2382 mail.local [OPTION...] recipient [recipient ...] 2380 mail.local [@var{option}...] @var{recipient} [@var{recipient} ...]
2383 @end smallexample 2381 @end smallexample
2384 2382
2385 @noindent 2383 @noindent
2386 If recipient part is present is a FQDN, @command{mail.local} 2384 If recipient part is present is a FQDN, @command{mail.local}
2387 will attempt to deliver to a virtual host. 2385 will attempt to deliver to a virtual host.
2388
2389 2386
2390 The program uses following option groups: @xref{mailbox}, @xref{auth}, 2387 The program uses following option groups: @xref{mailbox}, @xref{auth},
2391 @xref{logging}, @xref{sieve}. 2388 @xref{logging}, @xref{sieve}.
...@@ -2443,13 +2440,13 @@ Start with guile debugging evaluator and backtraces. This is convenient ...@@ -2443,13 +2440,13 @@ Start with guile debugging evaluator and backtraces. This is convenient
2443 for debugging user-defined filters (@pxref{Scheme Filters}). 2440 for debugging user-defined filters (@pxref{Scheme Filters}).
2444 2441
2445 @item T 2442 @item T
2446 Enable libmailutil traces (MU_DEBUG_TRACE). 2443 Enable libmailutil traces (@code{MU_DEBUG_TRACE}).
2447 2444
2448 @item P 2445 @item P
2449 Enable network protocol traces (MU_DEBUG_PROT) 2446 Enable network protocol traces (@code{MU_DEBUG_PROT})
2450 2447
2451 @item t 2448 @item t
2452 Enable sieve trace (MU_SIEVE_DEBUG_TRACE) 2449 Enable sieve trace (@code{MU_SIEVE_DEBUG_TRACE})
2453 2450
2454 @item l 2451 @item l
2455 Enable sieve action logs 2452 Enable sieve action logs
......