~ubuntu-dev/ubuntu/lucid/mutt/lucid-201002110857 : revision 1.1.10

2

# System configuration file for Mutt

3

#

4

5

# default list of header fields to weed when displaying

6

#

7

ignore "from " received content- mime-version status x-status message-id

8

ignore sender references return-path lines

5

# Default list of header fields to weed when displaying.

6

# Ignore all lines by default...

7

ignore *

8

9

# ... then allow these through.

10

unignore from: subject to cc date x-mailer x-url user-agent

11

12

# Display the fields in this order

13

hdr_order date from to cc subject

9

14

10

15

# imitate the old search-body function

11

16

macro index \eb "<search>~b " "search in message bodies"

33

38

#

34

39

# set use_8bitmime

35

40

41

# Use mime.types to look up handlers for application/octet-stream. Can

42

# be undone with unmime_lookup.

43

mime_lookup application/octet-stream

44

36

45

##

37

46

## *** DEFAULT SETTINGS FOR THE ATTACHMENTS PATCH ***

38

47

##

125

134

# Default: "~/.muttrc"

126

135

#

127

136

#

128

# The default file in which to save aliases created by the

129

# ``create-alias'' function.

137

# The default file in which to save aliases created by the

138

# <create-alias> function. Entries added to this file are

139

# encoded in the character set specified by $config_charset if it

140

# is set or the current character set otherwise.

130

141

#

131

142

# Note: Mutt will not automatically source this file; you must

132

# explicitly use the ``source'' command for it to be executed.

143

# explicitly use the ``source'' command for it to be executed in case

144

# this option points to a dedicated alias file.

133

145

#

134

146

# The default for this option is the currently used muttrc file, or

135

147

# ``~/.muttrc'' if no user muttrc was found.

142

154

# Default: "%4n %2f %t %-10a %r"

143

155

#

144

156

#

145

# Specifies the format of the data displayed for the `alias' menu. The

157

# Specifies the format of the data displayed for the ``alias'' menu. The

146

158

# following printf(3)-style sequences are available:

147

#

148

159

# %a alias name

149

# %f flags - currently, a "d" for an alias marked for deletion

160

# %f flags - currently, a ``d'' for an alias marked for deletion

150

161

# %n index number

151

162

# %r address which alias expands to

152

163

# %t character which indicates if the alias is tagged for inclusion

170

181

# Default: no

171

182

#

172

183

#

173

# Controls whether ANSI color codes in messages (and color tags in

184

# Controls whether ANSI color codes in messages (and color tags in

174

185

# rich text messages) are to be interpreted.

175

186

# Messages containing these codes are rare, but if this option is set,

176

187

# their text will be colored accordingly. Note that this may override

177

188

# your color choices, and even present a security problem, since a

178

# message could include a line like "[-- PGP output follows ..." and

179

# give it the same color as your attachment color.

189

# message could include a line like

190

# [-- PGP output follows ...

191

#

192

# and give it the same color as your attachment color (see also

193

# $crypt_timestamp).

180

194

#

181

195

#

182

196

# set arrow_cursor=no

238

252

# Header field values and message body content without character encoding

239

253

# indication would be assumed that they are written in one of this list.

240

254

# By default, all the header fields and message body without any charset

241

# indication are assumed to be in "us-ascii".

255

# indication are assumed to be in ``us-ascii''.

242

256

#

243

257

# For example, Japanese users might prefer this:

244

#

245

258

# set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"

246

259

#

247

260

# However, only the first content is valid for the message body.

256

269

#

257

270

# This variable is a colon-separated list of character encoding

258

271

# schemes for text file attachments.

259

# If unset, $charset value will be used instead.

272

# If unset, the value of $charset will be used instead.

260

273

# For example, the following configuration would work for Japanese

261

274

# text handling:

262

#

263

275

# set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"

264

276

#

265

# Note: "iso-2022-*" must be put at the head of the value as shown above

266

# if included.

277

# Note: for Japanese users, ``iso-2022-*'' must be put at the head

278

# of the value as shown above if included.

267

279

#

268

280

#

269

281

# set attach_format="%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "

273

285

# Default: "%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "

274

286

#

275

287

#

276

# This variable describes the format of the `attachment' menu. The

277

# following printf-style sequences are understood:

278

#

288

# This variable describes the format of the ``attachment'' menu. The

289

# following printf(3)-style sequences are understood:

279

290

# %C charset

280

# %c requires charset conversion (n or c)

291

# %c requires charset conversion (``n'' or ``c'')

281

292

# %D deleted flag

282

293

# %d description

283

294

# %e MIME content-transfer-encoding

284

295

# %f filename

285

# %I disposition (I=inline, A=attachment)

296

# %I disposition (``I'' for inline, ``A'' for attachment)

286

297

# %m major MIME type

287

298

# %M MIME subtype

288

299

# %n attachment number

289

# %Q "Q", if MIME part qualifies for attachment counting

300

# %Q ``Q'', if MIME part qualifies for attachment counting

290

301

# %s size

291

302

# %t tagged flag

292

303

# %T graphic tree characters

293

304

# %u unlink (=to delete) flag

294

305

# %X number of qualifying MIME parts in this part and its children

295

306

# (please see the ``attachments'' section for possible speed effects)

296

# %>X right justify the rest of the string and pad with character "X"

297

# %|X pad to the end of the line with character "X"

298

# %*X soft-fill with character "X" as pad

299

#

300

#

301

# For an explanation of `soft-fill', see the ``$index_format'' documentation.

307

# %>X right justify the rest of the string and pad with character ``X''

308

# %|X pad to the end of the line with character ``X''

309

# %*X soft-fill with character ``X'' as pad

310

#

311

#

312

# For an explanation of ``soft-fill'', see the $index_format documentation.

302

313

#

303

314

#

304

315

# set attach_sep="\n"

322

333

# If this variable is unset, when operating (saving, printing, piping,

323

334

# etc) on a list of tagged attachments, Mutt will concatenate the

324

335

# attachments and will operate on them as a single attachment. The

325

# ``$attach_sep'' separator is added after each attachment. When set,

336

# $attach_sep separator is added after each attachment. When set,

326

337

# Mutt will operate on the attachments one by one.

327

338

#

328

339

#

334

345

#

335

346

#

336

347

# This is the string that will precede a message which has been included

337

# in a reply. For a full listing of defined printf()-like sequences see

338

# the section on ``$index_format''.

348

# in a reply. For a full listing of defined printf(3)-like sequences see

349

# the section on $index_format.

339

350

#

340

351

#

341

352

# set autoedit=no

345

356

# Default: no

346

357

#

347

358

#

348

# When set along with ``$edit_headers'', Mutt will skip the initial

349

# send-menu and allow you to immediately begin editing the body of your

359

# When set along with $edit_headers, Mutt will skip the initial

360

# send-menu (prompting for subject and recipients) and allow you to

361

# immediately begin editing the body of your

350

362

# message. The send-menu may still be accessed once you have finished

351

363

# editing the body of your message.

352

364

#

353

# Also see ``$fast_reply''.

365

# Also see $fast_reply.

354

366

#

355

367

#

356

368

# set auto_tag=no

362

374

#

363

375

# When set, functions in the index menu which affect a message

364

376

# will be applied to all tagged messages (if there are any). When

365

# unset, you must first use the tag-prefix function (default: ";") to

366

# make the next function apply to all tagged messages.

377

# unset, you must first use the <tag-prefix> function (bound to ``;''

378

# by default) to make the next function apply to all tagged messages.

367

379

#

368

380

#

369

381

# set beep=yes

385

397

#

386

398

# When this variable is set, mutt will beep whenever it prints a message

387

399

# notifying you of new mail. This is independent of the setting of the

388

# ``$beep'' variable.

400

# $beep variable.

389

401

#

390

402

#

391

403

# set bounce=ask-yes

420

432

#

421

433

#

422

434

# When this variable is set, mutt will place the cursor at the beginning

423

# of the current line in menus, even when the arrow_cursor variable

424

# is unset, making it easier for blind persons using Braille displays to

425

# follow these menus. The option is disabled by default because many

435

# of the current line in menus, even when the $arrow_cursor variable

436

# is unset, making it easier for blind persons using Braille displays to

437

# follow these menus. The option is unset by default because many

426

438

# visual terminals don't permit making the cursor invisible.

427

439

#

428

440

#

434

446

#

435

447

#

436

448

# When this variable is set, mutt will use file size attribute instead of

437

# access time when checking for new mail.

449

# access time when checking for new mail in mbox and mmdf folders.

450

#

451

# This variable is unset by default and should only be enabled when

452

# new mail detection for these folder types is unreliable or doesn't work.

453

#

454

# Note that enabling this variable should happen before any ``mailboxes''

455

# directives occur in configuration files regarding mbox or mmdf folders

456

# because mutt needs to determine the initial new mail status of such a

457

# mailbox by performing a fast mailbox scan when it is defined.

458

# Afterwards the new mail status is tracked by file size changes.

438

459

#

439

460

#

440

461

# set charset=""

447

468

# Character set your terminal uses to display and enter textual data.

448

469

# It is also the fallback for $send_charset.

449

470

#

471

# Upon startup Mutt tries to derive this value from environment variables

472

# such as $LC_CTYPE or $LANG.

473

#

474

# Note: It should only be set in case Mutt isn't abled to determine the

475

# character set used correctly.

476

#

450

477

#

451

478

# set check_new=yes

452

479

#

462

489

# mailbox is open. Especially with MH mailboxes, this operation can

463

490

# take quite some time since it involves scanning the directory and

464

491

# checking each file to see if it has already been looked at. If

465

# check_new is unset, no check for new mail is performed

492

# this variable is unset, no check for new mail is performed

466

493

# while the mailbox is open.

467

494

#

468

495

#

495

522

# Default: "-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-"

496

523

#

497

524

#

498

# Controls the format of the status line displayed in the Compose

499

# menu. This string is similar to ``$status_format'', but has its own

500

# set of printf()-like sequences:

501

#

502

# %a total number of attachments

525

# Controls the format of the status line displayed in the ``compose''

526

# menu. This string is similar to $status_format, but has its own

527

# set of printf(3)-like sequences:

528

# %a total number of attachments

503

529

# %h local hostname

504

530

# %l approximate size (in bytes) of the current message

505

531

# %v Mutt version string

506

532

#

507

533

#

508

# See the text describing the ``$status_format'' option for more

509

# information on how to set ``$compose_format''.

534

# See the text describing the $status_format option for more

535

# information on how to set $compose_format.

510

536

#

511

537

#

512

538

# set config_charset=""

517

543

#

518

544

#

519

545

# When defined, Mutt will recode commands in rc files from this

520

# encoding.

546

# encoding to the current character set as specified by $charset

547

# and aliases written to $alias_file from the current character set.

548

#

549

# Please note that if setting $charset it must be done before

550

# setting $config_charset.

551

#

552

# Recoding should be avoided as it may render unconvertable

553

# characters as question marks which can lead to undesired

554

# side effects (for example in regular expressions).

521

555

#

522

556

#

523

557

# set confirmappend=yes

549

583

# Default: 30

550

584

#

551

585

#

552

# Causes Mutt to timeout a network connection (for IMAP or POP) after this

586

# Causes Mutt to timeout a network connection (for IMAP, POP or SMTP) after this

553

587

# many seconds if the connection is not able to be established. A negative

554

# value causes Mutt to wait indefinitely for the connection to succeed.

588

# value causes Mutt to wait indefinitely for the connection attempt to succeed.

555

589

#

556

590

#

557

591

# set content_type="text/plain"

572

606

#

573

607

#

574

608

# This variable controls whether or not copies of your outgoing messages

575

# will be saved for later references. Also see ``$record'',

576

# ``$save_name'', ``$force_name'' and ``fcc-hook''.

609

# will be saved for later references. Also see $record,

610

# $save_name, $force_name and ``fcc-hook''.

577

611

#

578

612

#

579

613

# set crypt_use_gpgme=no

586

620

# This variable controls the use of the GPGME-enabled crypto backends.

587

621

# If it is set and Mutt was built with gpgme support, the gpgme code for

588

622

# S/MIME and PGP will be used instead of the classic code. Note that

589

# you need to set this option in .muttrc; it won't have any effect when

623

# you need to set this option in .muttrc; it won't have any effect when

590

624

# used interactively.

591

625

#

592

626

#

597

631

# Default: no

598

632

#

599

633

#

600

# (http://www.g10code.de/docs/pka-intro.de.pdf) during signature

634

# Controls whether mutt uses PKA

635

# (see http://www.g10code.de/docs/pka-intro.de.pdf) during signature

601

636

# verification (only supported by the GPGME backend).

602

637

#

603

638

#

609

644

#

610

645

#

611

646

# This variable controls whether or not mutt may automatically enable

612

# PGP encryption/signing for messages. See also ``$crypt_autoencrypt'',

613

# ``$crypt_replyencrypt'',

614

# ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''.

647

# PGP encryption/signing for messages. See also $crypt_autoencrypt,

648

# $crypt_replyencrypt,

649

# $crypt_autosign, $crypt_replysign and $smime_is_default.

615

650

#

616

651

#

617

652

# set crypt_autosmime=yes

622

657

#

623

658

#

624

659

# This variable controls whether or not mutt may automatically enable

625

# S/MIME encryption/signing for messages. See also ``$crypt_autoencrypt'',

626

# ``$crypt_replyencrypt'',

627

# ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''.

660

# S/MIME encryption/signing for messages. See also $crypt_autoencrypt,

661

# $crypt_replyencrypt,

662

# $crypt_autosign, $crypt_replysign and $smime_is_default.

628

663

#

629

664

#

630

665

# set date_format="!%a, %b %d, %Y at %I:%M:%S%p %Z"

635

670

#

636

671

#

637

672

# This variable controls the format of the date printed by the ``%d''

638

# sequence in ``$index_format''. This is passed to the strftime

639

# call to process the date. See the man page for strftime(3) for

640

# the proper syntax.

673

# sequence in $index_format. This is passed to the strftime(3)

674

# function to process the date, see the man page for the proper syntax.

641

675

#

642

676

# Unless the first character in the string is a bang (``!''), the month

643

677

# and week day names are expanded according to the locale specified in

644

# the variable ``$locale''. If the first character in the string is a

678

# the variable $locale. If the first character in the string is a

645

679

# bang, the bang is discarded, and the month and week day names in the

646

680

# rest of the string are expanded in the C locale (that is in US

647

681

# English).

654

688

# Default: "~f %s !~P | (~P ~C %s)"

655

689

#

656

690

#

657

# This variable controls how message-hooks, reply-hooks, send-hooks,

658

# send2-hooks, save-hooks, and fcc-hooks will

691

# This variable controls how ``message-hook'', ``reply-hook'', ``send-hook'',

692

# ``send2-hook'', ``save-hook'', and ``fcc-hook'' will

659

693

# be interpreted if they are specified with only a simple regexp,

660

694

# instead of a matching pattern. The hooks are expanded when they are

661

695

# declared, so a hook will be interpreted according to the value of this

662

# variable at the time the hook is declared. The default value matches

696

# variable at the time the hook is declared.

697

#

698

# The default value matches

663

699

# if the message is either from a user matching the regular expression

664

700

# given, or if it is from you (if the from address matches

665

701

# ``alternates'') and is to or cc'ed to a user matching the given

699

735

#

700

736

#

701

737

# If this option is set, mutt's received-attachments menu will not show the subparts of

702

# individual messages in a multipart/digest. To see these subparts, press 'v' on that menu.

738

# individual messages in a multipart/digest. To see these subparts, press ``v'' on that menu.

703

739

#

704

740

#

705

741

# set display_filter=""

721

757

# Default: "/usr/local/bin/mutt_dotlock"

722

758

#

723

759

#

724

# Contains the path of the mutt_dotlock (8) binary to be used by

760

# Contains the path of the mutt_dotlock(8) binary to be used by

725

761

# mutt.

726

762

#

727

763

#

739

775

# delay, to be notified of message delays, success, to be

740

776

# notified of successful transmission.

741

777

#

742

# Example: set dsn_notify="failure,delay"

778

# Example:

779

# set dsn_notify="failure,delay"

743

780

#

744

781

# Note: when using $sendmail for delivery, you should not enable

745

782

# this unless you are either using Sendmail 8.8.x or greater or a MTA

746

783

# providing a sendmail(1)-compatible interface supporting the -N option

747

# for DSN. For SMTP delivery, it depends on the server whether DSN is

748

# supported or not.

784

# for DSN. For SMTP delivery, DSN support is autodetected so that it

785

# depends on the server whether DSN will be used or not.

749

786

#

750

787

#

751

788

# set dsn_return=""

759

796

# messages. It may be set to either hdrs to return just the

760

797

# message header, or full to return the full message.

761

798

#

762

# Example: set dsn_return=hdrs

799

# Example:

800

# set dsn_return=hdrs

763

801

#

764

802

# Note: when using $sendmail for delivery, you should not enable

765

803

# this unless you are either using Sendmail 8.8.x or greater or a MTA

766

804

# providing a sendmail(1)-compatible interface supporting the -R option

767

# for DSN. For SMTP delivery, it depends on the server whether DSN is

768

# supported or not.

805

# for DSN. For SMTP delivery, DSN support is autodetected so that it

806

# depends on the server whether DSN will be used or not.

769

807

#

770

808

#

771

809

# set duplicate_threads=yes

775

813

# Default: yes

776

814

#

777

815

#

778

# This variable controls whether mutt, when sorting by threads, threads

779

# messages with the same message-id together. If it is set, it will indicate

816

# This variable controls whether mutt, when $sort is set to threads, threads

817

# messages with the same Message-Id together. If it is set, it will indicate

780

818

# that it thinks they are duplicates of each other with an equals sign

781

# in the thread diagram.

819

# in the thread tree.

782

820

#

783

821

#

784

822

# set edit_headers=no

803

841

#

804

842

#

805

843

# This variable specifies which editor is used by mutt.

806

# It defaults to the value of the VISUAL, or EDITOR, environment

807

# variable, or to the string "vi" if neither of those are set.

844

# It defaults to the value of the $VISUAL, or $EDITOR, environment

845

# variable, or to the string ``vi'' if neither of those are set.

808

846

#

809

847

#

810

848

# set encode_from=no

815

853

#

816

854

#

817

855

# When set, mutt will quoted-printable encode messages when

818

# they contain the string "From " in the beginning of a line.

819

# Useful to avoid the tampering certain mail delivery and transport

820

# agents tend to do with messages.

856

# they contain the string ``From '' (note the trailing space) in the beginning of a line.

857

# This is useful to avoid the tampering certain mail delivery and transport

858

# agents tend to do with messages (in order to prevent tools from

859

# misinterpreting the line as a mbox message separator).

821

860

#

822

861

#

823

862

# set envelope_from_address=""

828

867

#

829

868

#

830

869

# Manually sets the envelope sender for outgoing messages.

831

# This value is ignored if ``$use_envelope_from'' is unset.

870

# This value is ignored if $use_envelope_from is unset.

832

871

#

833

872

#

834

873

# set escape="~"

852

891

# when replying to messages, and the initial prompt for subject is

853

892

# skipped when forwarding messages.

854

893

#

855

# Note: this variable has no effect when the ``$autoedit''

894

# Note: this variable has no effect when the $autoedit

856

895

# variable is set.

857

896

#

858

897

#

887

926

# Default: "~/Mail"

888

927

#

889

928

#

890

# Specifies the default location of your mailboxes. A `+' or `=' at the

929

# Specifies the default location of your mailboxes. A ``+'' or ``='' at the

891

930

# beginning of a pathname will be expanded to the value of this

892

# variable. Note that if you change this variable from the default

931

# variable. Note that if you change this variable (from the default)

893

932

# value you need to make sure that the assignment occurs before

894

# you use `+' or `=' for any other variables since expansion takes place

895

# during the `set' command.

933

# you use ``+'' or ``='' for any other variables since expansion takes place

934

# when handling the ``mailboxes'' command.

896

935

#

897

936

#

898

937

# set folder_format="%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f"

903

942

#

904

943

#

905

944

# This variable allows you to customize the file browser display to your

906

# personal taste. This string is similar to ``$index_format'', but has

907

# its own set of printf()-like sequences:

908

#

945

# personal taste. This string is similar to $index_format, but has

946

# its own set of printf(3)-like sequences:

909

947

# %C current file number

910

948

# %d date/time folder was last modified

911

949

# %f filename

914

952

# %l number of hard links

915

953

# %N N if folder has new mail, blank otherwise

916

954

# %s size in bytes

917

# %t * if the file is tagged, blank otherwise

955

# %t ``*'' if the file is tagged, blank otherwise

918

956

# %u owner name (or numeric uid, if missing)

919

# %>X right justify the rest of the string and pad with character "X"

920

# %|X pad to the end of the line with character "X"

921

# %*X soft-fill with character "X" as pad

922

#

923

#

924

# For an explanation of `soft-fill', see the ``$index_format'' documentation.

957

# %>X right justify the rest of the string and pad with character ``X''

958

# %|X pad to the end of the line with character ``X''

959

# %*X soft-fill with character ``X'' as pad

960

#

961

#

962

# For an explanation of ``soft-fill'', see the $index_format documentation.

925

963

#

926

964

#

927

965

# set followup_to=yes

931

969

# Default: yes

932

970

#

933

971

#

934

# Controls whether or not the Mail-Followup-To header field is

972

# Controls whether or not the ``Mail-Followup-To:'' header field is

935

973

# generated when sending mail. When set, Mutt will generate this

936

974

# field when you are replying to a known mailing list, specified with

937

975

# the ``subscribe'' or ``lists'' commands.

940

978

# receiving duplicate copies of replies to messages which you send

941

979

# to mailing lists, and second, ensuring that you do get a reply

942

980

# separately for any messages sent to known lists to which you are

943

# not subscribed. The header will contain only the list's address

981

# not subscribed.

982

#

983

# The header will contain only the list's address

944

984

# for subscribed lists, and both the list address and your own

945

985

# email address for unsubscribed lists. Without this header, a

946

986

# group reply to your message sent to a subscribed list will be

955

995

# Default: no

956

996

#

957

997

#

958

# This variable is similar to ``$save_name'', except that Mutt will

998

# This variable is similar to $save_name, except that Mutt will

959

999

# store a copy of your outgoing message by the username of the address

960

1000

# you are sending to even if that mailbox does not exist.

961

1001

#

962

# Also see the ``$record'' variable.

1002

# Also see the $record variable.

963

1003

#

964

1004

#

965

1005

# set forward_decode=yes

971

1011

#

972

1012

# Controls the decoding of complex MIME messages into text/plain when

973

1013

# forwarding a message. The message header is also RFC2047 decoded.

974

# This variable is only used, if ``$mime_forward'' is unset,

975

# otherwise ``$mime_forward_decode'' is used instead.

1014

# This variable is only used, if $mime_forward is unset,

1015

# otherwise $mime_forward_decode is used instead.

976

1016

#

977

1017

#

978

1018

# set forward_edit=yes

995

1035

#

996

1036

#

997

1037

# This variable controls the default subject when forwarding a message.

998

# It uses the same format sequences as the ``$index_format'' variable.

1038

# It uses the same format sequences as the $index_format variable.

999

1039

#

1000

1040

#

1001

1041

# set forward_quote=no

1005

1045

# Default: no

1006

1046

#

1007

1047

#

1008

# When set forwarded messages included in the main body of the

1009

# message (when ``$mime_forward'' is unset) will be quoted using

1010

# ``$indent_string''.

1048

# When set, forwarded messages included in the main body of the

1049

# message (when $mime_forward is unset) will be quoted using

1050

# $indent_string.

1011

1051

#

1012

1052

#

1013

1053

# set from=""

1018

1058

#

1019

1059

#

1020

1060

# When set, this variable contains a default from address. It

1021

# can be overridden using my_hdr (including from send-hooks) and

1022

# ``$reverse_name''. This variable is ignored if ``$use_from''

1023

# is unset.

1061

# can be overridden using ``my_hdr'' (including from a ``send-hook'') and

1062

# $reverse_name. This variable is ignored if $use_from is unset.

1024

1063

#

1025

# Defaults to the contents of the environment variable EMAIL.

1064

# This setting defaults to the contents of the environment variable $EMAIL.

1026

1065

#

1027

1066

#

1028

1067

# set gecos_mask="^[^,]*"

1033

1072

#

1034

1073

#

1035

1074

# A regular expression used by mutt to parse the GECOS field of a password

1036

# entry when expanding the alias. By default the regular expression is set

1037

# to "^[^,]*" which will return the string up to the first "," encountered.

1038

# If the GECOS field contains a string like "lastname, firstname" then you

1039

# should set the gecos_mask=".*".

1075

# entry when expanding the alias. The default value

1076

# will return the string up to the first ``,'' encountered.

1077

# If the GECOS field contains a string like ``lastname, firstname'' then you

1078

# should set it to ``.*''.

1040

1079

#

1041

1080

# This can be useful if you see the following behavior: you address a e-mail

1042

# to user ID stevef whose full name is Steve Franklin. If mutt expands

1043

# stevef to "Franklin" stevef@foo.bar then you should set the gecos_mask to

1081

# to user ID ``stevef'' whose full name is ``Steve Franklin''. If mutt expands

1082

# ``stevef'' to ``"Franklin" stevef@foo.bar'' then you should set the $gecos_mask to

1044

1083

# a regular expression that will match the whole name so mutt will expand

1045

# "Franklin" to "Franklin, Steve".

1084

# ``Franklin'' to ``Franklin, Steve''.

1046

1085

#

1047

1086

#

1048

1087

# set hdrs=yes

1067

1106

#

1068

1107

# When set, this variable causes Mutt to include the header

1069

1108

# of the message you are replying to into the edit buffer.

1070

# The ``$weed'' setting applies.

1109

# The $weed setting applies.

1071

1110

#

1072

1111

#

1073

1112

# set help=yes

1094

1133

# Default: no

1095

1134

#

1096

1135

#

1097

# When set, mutt will skip the host name part of ``$hostname'' variable

1136

# When set, mutt will skip the host name part of $hostname variable

1098

1137

# when adding the domain part to addresses. This variable does not

1099

# affect the generation of Message-IDs, and it will not lead to the

1138

# affect the generation of Message-IDs, and it will not lead to the

1100

1139

# cut-off of first-level domains.

1101

1140

#

1102

1141

#

1166

1205

#

1167

1206

#

1168

1207

# This variable controls the size (in number of strings remembered) of

1169

# the string history buffer. The buffer is cleared each time the

1208

# the string history buffer per category. The buffer is cleared each time the

1170

1209

# variable is set.

1171

1210

#

1172

1211

#

1211

1250

# can be compiled with a fixed domain name in which case a detected

1212

1251

# one is not used.

1213

1252

#

1214

# Also see ``$use_domain'' and ``$hidden_host''.

1253

# Also see $use_domain and $hidden_host.

1215

1254

#

1216

1255

#

1217

1256

# set ignore_linear_white_space=no

1222

1261

#

1223

1262

#

1224

1263

# This option replaces linear-white-space between encoded-word

1225

# and *text to a single space to prevent the display of MIME-encoded

1226

# ``Subject'' field from being divided into multiple lines.

1264

# and text to a single space to prevent the display of MIME-encoded

1265

# ``Subject:'' field from being divided into multiple lines.

1227

1266

#

1228

1267

#

1229

1268

# set ignore_list_reply_to=no

1233

1272

# Default: no

1234

1273

#

1235

1274

#

1236

# Affects the behaviour of the reply function when replying to

1275

# Affects the behaviour of the <reply> function when replying to

1237

1276

# messages from mailing lists (as defined by the ``subscribe'' or

1238

1277

# ``lists'' commands). When set, if the ``Reply-To:'' field is

1239

1278

# set to the same value as the ``To:'' field, Mutt assumes that the

1240

1279

# ``Reply-To:'' field was set by the mailing list to automate responses

1241

1280

# to the list, and will ignore this field. To direct a response to the

1242

# mailing list when this option is set, use the list-reply

1243

# function; group-reply will reply to both the sender and the

1281

# mailing list when this option is set, use the <list-reply>

1282

# function; <group-reply> will reply to both the sender and the

1244

1283

# list.

1245

1284

#

1246

1285

#

1253

1292

#

1254

1293

# This is a colon-delimited list of authentication methods mutt may

1255

1294

# attempt to use to log in to an IMAP server, in the order mutt should

1256

# try them. Authentication methods are either 'login' or the right

1257

# side of an IMAP 'AUTH=xxx' capability string, eg 'digest-md5', 'gssapi'

1258

# or 'cram-md5'. This parameter is case-insensitive. If this

1259

# parameter is unset (the default) mutt will try all available methods,

1295

# try them. Authentication methods are either ``login'' or the right

1296

# side of an IMAP ``AUTH=xxx'' capability string, eg ``digest-md5'', ``gssapi''

1297

# or ``cram-md5''. This option is case-insensitive. If it's

1298

# unset (the default) mutt will try all available methods,

1260

1299

# in order from most-secure to least-secure.

1261

1300

#

1262

# Example: set imap_authenticators="gssapi:cram-md5:login"

1301

# Example:

1302

# set imap_authenticators="gssapi:cram-md5:login"

1263

1303

#

1264

1304

# Note: Mutt will only fall back to other authentication methods if

1265

1305

# the previous methods are unavailable. If a method is available but

1275

1315

#

1276

1316

# When set, mutt will fetch the set of subscribed folders from

1277

1317

# your server on connection, and add them to the set of mailboxes

1278

# it polls for new mail. See also the ``mailboxes'' command.

1318

# it polls for new mail just as if you had issued individual ``mailboxes''

1319

# commands.

1279

1320

#

1280

1321

#

1281

1322

# set imap_delim_chars="/."

1287

1328

#

1288

1329

# This contains the list of characters which you would like to treat

1289

1330

# as folder separators for displaying IMAP paths. In particular it

1290

# helps in using the '=' shortcut for your folder variable.

1331

# helps in using the ``='' shortcut for your folder variable.

1291

1332

#

1292

1333

#

1293

1334

# set imap_headers=""

1298

1339

#

1299

1340

#

1300

1341

# Mutt requests these header fields in addition to the default headers

1301

# ("DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE

1302

# CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES X-LABEL") from IMAP

1342

# (``Date:'', ``From:'', ``Subject:'', ``To:'', ``Cc:'', ``Message-Id:'',

1343

# ``References:'', ``Content-Type:'', ``Content-Description:'', ``In-Reply-To:'',

1344

# ``Reply-To:'', ``Lines:'', ``List-Post:'', ``X-Label:'') from IMAP

1303

1345

# servers before displaying the index menu. You may want to add more

1304

# headers for spam detection. Note: This is a space separated list.

1346

# headers for spam detection.

1347

#

1348

# Note: This is a space separated list, items should be uppercase

1349

# and not contain the colon, e.g. ``X-BOGOSITY X-SPAM-STATUS'' for the

1350

# ``X-Bogosity:'' and ``X-Spam-Status:'' header fields.

1305

1351

#

1306

1352

#

1307

1353

# set imap_idle=no

1343

1389

#

1344

1390

# This variable configures whether IMAP folder browsing will look for

1345

1391

# only subscribed folders or all folders. This can be toggled in the

1346

# IMAP browser with the toggle-subscribed function.

1392

# IMAP browser with the <toggle-subscribed> function.

1347

1393

#

1348

1394

#

1349

1395

# set imap_login=""

1355

1401

#

1356

1402

# Your login name on the IMAP server.

1357

1403

#

1358

# This variable defaults to the value of imap_user.

1404

# This variable defaults to the value of $imap_user.

1359

1405

#

1360

1406

#

1361

1407

# set imap_pass=""

1366

1412

#

1367

1413

#

1368

1414

# Specifies the password for your IMAP account. If unset, Mutt will

1369

# prompt you for your password when you invoke the fetch-mail function.

1415

# prompt you for your password when you invoke the <fetch-mail> function

1416

# or try to open an IMAP folder.

1417

#

1370

1418

# Warning: you should only use this option when you are on a

1371

1419

# fairly secure machine, because the superuser can read your muttrc even

1372

1420

# if you are the only one who can read the file.

1399

1447

# exists to appease speed freaks.

1400

1448

#

1401

1449

#

1450

# set imap_pipeline_depth=15

1451

#

1452

# Name: imap_pipeline_depth

1453

# Type: number

1454

# Default: 15

1455

#

1456

#

1457

# Controls the number of IMAP commands that may be queued up before they

1458

# are sent to the server. A deeper pipeline reduces the amount of time

1459

# mutt must wait for the server, and can make IMAP servers feel much

1460

# more responsive. But not all servers correctly handle pipelined commands,

1461

# so if you have problems you might want to try setting this variable to 0.

1462

#

1463

# Note: Changes to this variable have no effect on open connections.

1464

#

1465

#

1402

1466

# set imap_servernoise=yes

1403

1467

#

1404

1468

# Name: imap_servernoise

1434

1498

#

1435

1499

#

1436

1500

# If set to ``yes'', mutt will look for a mailcap entry with the

1437

# copiousoutput flag set for every MIME attachment it doesn't have

1501

# ``copiousoutput'' flag set for every MIME attachment it doesn't have

1438

1502

# an internal viewer defined for. If such an entry is found, mutt will

1439

1503

# use the viewer defined in that entry to convert the body part to text

1440

1504

# form.

1474

1538

# change this value, as it tends to agitate the more fanatical netizens.

1475

1539

#

1476

1540

# This option is a format string, please see the description of

1477

# ``$index_format'' for supported printf()-style sequences.

1541

# $index_format for supported printf(3)-style sequences.

1542

#

1543

# Because for format=lowed style messages the quoting mechanism

1544

# is strictly defined, this setting is ignored if $text_flowed is

1545

# set.

1478

1546

#

1479

1547

#

1480

1548

# set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"

1487

1555

# This variable allows you to customize the message index display to

1488

1556

# your personal taste.

1489

1557

#

1490

# ``Format strings'' are similar to the strings used in the ``C''

1491

# function printf to format output (see the man page for more detail).

1558

# ``Format strings'' are similar to the strings used in the C

1559

# function printf(3) to format output (see the man page for more details).

1492

1560

# The following sequences are defined in Mutt:

1493

#

1494

1561

# %a address of the author

1495

1562

# %A reply-to address (if present; otherwise: address of author)

1496

# %b filename of the original message folder (think mailBox)

1563

# %b filename of the original message folder (think mailbox)

1497

1564

# %B the list to which the letter was sent, or else the folder name (%b).

1498

1565

# %c number of characters (bytes) in the message

1499

1566

# %C current message number

1500

1567

# %d date and time of the message in the format specified by

1501

# ``date_format'' converted to sender's time zone

1568

# $date_format converted to sender's time zone

1502

1569

# %D date and time of the message in the format specified by

1503

# ``date_format'' converted to the local time zone

1570

# $date_format converted to the local time zone

1504

1571

# %e current message number in thread

1505

1572

# %E number of messages in current thread

1506

1573

# %f sender (address + real name), either From: or Return-Path:

1509

1576

# %i message-id of the current message

1510

1577

# %l number of lines in the message (does not work with maildir,

1511

1578

# mh, and possibly IMAP folders)

1512

# %L If an address in the To or CC header field matches an address

1579

# %L If an address in the ``To:'' or ``Cc:'' header field matches an address

1513

1580

# defined by the users ``subscribe'' command, this displays

1514

1581

# "To <list-name>", otherwise the same as %F.

1515

1582

# %m total number of message in the mailbox

1516

1583

# %M number of hidden messages if the thread is collapsed.

1517

1584

# %N message score

1518

1585

# %n author's real name (or address if missing)

1519

# %O (_O_riginal save folder) Where mutt would formerly have

1520

# stashed the message: list name or recipient name if no list

1586

# %O original save folder where mutt would formerly have

1587

# stashed the message: list name or recipient name

1588

# if not sent to a list

1521

1589

# %P progress indicator for the builtin pager (how much of the file has been displayed)

1522

1590

# %s subject of the message

1523

# %S status of the message (N/D/d/!/r/*)

1524

# %t `to:' field (recipients)

1591

# %S status of the message (``N''/``D''/``d''/``!''/``r''/*)

1592

# %t ``To:'' field (recipients)

1525

1593

# %T the appropriate character from the $to_chars string

1526

1594

# %u user (login) name of the author

1527

1595

# %v first name of the author, or the recipient if the message is from you

1528

1596

# %X number of attachments

1529

1597

# (please see the ``attachments'' section for possible speed effects)

1530

# %y `x-label:' field, if present

1531

# %Y `x-label' field, if present, and (1) not at part of a thread tree,

1532

# (2) at the top of a thread, or (3) `x-label' is different from

1533

# preceding message's `x-label'.

1598

# %y ``X-Label:'' field, if present

1599

# %Y ``X-Label:'' field, if present, and (1) not at part of a thread tree,

1600

# (2) at the top of a thread, or (3) ``X-Label:'' is different from

1601

# preceding message's ``X-Label:''.

1534

1602

# %Z message status flags

1535

1603

# %{fmt} the date and time of the message is converted to sender's

1536

1604

# time zone, and ``fmt'' is expanded by the library function

1537

# ``strftime''; a leading bang disables locales

1605

# strftime(3); a leading bang disables locales

1538

1606

# %[fmt] the date and time of the message is converted to the local

1539

1607

# time zone, and ``fmt'' is expanded by the library function

1540

# ``strftime''; a leading bang disables locales

1608

# strftime(3); a leading bang disables locales

1541

1609

# %(fmt) the local date and time when the message was received.

1542

# ``fmt'' is expanded by the library function ``strftime'';

1610

# ``fmt'' is expanded by the library function strftime(3);

1543

1611

# a leading bang disables locales

1544

1612

# %<fmt> the current local time. ``fmt'' is expanded by the library

1545

# function ``strftime''; a leading bang disables locales.

1546

# %>X right justify the rest of the string and pad with character "X"

1547

# %|X pad to the end of the line with character "X"

1548

# %*X soft-fill with character "X" as pad

1549

#

1550

#

1551

# `Soft-fill' deserves some explanation. Normal right-justification

1552

# will print everything to the left of the %>, displaying padding and

1553

# the whatever lies to the right only if there's room. By contrast,

1613

# function strftime(3); a leading bang disables locales.

1614

# %>X right justify the rest of the string and pad with character ``X''

1615

# %|X pad to the end of the line with character ``X''

1616

# %*X soft-fill with character ``X'' as pad

1617

#

1618

#

1619

# ``Soft-fill'' deserves some explanation: Normal right-justification

1620

# will print everything to the left of the ``%>'', displaying padding and

1621

# whatever lies to the right only if there's room. By contrast,

1554

1622

# soft-fill gives priority to the right-hand side, guaranteeing space

1555

1623

# to display it and showing padding only if there's still room. If

1556

1624

# necessary, soft-fill will eat text leftwards to make room for

1557

1625

# rightward text.

1558

1626

#

1559

# Note that these expandos are supported in

1627

# Note that these expandos are supported in

1560

1628

# ``save-hook'', ``fcc-hook'' and ``fcc-save-hook'', too.

1561

1629

#

1562

# See also: ``$to_chars''.

1563

#

1564

1630

#

1565

1631

# set ispell="ispell"

1566

1632

#

1580

1646

#

1581

1647

#

1582

1648

# If set, read messages marked as flagged will not be moved

1583

# from your spool mailbox to your ``$mbox'' mailbox, or as a result of

1649

# from your spool mailbox to your $mbox mailbox, or as a result of

1584

1650

# a ``mbox-hook'' command.

1585

1651

#

1586

1652

#

1592

1658

#

1593

1659

#

1594

1660

# The locale used by strftime(3) to format dates. Legal values are

1595

# the strings your system accepts for the locale variable LC_TIME.

1661

# the strings your system accepts for the locale environment variable $LC_TIME.

1596

1662

#

1597

1663

#

1598

1664

# set mail_check=5

1603

1669

#

1604

1670

#

1605

1671

# This variable configures how often (in seconds) mutt should look for

1606

# new mail. Also see the ``$timeout'' variable.

1672

# new mail. Also see the $timeout variable.

1607

1673

#

1608

1674

#

1609

1675

# set mailcap_path=""

1639

1705

# Default: ""

1640

1706

#

1641

1707

#

1642

# The header_cache variable points to the header cache database.

1643

# If header_cache points to a directory it will contain a header cache

1644

# database per folder. If header_cache points to a file that file will

1708

# This variable points to the header cache database.

1709

# If pointing to a directory Mutt will contain a header cache

1710

# database file per folder, if pointing to a file that file will

1645

1711

# be a single global header cache. By default it is unset so no header

1646

1712

# caching will be used.

1647

1713

#

1714

# Header caching can greatly improve speed when opening POP, IMAP

1715

# MH or Maildir folders, see ``caching'' for details.

1716

#

1648

1717

#

1649

1718

# set maildir_header_cache_verify=yes

1650

1719

#

1655

1724

#

1656

1725

# Check for Maildir unaware programs other than mutt having modified maildir

1657

1726

# files when the header cache is in use. This incurs one stat(2) per

1658

# message every time the folder is opened.

1727

# message every time the folder is opened (which can be very slow for NFS

1728

# folders).

1659

1729

#

1660

1730

#

1661

1731

# set header_cache_pagesize="16384"

1678

1748

# Default: yes

1679

1749

#

1680

1750

#

1681

# When mutt is compiled with qdbm as header cache backend,

1751

# When mutt is compiled with qdbm or tokyocabinet as header cache backend,

1682

1752

# this option determines whether the database will be compressed.

1683

1753

# Compression results in database files roughly being one fifth

1684

1754

# of the usual diskspace, but the uncompression can result in a

1685

# slower opening of cached folder(s).

1755

# slower opening of cached folder(s) which in general is still

1756

# much faster than opening non header cached folders.

1686

1757

#

1687

1758

#

1688

1759

# set maildir_trash=no

1693

1764

#

1694

1765

#

1695

1766

# If set, messages marked as deleted will be saved with the maildir

1696

# (T)rashed flag instead of unlinked. NOTE: this only applies

1767

# trashed flag instead of unlinked. Note: this only applies

1697

1768

# to maildir-style mailboxes. Setting it will have no effect on other

1698

1769

# mailbox types.

1699

1770

#

1708

1779

# Controls whether or not mutt marks new unread

1709

1780

# messages as old if you exit a mailbox without reading them.

1710

1781

# With this option set, the next time you start mutt, the messages

1711

# will show up with an "O" next to them in the index menu,

1782

# will show up with an ``O'' next to them in the index menu,

1712

1783

# indicating that they are old.

1713

1784

#

1714

1785

#

1720

1791

#

1721

1792

#

1722

1793

# Controls the display of wrapped lines in the internal pager. If set, a

1723

# ``+'' marker is displayed at the beginning of wrapped lines. Also see

1724

# the ``$smart_wrap'' variable.

1794

# ``+'' marker is displayed at the beginning of wrapped lines.

1795

#

1796

# Also see the $smart_wrap variable.

1725

1797

#

1726

1798

#

1727

1799

# set mask="!^\\.[^.]"

1743

1815

# Default: "~/mbox"

1744

1816

#

1745

1817

#

1746

# This specifies the folder into which read mail in your ``$spoolfile''

1818

# This specifies the folder into which read mail in your $spoolfile

1747

1819

# folder will be appended.

1748

1820

#

1821

# Also see the $move variable.

1822

#

1749

1823

#

1750

1824

# set mbox_type=mbox

1751

1825

#

1755

1829

#

1756

1830

#

1757

1831

# The default mailbox type used when creating new folders. May be any of

1758

# mbox, MMDF, MH and Maildir.

1832

# ``mbox'', ``MMDF'', ``MH'' and ``Maildir''.

1759

1833

#

1760

1834

#

1761

1835

# set metoo=no

1777

1851

#

1778

1852

#

1779

1853

# This variable controls the number of lines of context that are given

1780

# when scrolling through menus. (Similar to ``$pager_context''.)

1854

# when scrolling through menus. (Similar to $pager_context.)

1781

1855

#

1782

1856

#

1783

1857

# set menu_move_off=yes

1813

1887

#

1814

1888

#

1815

1889

# If set, forces Mutt to interpret keystrokes with the high bit (bit 8)

1816

# set as if the user had pressed the ESC key and whatever key remains

1890

# set as if the user had pressed the Esc key and whatever key remains

1817

1891

# after having the high bit removed. For example, if the key pressed

1818

1892

# has an ASCII value of 0xf8, then this is treated as if the user had

1819

# pressed ESC then ``x''. This is because the result of removing the

1820

# high bit from ``0xf8'' is ``0x78'', which is the ASCII character

1893

# pressed Esc then ``x''. This is because the result of removing the

1894

# high bit from 0xf8 is 0x78, which is the ASCII character

1821

1895

# ``x''.

1822

1896

#

1823

1897

#

1830

1904

#

1831

1905

# When unset, mutt will mimic mh's behaviour and rename deleted messages

1832

1906

# to ,<old file name> in mh folders instead of really deleting

1833

# them. If the variable is set, the message files will simply be

1907

# them. This leaves the message on disk but makes programs reading the folder

1908

# ignore it. If the variable is set, the message files will simply be

1834

1909

# deleted.

1835

1910

#

1911

# This option is similar to $maildir_trash for Maildir folders.

1912

#

1836

1913

#

1837

1914

# set mh_seq_flagged="flagged"

1838

1915

#

1872

1949

#

1873

1950

#

1874

1951

# When set, the message you are forwarding will be attached as a

1875

# separate MIME part instead of included in the main body of the

1952

# separate message/rfc822 MIME part instead of included in the main body of the

1876

1953

# message. This is useful for forwarding MIME messages so the receiver

1877

1954

# can properly view the message as it was delivered to you. If you like

1878

1955

# to switch between MIME and not MIME from mail to mail, set this

1879

# variable to ask-no or ask-yes.

1956

# variable to ``ask-no'' or ``ask-yes''.

1880

1957

#

1881

# Also see ``$forward_decode'' and ``$mime_forward_decode''.

1958

# Also see $forward_decode and $mime_forward_decode.

1882

1959

#

1883

1960

#

1884

1961

# set mime_forward_decode=no

1889

1966

#

1890

1967

#

1891

1968

# Controls the decoding of complex MIME messages into text/plain when

1892

# forwarding a message while ``$mime_forward'' is set. Otherwise

1893

# ``$forward_decode'' is used instead.

1969

# forwarding a message while $mime_forward is set. Otherwise

1970

# $forward_decode is used instead.

1894

1971

#

1895

1972

#

1896

1973

# set mime_forward_rest=yes

1900

1977

# Default: yes

1901

1978

#

1902

1979

#

1903

# When forwarding multiple attachments of a MIME message from the recvattach

1980

# When forwarding multiple attachments of a MIME message from the attachment

1904

1981

# menu, attachments which cannot be decoded in a reasonable manner will

1905

1982

# be attached to the newly composed message if this option is set.

1906

1983

#

1913

1990

#

1914

1991

#

1915

1992

# This variable describes the format of a remailer line on the mixmaster

1916

# chain selection screen. The following printf-like sequences are

1993

# chain selection screen. The following printf(3)-like sequences are

1917

1994

# supported:

1918

#

1919

1995

# %n The running number on the menu.

1920

1996

# %c Remailer capabilities.

1921

1997

# %s The remailer's short name.

1935

2011

# mixmaster chain.

1936

2012

#

1937

2013

#

1938

# set move=ask-no

2014

# set move=no

1939

2015

#

1940

2016

# Name: move

1941

2017

# Type: quadoption

1942

# Default: ask-no

2018

# Default: no

1943

2019

#

1944

2020

#

1945

2021

# Controls whether or not Mutt will move read messages

1946

# from your spool mailbox to your ``$mbox'' mailbox, or as a result of

2022

# from your spool mailbox to your $mbox mailbox, or as a result of

1947

2023

# a ``mbox-hook'' command.

1948

2024

#

1949

2025

#

1956

2032

#

1957

2033

# Set this to a directory and mutt will cache copies of messages from

1958

2034

# your IMAP and POP servers here. You are free to remove entries at any

1959

# time, for instance if stale entries accumulate because you have

1960

# deleted messages with another mail client.

2035

# time.

2036

#

2037

# When setting this variable to a directory, mutt needs to fetch every

2038

# remote message only once and can perform regular expression searches

2039

# as fast as for local folders.

2040

#

2041

# Also see the $message_cache_clean variable.

1961

2042

#

1962

2043

#

1963

2044

# set message_cache_clean=no

1967

2048

# Default: no

1968

2049

#

1969

2050

#

1970

# If set, mutt will clean out obsolete entries from the cache when

2051

# If set, mutt will clean out obsolete entries from the message cache when

1971

2052

# the mailbox is synchronized. You probably only want to set it

1972

# every once in a while, since it can be a little slow.

2053

# every once in a while, since it can be a little slow

2054

# (especially for large folders).

1973

2055

#

1974

2056

#

1975

2057

# set message_format="%s"

1981

2063

#

1982

2064

# This is the string displayed in the ``attachment'' menu for

1983

2065

# attachments of type message/rfc822. For a full listing of defined

1984

# printf()-like sequences see the section on ``$index_format''.

2066

# printf(3)-like sequences see the section on $index_format.

1985

2067

#

1986

2068

#

1987

2069

# set narrow_tree=no

2003

2085

#

2004

2086

#

2005

2087

# Operations that expect to transfer a large amount of data over the

2006

# network will update their progress every net_inc kilobytes.

2088

# network will update their progress every $net_inc kilobytes.

2007

2089

# If set to 0, no progress messages will be displayed.

2008

2090

#

2009

# See also ``$read_inc'' and ``$write_inc''.

2091

# See also $read_inc, $write_inc and $net_inc.

2010

2092

#

2011

2093

#

2012

2094

# set pager="builtin"

2017

2099

#

2018

2100

#

2019

2101

# This variable specifies which pager you would like to use to view

2020

# messages. builtin means to use the builtin pager, otherwise this

2102

# messages. The value ``builtin'' means to use the builtin pager, otherwise this

2021

2103

# variable should specify the pathname of the external pager you would

2022

2104

# like to use.

2023

2105

#

2049

2131

#

2050

2132

# This variable controls the format of the one-line message ``status''

2051

2133

# displayed before each message in either the internal or an external

2052

# pager. The valid sequences are listed in the ``$index_format''

2134

# pager. The valid sequences are listed in the $index_format

2053

2135

# section.

2054

2136

#

2055

2137

#

2066

2148

# giving the reader the context of a few messages before and after the

2067

2149

# message. This is useful, for example, to determine how many messages

2068

2150

# remain to be read in the current thread. One of the lines is reserved

2069

# for the status bar from the index, so a pager_index_lines of 6

2151

# for the status bar from the index, so a setting of 6

2070

2152

# will only show 5 lines of the actual index. A value of 0 results in

2071

2153

# no index being shown. If the number of messages in the current folder

2072

# is less than pager_index_lines, then the index will only use as

2154

# is less than $pager_index_lines, then the index will only use as

2073

2155

# many lines as it needs.

2074

2156

#

2075

2157

#

2081

2163

#

2082

2164

#

2083

2165

# When set, the internal-pager will not move to the next message

2084

# when you are at the end of a message and invoke the next-page

2166

# when you are at the end of a message and invoke the <next-page>

2085

2167

# function.

2086

2168

#

2087

2169

#

2094

2176

#

2095

2177

# Setting this variable will cause Mutt to always attempt to

2096

2178

# cryptographically sign outgoing messages. This can be overridden

2097

# by use of the pgp-menu, when signing is not required or

2098

# encryption is requested as well. If ``$smime_is_default'' is set,

2179

# by use of the pgp menu, when signing is not required or

2180

# encryption is requested as well. If $smime_is_default is set,

2099

2181

# then OpenSSL is used instead to create S/MIME messages and settings can

2100

# be overridden by use of the smime-menu.

2182

# be overridden by use of the smime menu instead of the pgp menu.

2101

2183

# (Crypto only)

2102

2184

#

2103

2185

#

2110

2192

#

2111

2193

# Setting this variable will cause Mutt to always attempt to PGP

2112

2194

# encrypt outgoing messages. This is probably only useful in

2113

# connection to the send-hook command. It can be overridden

2114

# by use of the pgp-menu, when encryption is not required or

2115

# signing is requested as well. IF ``$smime_is_default'' is set,

2195

# connection to the ``send-hook'' command. It can be overridden

2196

# by use of the pgp menu, when encryption is not required or

2197

# signing is requested as well. If $smime_is_default is set,

2116

2198

# then OpenSSL is used instead to create S/MIME messages and

2117

# settings can be overridden by use of the smime-menu.

2199

# settings can be overridden by use of the smime menu instead.

2118

2200

# (Crypto only)

2119

2201

#

2120

2202

#

2167

2249

#

2168

2250

# If set, automatically PGP or OpenSSL sign replies to messages

2169

2251

# which are encrypted. This makes sense in combination with

2170

# ``$crypt_replyencrypt'', because it allows you to sign all

2252

# $crypt_replyencrypt, because it allows you to sign all

2171

2253

# messages which are automatically encrypted. This works around

2172

# the problem noted in ``$crypt_replysign'', that mutt is not able

2254

# the problem noted in $crypt_replysign, that mutt is not able

2173

2255

# to find out whether an encrypted message is also signed.

2174

2256

# (Crypto only)

2175

2257

#

2195

2277

# Default: no

2196

2278

#

2197

2279

#

2198

# If set, mutt will use a possibly-running gpg-agent process.

2280

# If set, mutt will use a possibly-running gpg-agent(1) process.

2199

2281

# (PGP only)

2200

2282

#

2201

2283

#

2207

2289

#

2208

2290

#

2209

2291

# If ``yes'', always attempt to verify PGP or S/MIME signatures.

2210

# If ``ask'', ask whether or not to verify the signature.

2211

# If ``no'', never attempt to verify cryptographic signatures.

2292

# If ``ask-*'', ask whether or not to verify the signature.

2293

# If \Fi``no'', never attempt to verify cryptographic signatures.

2212

2294

# (Crypto only)

2213

2295

#

2214

2296

#

2221

2303

#

2222

2304

# The default behaviour of mutt is to use PGP on all auto-sign/encryption

2223

2305

# operations. To override and to use OpenSSL instead this must be set.

2224

# However, this has no effect while replying, since mutt will automatically

2306

# However, this has no effect while replying, since mutt will automatically

2225

2307

# select the same application that was used to sign/encrypt the original

2226

2308

# message. (Note that this variable can be overridden by unsetting $crypt_autosmime.)

2227

2309

# (S/MIME only)

2248

2330

#

2249

2331

#

2250

2332

# If set (default) this tells mutt to use the default key for decryption. Otherwise,

2251

# if manage multiple certificate-key-pairs, mutt will try to use the mailbox-address

2333

# if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address

2252

2334

# to determine the key to use. It will ask you to supply a key, if it can't find one.

2253

2335

# (S/MIME only)

2254

2336

#

2261

2343

#

2262

2344

#

2263

2345

# This variable allows you to customize the PGP key selection menu to

2264

# your personal taste. This string is similar to ``$index_format'', but

2265

# has its own set of printf()-like sequences:

2266

#

2346

# your personal taste. This string is similar to $index_format, but

2347

# has its own set of printf(3)-like sequences:

2267

2348

# %n number

2268

2349

# %k key id

2269

2350

# %u user id

2312

2393

# Default: no

2313

2394

#

2314

2395

#

2315

# If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs.

2396

# If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs.

2316

2397

# (PGP only)

2317

2398

#

2318

2399

#

2341

2422

#

2342

2423

# This option controls whether Mutt generates old-style inline

2343

2424

# (traditional) PGP encrypted or signed messages under certain

2344

# circumstances. This can be overridden by use of the pgp-menu,

2425

# circumstances. This can be overridden by use of the pgp menu,

2345

2426

# when inline is not required.

2346

2427

#

2347

2428

# Note that Mutt might automatically use PGP/MIME for messages

2348

2429

# which consist of more than a single MIME part. Mutt can be

2349

2430

# configured to ask before sending PGP/MIME messages when inline

2350

2431

# (traditional) would not work.

2351

# See also: ``$pgp_mime_auto''.

2432

#

2433

# Also see the $pgp_mime_auto variable.

2352

2434

#

2353

2435

# Also note that using the old-style PGP message format is strongly

2354

2436

# deprecated.

2365

2447

# Setting this variable will cause Mutt to always attempt to

2366

2448

# create an inline (traditional) message when replying to a

2367

2449

# message which is PGP encrypted/signed inline. This can be

2368

# overridden by use of the pgp-menu, when inline is not

2450

# overridden by use of the pgp menu, when inline is not

2369

2451

# required. This option does not automatically detect if the

2370

2452

# (replied-to) message is inline; instead it relies on Mutt

2371

2453

# internals for previously checked/flagged messages.

2374

2456

# which consist of more than a single MIME part. Mutt can be

2375

2457

# configured to ask before sending PGP/MIME messages when inline

2376

2458

# (traditional) would not work.

2377

# See also: ``$pgp_mime_auto''.

2459

#

2460

# Also see the $pgp_mime_auto variable.

2378

2461

#

2379

2462

# Also note that using the old-style PGP message format is strongly

2380

2463

# deprecated.

2403

2486

#

2404

2487

# If you have more than one key pair, this option allows you to specify

2405

2488

# which of your private keys to use. It is recommended that you use the

2406

# keyid form to specify your key (e.g., ``0x00112233'').

2489

# keyid form to specify your key (e.g. 0x00112233).

2407

2490

# (PGP only)

2408

2491

#

2409

2492

#

2440

2523

# Default: address

2441

2524

#

2442

2525

#

2443

# Specifies how the entries in the `pgp keys' menu are sorted. The

2526

# Specifies how the entries in the pgp menu are sorted. The

2444

2527

# following are legal values:

2445

#

2446

2528

# address sort alphabetically by user id

2447

2529

# keyid sort alphabetically by key id

2448

2530

# date sort by key creation date

2450

2532

#

2451

2533

#

2452

2534

# If you prefer reverse order of the above values, prefix it with

2453

# `reverse-'.

2535

# ``reverse-''.

2454

2536

# (PGP only)

2455

2537

#

2456

2538

#

2481

2563

# messages whenever the user performs an operation which ordinarily would

2482

2564

# result in the contents of the message being operated on. For example,

2483

2565

# if the user displays a pgp-traditional message which has not been manually

2484

# checked with the check-traditional-pgp function, mutt will automatically

2566

# checked with the <check-traditional-pgp> function, mutt will automatically

2485

2567

# check the message for traditional pgp.

2486

2568

#

2487

2569

#

2492

2574

# Default: ""

2493

2575

#

2494

2576

#

2495

# This format strings specifies a command which is used to decode

2577

# This format strings specifies a command which is used to decode

2496

2578

# application/pgp attachments.

2497

2579

#

2498

# The PGP command formats have their own set of printf-like sequences:

2499

#

2580

# The PGP command formats have their own set of printf(3)-like sequences:

2500

2581

# %p Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty

2501

2582

# string otherwise. Note: This may be used with a %? construct.

2502

2583

# %f Expands to the name of a file containing a message.

2507

2588

#

2508

2589

#

2509

2590

# For examples on how to configure these formats for the various versions

2510

# of PGP which are floating around, see the pgp*.rc and gpg.rc files in

2591

# of PGP which are floating around, see the pgp and gpg sample configuration files in

2511

2592

# the samples/ subdirectory which has been installed on your system

2512

2593

# alongside the documentation.

2513

2594

# (PGP only)

2521

2602

#

2522

2603

#

2523

2604

# This command is invoked whenever mutt will need public key information.

2524

# %r is the only printf-like sequence used with this format.

2605

# Of the sequences supported by $pgp_decode_command, %r is the only

2606

# printf(3)-like sequence used with this format.

2525

2607

# (PGP only)

2526

2608

#

2527

2609

#

2533

2615

#

2534

2616

#

2535

2617

# This command is used to verify PGP signatures.

2618

#

2619

# This is a format string, see the $pgp_decode_command command for

2620

# possible printf(3)-like sequences.

2536

2621

# (PGP only)

2537

2622

#

2538

2623

#

2544

2629

#

2545

2630

#

2546

2631

# This command is used to decrypt a PGP encrypted message.

2632

#

2633

# This is a format string, see the $pgp_decode_command command for

2634

# possible printf(3)-like sequences.

2547

2635

# (PGP only)

2548

2636

#

2549

2637

#

2554

2642

# Default: ""

2555

2643

#

2556

2644

#

2557

# This format is used to create a old-style "clearsigned" PGP

2645

# This format is used to create a old-style ``clearsigned'' PGP

2558

2646

# message. Note that the use of this format is strongly

2559

2647

# deprecated.

2648

#

2649

# This is a format string, see the $pgp_decode_command command for

2650

# possible printf(3)-like sequences.

2560

2651

# (PGP only)

2561

2652

#

2562

2653

#

2567

2658

# Default: ""

2568

2659

#

2569

2660

#

2570

# This command is used to create the detached PGP signature for a

2661

# This command is used to create the detached PGP signature for a

2571

2662

# multipart/signed PGP/MIME body part.

2663

#

2664

# This is a format string, see the $pgp_decode_command command for

2665

# possible printf(3)-like sequences.

2572

2666

# (PGP only)

2573

2667

#

2574

2668

#

2580

2674

#

2581

2675

#

2582

2676

# This command is used to both sign and encrypt a body part.

2677

#

2678

# This is a format string, see the $pgp_decode_command command for

2679

# possible printf(3)-like sequences.

2583

2680

# (PGP only)

2584

2681

#

2585

2682

#

2591

2688

#

2592

2689

#

2593

2690

# This command is used to encrypt a body part without signing it.

2691

#

2692

# This is a format string, see the $pgp_decode_command command for

2693

# possible printf(3)-like sequences.

2594

2694

# (PGP only)

2595

2695

#

2596

2696

#

2601

2701

# Default: ""

2602

2702

#

2603

2703

#

2604

# This command is used to import a key from a message into

2704

# This command is used to import a key from a message into

2605

2705

# the user's public key ring.

2706

#

2707

# This is a format string, see the $pgp_decode_command command for

2708

# possible printf(3)-like sequences.

2606

2709

# (PGP only)

2607

2710

#

2608

2711

#

2615

2718

#

2616

2719

# This command is used to export a public key from the user's

2617

2720

# key ring.

2721

#

2722

# This is a format string, see the $pgp_decode_command command for

2723

# possible printf(3)-like sequences.

2618

2724

# (PGP only)

2619

2725

#

2620

2726

#

2627

2733

#

2628

2734

# This command is used to verify key information from the key selection

2629

2735

# menu.

2736

#

2737

# This is a format string, see the $pgp_decode_command command for

2738

# possible printf(3)-like sequences.

2630

2739

# (PGP only)

2631

2740

#

2632

2741

#

2638

2747

#

2639

2748

#

2640

2749

# This command is used to list the secret key ring's contents. The

2641

# output format must be analogous to the one used by

2750

# output format must be analogous to the one used by:

2642

2751

# gpg --list-keys --with-colons.

2643

2752

#

2644

# This format is also generated by the pgpring utility which comes

2753

# This format is also generated by the pgpring utility which comes

2645

2754

# with mutt.

2755

#

2756

# This is a format string, see the $pgp_decode_command command for

2757

# possible printf(3)-like sequences.

2646

2758

# (PGP only)

2647

2759

#

2648

2760

#

2654

2766

#

2655

2767

#

2656

2768

# This command is used to list the public key ring's contents. The

2657

# output format must be analogous to the one used by

2769

# output format must be analogous to the one used by

2658

2770

# gpg --list-keys --with-colons.

2659

2771

#

2660

# This format is also generated by the pgpring utility which comes

2772

# This format is also generated by the pgpring utility which comes

2661

2773

# with mutt.

2774

#

2775

# This is a format string, see the $pgp_decode_command command for

2776

# possible printf(3)-like sequences.

2662

2777

# (PGP only)

2663

2778

#

2664

2779

#

2671

2786

#

2672

2787

# Controls the handling of encrypted messages when forwarding a message.

2673

2788

# When set, the outer layer of encryption is stripped off. This

2674

# variable is only used if ``$mime_forward'' is set and

2675

# ``$mime_forward_decode'' is unset.

2789

# variable is only used if $mime_forward is set and

2790

# $mime_forward_decode is unset.

2676

2791

# (PGP only)

2677

2792

#

2678

2793

#

2696

2811

#

2697

2812

#

2698

2813

# This sets the algorithm that should be used for encryption.

2699

# Valid choices are "des", "des3", "rc2-40", "rc2-64", "rc2-128".

2700

# If unset "3des" (TripleDES) is used.

2814

# Valid choices are ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``rc2-128''.

2815

# If unset, ``3des'' (TripleDES) is used.

2701

2816

# (S/MIME only)

2702

2817

#

2703

2818

#

2708

2823

# Default: ""

2709

2824

#

2710

2825

#

2711

# Since there is no pubring/secring as with PGP, mutt has to handle

2712

# storage ad retrieval of keys/certs by itself. This is very basic right now,

2826

# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle

2827

# storage and retrieval of keys/certs by itself. This is very basic right now,

2713

2828

# and stores keys and certificates in two different directories, both

2714

2829

# named as the hash-value retrieved from OpenSSL. There is an index file

2715

2830

# which contains mailbox-address keyid pair, and which can be manually

2716

# edited. This one points to the location of the private keys.

2831

# edited. This option points to the location of the private keys.

2717

2832

# (S/MIME only)

2718

2833

#

2719

2834

#

2736

2851

# Default: ""

2737

2852

#

2738

2853

#

2739

# Since there is no pubring/secring as with PGP, mutt has to handle

2854

# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle

2740

2855

# storage and retrieval of keys by itself. This is very basic right

2741

2856

# now, and keys and certificates are stored in two different

2742

2857

# directories, both named as the hash-value retrieved from

2743

2858

# OpenSSL. There is an index file which contains mailbox-address

2744

# keyid pairs, and which can be manually edited. This one points to

2859

# keyid pairs, and which can be manually edited. This option points to

2745

2860

# the location of the certificates.

2746

2861

# (S/MIME only)

2747

2862

#

2756

2871

# This format string specifies a command which is used to decrypt

2757

2872

# application/x-pkcs7-mime attachments.

2758

2873

#

2759

# The OpenSSL command formats have their own set of printf-like sequences

2874

# The OpenSSL command formats have their own set of printf(3)-like sequences

2760

2875

# similar to PGP's:

2761

#

2762

2876

# %f Expands to the name of a file containing a message.

2763

2877

# %s Expands to the name of a file containing the signature part

2764

2878

# of a multipart/signed attachment when verifying it.

2766

2880

# %c One or more certificate IDs.

2767

2881

# %a The algorithm used for encryption.

2768

2882

# %C CA location: Depending on whether $smime_ca_location

2769

# points to a directory or file, this expands to

2770

# "-CApath $smime_ca_location" or "-CAfile $smime_ca_location".

2883

# points to a directory or file, this expands to

2884

# ``-CApath $smime_ca_location'' or ``-CAfile $smime_ca_location''.

2771

2885

#

2772

2886

#

2773

2887

# For examples on how to configure these formats, see the smime.rc in

2784

2898

#

2785

2899

#

2786

2900

# This command is used to verify S/MIME signatures of type multipart/signed.

2901

#

2902

# This is a format string, see the $smime_decrypt_command command for

2903

# possible printf(3)-like sequences.

2787

2904

# (S/MIME only)

2788

2905

#

2789

2906

#

2796

2913

#

2797

2914

# This command is used to verify S/MIME signatures of type

2798

2915

# application/x-pkcs7-mime.

2916

#

2917

# This is a format string, see the $smime_decrypt_command command for

2918

# possible printf(3)-like sequences.

2799

2919

# (S/MIME only)

2800

2920

#

2801

2921

#

2808

2928

#

2809

2929

# This command is used to created S/MIME signatures of type

2810

2930

# multipart/signed, which can be read by all mail clients.

2931

#

2932

# This is a format string, see the $smime_decrypt_command command for

2933

# possible printf(3)-like sequences.

2811

2934

# (S/MIME only)

2812

2935

#

2813

2936

#

2821

2944

# This command is used to created S/MIME signatures of type

2822

2945

# application/x-pkcs7-signature, which can only be handled by mail

2823

2946

# clients supporting the S/MIME extension.

2947

#

2948

# This is a format string, see the $smime_decrypt_command command for

2949

# possible printf(3)-like sequences.

2824

2950

# (S/MIME only)

2825

2951

#

2826

2952

#

2832

2958

#

2833

2959

#

2834

2960

# This command is used to create encrypted S/MIME messages.

2961

#

2962

# This is a format string, see the $smime_decrypt_command command for

2963

# possible printf(3)-like sequences.

2835

2964

# (S/MIME only)

2836

2965

#

2837

2966

#

2844

2973

#

2845

2974

# This command is used to extract PKCS7 structures of S/MIME signatures,

2846

2975

# in order to extract the public X509 certificate(s).

2976

#

2977

# This is a format string, see the $smime_decrypt_command command for

2978

# possible printf(3)-like sequences.

2847

2979

# (S/MIME only)

2848

2980

#

2849

2981

#

2855

2987

#

2856

2988

#

2857

2989

# This command is used to extract X509 certificates from a PKCS7 structure.

2990

#

2991

# This is a format string, see the $smime_decrypt_command command for

2992

# possible printf(3)-like sequences.

2858

2993

# (S/MIME only)

2859

2994

#

2860

2995

#

2867

3002

#

2868

3003

# This command is used to extract only the signers X509 certificate from a S/MIME

2869

3004

# signature, so that the certificate's owner may get compared to the

2870

# email's 'From'-field.

3005

# email's ``From:'' field.

3006

#

3007

# This is a format string, see the $smime_decrypt_command command for

3008

# possible printf(3)-like sequences.

2871

3009

# (S/MIME only)

2872

3010

#

2873

3011

#

2879

3017

#

2880

3018

#

2881

3019

# This command is used to import a certificate via smime_keys.

3020

#

3021

# This is a format string, see the $smime_decrypt_command command for

3022

# possible printf(3)-like sequences.

2882

3023

# (S/MIME only)

2883

3024

#

2884

3025

#

2892

3033

# This command is used to extract the mail address(es) used for storing

2893

3034

# X509 certificates, and for verification purposes (to check whether the

2894

3035

# certificate was issued for the sender's mailbox).

3036

#

3037

# This is a format string, see the $smime_decrypt_command command for

3038

# possible printf(3)-like sequences.

2895

3039

# (S/MIME only)

2896

3040

#

2897

3041

#

2929

3073

# to remote servers be encrypted. Furthermore it will attempt to

2930

3074

# negotiate TLS even if the server does not advertise the capability,

2931

3075

# since it would otherwise have to abort the connection anyway. This

2932

# option supersedes ``$ssl_starttls''.

3076

# option supersedes $ssl_starttls.

2933

3077

#

2934

3078

#

2935

3079

# set ssl_starttls=yes

2953

3097

#

2954

3098

# This variable specifies the file where the certificates you trust

2955

3099

# are saved. When an unknown certificate is encountered, you are asked

2956

# if you accept it or not. If you accept it, the certificate can also

2957

# be saved in this file and further connections are automatically

3100

# if you accept it or not. If you accept it, the certificate can also

3101

# be saved in this file and further connections are automatically

2958

3102

# accepted.

2959

3103

#

2960

3104

# You can also manually add CA certificates in this file. Any server

2961

# certificate that is signed with one of these CA certificates are

3105

# certificate that is signed with one of these CA certificates is

2962

3106

# also automatically accepted.

2963

3107

#

2964

# Example: set certificate_file=~/.mutt/certificates

3108

# Example:

3109

# set certificate_file=~/.mutt/certificates

2965

3110

#

2966

3111

#

2967

3112

# set ssl_usesystemcerts=yes

2972

3117

#

2973

3118

#

2974

3119

# If set to yes, mutt will use CA certificates in the

2975

# system-wide certificate store when checking if server certificate

3120

# system-wide certificate store when checking if a server certificate

2976

3121

# is signed by a trusted CA.

2977

3122

#

2978

3123

#

3041

3186

#

3042

3187

# This variable specifies a file containing trusted CA certificates.

3043

3188

# Any server certificate that is signed with one of these CA

3044

# certificates are also automatically accepted.

3189

# certificates is also automatically accepted.

3045

3190

#

3046

# Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt

3191

# Example:

3192

# set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt

3047

3193

#

3048

3194

#

3049

3195

# set pipe_split=no

3053

3199

# Default: no

3054

3200

#

3055

3201

#

3056

# Used in connection with the pipe-message command and the ``tag-

3057

# prefix'' operator. If this variable is unset, when piping a list of

3202

# Used in connection with the <pipe-message> function following

3203

# <tag-prefix>. If this variable is unset, when piping a list of

3058

3204

# tagged messages Mutt will concatenate the messages and will pipe them

3059

# as a single folder. When set, Mutt will pipe the messages one by one.

3205

# all concatenated. When set, Mutt will pipe the messages one by one.

3060

3206

# In both cases the messages are piped in the current sorted order,

3061

# and the ``$pipe_sep'' separator is added after each message.

3207

# and the $pipe_sep separator is added after each message.

3062

3208

#

3063

3209

#

3064

3210

# set pipe_decode=no

3068

3214

# Default: no

3069

3215

#

3070

3216

#

3071

# Used in connection with the pipe-message command. When unset,

3217

# Used in connection with the <pipe-message> command. When unset,

3072

3218

# Mutt will pipe the messages without any preprocessing. When set, Mutt

3073

# will weed headers and will attempt to PGP/MIME decode the messages

3219

# will weed headers and will attempt to decode the messages

3074

3220

# first.

3075

3221

#

3076

3222

#

3094

3240

#

3095

3241

# This is a colon-delimited list of authentication methods mutt may

3096

3242

# attempt to use to log in to an POP server, in the order mutt should

3097

# try them. Authentication methods are either 'user', 'apop' or any

3098

# SASL mechanism, eg 'digest-md5', 'gssapi' or 'cram-md5'.

3099

# This parameter is case-insensitive. If this parameter is unset

3243

# try them. Authentication methods are either ``user'', ``apop'' or any

3244

# SASL mechanism, eg ``digest-md5'', ``gssapi'' or ``cram-md5''.

3245

# This option is case-insensitive. If this option is unset

3100

3246

# (the default) mutt will try all available methods, in order from

3101

3247

# most-secure to least-secure.

3102

3248

#

3103

# Example: set pop_authenticators="digest-md5:apop:user"

3249

# Example:

3250

# set pop_authenticators="digest-md5:apop:user"

3104

3251

#

3105

3252

#

3106

3253

# set pop_auth_try_all=yes

3110

3257

# Default: yes

3111

3258

#

3112

3259

#

3113

# If set, Mutt will try all available methods. When unset, Mutt will

3114

# only fall back to other authentication methods if the previous

3115

# methods are unavailable. If a method is available but authentication

3116

# fails, Mutt will not connect to the POP server.

3260

# If set, Mutt will try all available authentication methods.

3261

# When unset, Mutt will only fall back to other authentication

3262

# methods if the previous methods are unavailable. If a method is

3263

# available but authentication fails, Mutt will not connect to the POP server.

3117

3264

#

3118

3265

#

3119

3266

# set pop_checkinterval=60

3135

3282

#

3136

3283

#

3137

3284

# If set, Mutt will delete successfully downloaded messages from the POP

3138

# server when using the fetch-mail function. When unset, Mutt will

3285

# server when using the <fetch-mail> function. When unset, Mutt will

3139

3286

# download messages but also leave them on the POP server.

3140

3287

#

3141

3288

#

3146

3293

# Default: ""

3147

3294

#

3148

3295

#

3149

# The name of your POP server for the fetch-mail function. You

3296

# The name of your POP server for the <fetch-mail> function. You

3150

3297

# can also specify an alternative port, username and password, ie:

3151

#

3152

3298

# [pop[s]://][username[:password]@]popserver[:port]

3153

3299

#

3300

# where ``[...]'' denotes an optional part.

3301

#

3154

3302

#

3155

3303

# set pop_last=no

3156

3304

#

3159

3307

# Default: no

3160

3308

#

3161

3309

#

3162

# If this variable is set, mutt will try to use the "LAST" POP command

3310

# If this variable is set, mutt will try to use the ``LAST'' POP command

3163

3311

# for retrieving only unread messages from the POP server when using

3164

# the fetch-mail function.

3312

# the <fetch-mail> function.

3165

3313

#

3166

3314

#

3167

3315

# set pop_reconnect=ask-yes

3171

3319

# Default: ask-yes

3172

3320

#

3173

3321

#

3174

# Controls whether or not Mutt will try to reconnect to POP server if

3322

# Controls whether or not Mutt will try to reconnect to the POP server if

3175

3323

# the connection is lost.

3176

3324

#

3177

3325

#

3195

3343

#

3196

3344

#

3197

3345

# Specifies the password for your POP account. If unset, Mutt will

3198

# prompt you for your password when you open POP mailbox.

3346

# prompt you for your password when you open a POP mailbox.

3347

#

3199

3348

# Warning: you should only use this option when you are on a

3200

3349

# fairly secure machine, because the superuser can read your muttrc

3201

3350

# even if you are the only one who can read the file.

3208

3357

# Default: ""

3209

3358

#

3210

3359

#

3211

# Similar to the ``$attribution'' variable, Mutt will append this

3360

# Similar to the $attribution variable, Mutt will append this

3212

3361

# string after the inclusion of a message which is being replied to.

3213

3362

#

3214

3363

#

3219

3368

# Default: ask-yes

3220

3369

#

3221

3370

#

3222

# Controls whether or not messages are saved in the ``$postponed''

3223

# mailbox when you elect not to send immediately. Also see the

3224

# ``$recall'' variable.

3371

# Controls whether or not messages are saved in the $postponed

3372

# mailbox when you elect not to send immediately.

3373

#

3374

# Also see the $recall variable.

3225

3375

#

3226

3376

#

3227

3377

# set postponed="~/postponed"

3233

3383

#

3234

3384

# Mutt allows you to indefinitely ``postpone sending a message'' which

3235

3385

# you are editing. When you choose to postpone a message, Mutt saves it

3236

# in the mailbox specified by this variable. Also see the ``$postpone''

3237

# variable.

3386

# in the mailbox specified by this variable.

3387

#

3388

# Also see the $postpone variable.

3238

3389

#

3239

3390

#

3240

3391

# set preconnect=""

3248

3399

# a connection to the server. This is useful for setting up secure

3249

3400

# connections, e.g. with ssh(1). If the command returns a nonzero

3250

3401

# status, mutt gives up opening the server. Example:

3251

#

3252

# preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net

3402

# set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \

3253

3403

# sleep 20 < /dev/null > /dev/null"

3254

3404

#

3255

# Mailbox 'foo' on mailhost.net can now be reached

3256

# as '{localhost:1234}foo'.

3405

# Mailbox ``foo'' on ``mailhost.net'' can now be reached

3406

# as ``{localhost:1234}foo''.

3257

3407

#

3258

# NOTE: For this example to work, you must be able to log in to the

3408

# Note: For this example to work, you must be able to log in to the

3259

3409

# remote machine without having to enter a password.

3260

3410

#

3261

3411

#

3267

3417

#

3268

3418

#

3269

3419

# Controls whether or not Mutt really prints messages.

3270

# This is set to ask-no by default, because some people

3271

# accidentally hit ``p'' often (like me).

3420

# This is set to ``ask-no'' by default, because some people

3421

# accidentally hit ``p'' often.

3272

3422

#

3273

3423

#

3274

3424

# set print_command="lpr"

3288

3438

# Default: yes

3289

3439

#

3290

3440

#

3291

# Used in connection with the print-message command. If this

3441

# Used in connection with the <print-message> command. If this

3292

3442

# option is set, the message is decoded before it is passed to the

3293

3443

# external command specified by $print_command. If this option

3294

3444

# is unset, no processing will be applied to the message when

3304

3454

# Default: no

3305

3455

#

3306

3456

#

3307

# Used in connection with the print-message command. If this option

3457

# Used in connection with the <print-message> command. If this option

3308

3458

# is set, the command specified by $print_command is executed once for

3309

# each message which is to be printed. If this option is unset,

3459

# each message which is to be printed. If this option is unset,

3310

3460

# the command specified by $print_command is executed only once, and

3311

3461

# all the messages are concatenated, with a form feed as the message

3312

3462

# separator.

3322

3472

# Default: yes

3323

3473

#

3324

3474

#

3325

# If you use an external ``$pager'', setting this variable will

3475

# If you use an external $pager, setting this variable will

3326

3476

# cause Mutt to prompt you for a command when the pager exits rather

3327

3477

# than returning to the index menu. If unset, Mutt will return to the

3328

3478

# index menu when the external pager exits.

3336

3486

#

3337

3487

#

3338

3488

# This specifies the command that mutt will use to make external address

3339

# queries. The string should contain a %s, which will be substituted

3489

# queries. The string should contain a ``%s'', which will be substituted

3340

3490

# with the query string the user types. See ``query'' for more

3341

3491

# information.

3342

3492

#

3348

3498

# Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"

3349

3499

#

3350

3500

#

3351

# This variable describes the format of the `query' menu. The

3352

# following printf-style sequences are understood:

3353

#

3501

# This variable describes the format of the ``query'' menu. The

3502

# following printf(3)-style sequences are understood:

3354

3503

# %a destination address

3355

3504

# %c current entry number

3356

3505

# %e extra information *

3357

3506

# %n destination name

3358

3507

# %t ``*'' if current entry is tagged, a space otherwise

3359

# %>X right justify the rest of the string and pad with "X"

3360

# %|X pad to the end of the line with "X"

3361

# %*X soft-fill with character "X" as pad

3362

#

3363

#

3364

# For an explanation of `soft-fill', see the ``$index_format'' documentation.

3365

#

3366

# * = can be optionally printed if nonzero, see the ``$status_format'' documentation.

3508

# %>X right justify the rest of the string and pad with ``X''

3509

# %|X pad to the end of the line with ``X''

3510

# %*X soft-fill with character ``X'' as pad

3511

#

3512

#

3513

# For an explanation of ``soft-fill'', see the $index_format documentation.

3514

#

3515

# * = can be optionally printed if nonzero, see the $status_format documentation.

3367

3516

#

3368

3517

#

3369

3518

# set quit=yes

3374

3523

#

3375

3524

#

3376

3525

# This variable controls whether ``quit'' and ``exit'' actually quit

3377

# from mutt. If it set to yes, they do quit, if it is set to no, they

3526

# from mutt. If this option is set, they do quit, if it is unset, they

3378

3527

# have no effect, and if it is set to ask-yes or ask-no, you are

3379

3528

# prompted for confirmation when you try to quit.

3380

3529

#

3386

3535

# Default: "^([ \t]*[|>:}#])+"

3387

3536

#

3388

3537

#

3389

# A regular expression used in the internal-pager to determine quoted

3390

# sections of text in the body of a message.

3391

#

3392

# Note: In order to use the quotedx patterns in the

3393

# internal pager, you need to set this to a regular expression that

3394

# matches exactly the quote characters at the beginning of quoted

3395

# lines.

3538

# A regular expression used in the internal pager to determine quoted

3539

# sections of text in the body of a message. Quoted text may be filtered

3540

# out using the <toggle-quoted> command, or colored according to the

3541

# ``color quoted'' family of directives.

3542

#

3543

# Higher levels of quoting may be colored differently (``color quoted1'',

3544

# ``color quoted2'', etc.). The quoting level is determined by removing

3545

# the last character from the matched text and recursively reapplying

3546

# the regular expression until it fails to produce a match.

3547

#

3548

# Match detection may be overridden by the $smileys regular expression.

3396

3549

#

3397

3550

#

3398

3551

# set read_inc=10

3405

3558

# If set to a value greater than 0, Mutt will display which message it

3406

3559

# is currently on when reading a mailbox or when performing search actions

3407

3560

# such as search and limit. The message is printed after

3408

# read_inc messages have been read or searched (e.g., if set to 25, Mutt will

3561

# this many messages have been read or searched (e.g., if set to 25, Mutt will

3409

3562

# print a message when it is at message 25, and then again when it gets

3410

3563

# to message 50). This variable is meant to indicate progress when

3411

3564

# reading or searching large mailboxes which may take some time.

3412

3565

# When set to 0, only a single message will appear before the reading

3413

3566

# the mailbox.

3414

3567

#

3415

# Also see the ``$write_inc'' variable and the ``Tuning'' section of the

3416

# manual for performance considerations.

3568

# Also see the $write_inc, $net_inc and $time_inc variables and the

3569

# ``tuning'' section of the manual for performance considerations.

3417

3570

#

3418

3571

#

3419

3572

# set read_only=no

3433

3586

# Default: ""

3434

3587

#

3435

3588

#

3436

# This variable specifies what "real" or "personal" name should be used

3589

# This variable specifies what ``real'' or ``personal'' name should be used

3437

3590

# when sending messages.

3438

3591

#

3439

3592

# By default, this is the GECOS field from /etc/passwd. Note that this

3449

3602

#

3450

3603

#

3451

3604

# Controls whether or not Mutt recalls postponed messages

3452

# when composing a new message. Also see ``$postponed''.

3605

# when composing a new message.

3453

3606

#

3454

# Setting this variable to ``yes'' is not generally useful, and thus not

3607

# Setting this variable to is not generally useful, and thus not

3455

3608

# recommended.

3456

3609

#

3610

# Also see $postponed variable.

3611

#

3457

3612

#

3458

3613

# set record="~/sent"

3459

3614

#

3465

3620

# This specifies the file into which your outgoing messages should be

3466

3621

# appended. (This is meant as the primary method for saving a copy of

3467

3622

# your messages, but another way to do this is using the ``my_hdr''

3468

# command to create a Bcc: field with your email address in it.)

3623

# command to create a ``Bcc:'' field with your email address in it.)

3469

3624

#

3470

# The value of $record is overridden by the ``$force_name'' and

3471

# ``$save_name'' variables, and the ``fcc-hook'' command.

3625

# The value of $record is overridden by the $force_name and

3626

# $save_name variables, and the ``fcc-hook'' command.

3472

3627

#

3473

3628

#

3474

3629

# set reply_regexp="^(re([\\[0-9\\]+])*|aw):[ \t]*"

3494

3649

# assume that you want to reply to the recipients of that message rather

3495

3650

# than to yourself.

3496

3651

#

3652

# Also see the ``alternates'' command.

3653

#

3497

3654

#

3498

3655

# set reply_to=ask-yes

3499

3656

#

3529

3686

# Default: no

3530

3687

#

3531

3688

#

3532

# This variable controls whether or not Mutt will display the "personal"

3689

# This variable controls whether or not Mutt will display the ``personal''

3533

3690

# name from your aliases in the index menu if it finds an alias that

3534

3691

# matches the message's sender. For example, if you have the following

3535

3692

# alias:

3536

#

3537

3693

# alias juser abd30425@somewhere.net (Joe User)

3538

3694

#

3539

3695

# and then you receive mail which contains the following header:

3540

#

3541

3696

# From: abd30425@somewhere.net

3542

3697

#

3543

3698

# It would be displayed in the index menu as ``Joe User'' instead of

3544

3699

# ``abd30425@somewhere.net.'' This is useful when the person's e-mail

3545

# address is not human friendly (like CompuServe addresses).

3700

# address is not human friendly.

3546

3701

#

3547

3702

#

3548

3703

# set reverse_name=no

3557

3712

# from there. If this variable is set, the default From: line of

3558

3713

# the reply messages is built using the address where you received the

3559

3714

# messages you are replying to if that address matches your

3560

# alternates. If the variable is unset, or the address that would be

3561

# used doesn't match your alternates, the From: line will use

3715

# ``alternates''. If the variable is unset, or the address that would be

3716

# used doesn't match your ``alternates'', the From: line will use

3562

3717

# your address on the current machine.

3563

3718

#

3719

# Also see the ``alternates'' command.

3720

#

3564

3721

#

3565

3722

# set reverse_realname=yes

3566

3723

#

3569

3726

# Default: yes

3570

3727

#

3571

3728

#

3572

# This variable fine-tunes the behaviour of the reverse_name feature.

3729

# This variable fine-tunes the behaviour of the $reverse_name feature.

3573

3730

# When it is set, mutt will use the address from incoming messages as-is,

3574

3731

# possibly including eventual real names. When it is unset, mutt will

3575

# override any such real names with the setting of the realname variable.

3732

# override any such real names with the setting of the $realname variable.

3576

3733

#

3577

3734

#

3578

3735

# set rfc2047_parameters=no

3582

3739

# Default: no

3583

3740

#

3584

3741

#

3585

# When this variable is set, Mutt will decode RFC-2047-encoded MIME

3742

# When this variable is set, Mutt will decode RFC2047-encoded MIME

3586

3743

# parameters. You want to set this variable when mutt suggests you

3587

# to save attachments to files named like this:

3744

# to save attachments to files named like:

3588

3745

# =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=

3589

3746

#

3590

# When this variable is set interactively, the change doesn't have

3591

# the desired effect before you have changed folders.

3747

# When this variable is set interactively, the change won't be

3748

# active until you change folders.

3592

3749

#

3593

# Note that this use of RFC 2047's encoding is explicitly,

3750

# Note that this use of RFC2047's encoding is explicitly

3594

3751

# prohibited by the standard, but nevertheless encountered in the

3595

3752

# wild.

3596

# Also note that setting this parameter will not have the effect

3753

#

3754

# Also note that setting this parameter will not have the effect

3597

3755

# that mutt generates this kind of encoding. Instead, mutt will

3598

# unconditionally use the encoding specified in RFC 2231.

3756

# unconditionally use the encoding specified in RFC2231.

3599

3757

#

3600

3758

#

3601

3759

# set save_address=no

3606

3764

#

3607

3765

#

3608

3766

# If set, mutt will take the sender's full address when choosing a

3609

# default folder for saving a mail. If ``$save_name'' or ``$force_name''

3610

# is set too, the selection of the fcc folder will be changed as well.

3767

# default folder for saving a mail. If $save_name or $force_name

3768

# is set too, the selection of the Fcc folder will be changed as well.

3611

3769

#

3612

3770

#

3613

3771

# set save_empty=yes

3618

3776

#

3619

3777

#

3620

3778

# When unset, mailboxes which contain no saved messages will be removed

3621

# when closed (the exception is ``$spoolfile'' which is never removed).

3779

# when closed (the exception is $spoolfile which is never removed).

3622

3780

# If set, mailboxes are never removed.

3623

3781

#

3624

3782

# Note: This only applies to mbox and MMDF folders, Mutt does not

3632

3790

# Default: 0

3633

3791

#

3634

3792

#

3635

# This variable controls the size of the history saved in the

3636

# ``$history_file'' file.

3793

# This variable controls the size of the history (per category) saved in the

3794

# $history_file file.

3637

3795

#

3638

3796

#

3639

3797

# set save_name=no

3646

3804

# This variable controls how copies of outgoing messages are saved.

3647

3805

# When set, a check is made to see if a mailbox specified by the

3648

3806

# recipient address exists (this is done by searching for a mailbox in

3649

# the ``$folder'' directory with the username part of the

3807

# the $folder directory with the username part of the

3650

3808

# recipient address). If the mailbox exists, the outgoing message will

3651

3809

# be saved to that mailbox, otherwise the message is saved to the

3652

# ``$record'' mailbox.

3810

# $record mailbox.

3653

3811

#

3654

# Also see the ``$force_name'' variable.

3812

# Also see the $force_name variable.

3655

3813

#

3656

3814

#

3657

3815

# set score=yes

3663

3821

#

3664

3822

# When this variable is unset, scoring is turned off. This can

3665

3823

# be useful to selectively disable scoring for certain folders when the

3666

# ``$score_threshold_delete'' variable and friends are used.

3824

# $score_threshold_delete variable and related are used.

3667

3825

#

3668

3826

#

3669

3827

# set score_threshold_delete=-1

3686

3844

# Default: 9999

3687

3845

#

3688

3846

#

3689

# Messages which have been assigned a score greater than or equal to this

3847

# Messages which have been assigned a score greater than or equal to this

3690

3848

# variable's value are automatically marked "flagged".

3691

3849

#

3692

3850

#

3712

3870

#

3713

3871

# A colon-delimited list of character sets for outgoing messages. Mutt will use the

3714

3872

# first character set into which the text can be converted exactly.

3715

# If your ``$charset'' is not iso-8859-1 and recipients may not

3716

# understand UTF-8, it is advisable to include in the list an

3873

# If your $charset is not ``iso-8859-1'' and recipients may not

3874

# understand ``UTF-8'', it is advisable to include in the list an

3717

3875

# appropriate widely used standard character set (such as

3718

# iso-8859-2, koi8-r or iso-2022-jp) either instead of or after

3719

# "iso-8859-1".

3876

# ``iso-8859-2'', ``koi8-r'' or ``iso-2022-jp'') either instead of or after

3877

# ``iso-8859-1''.

3720

3878

#

3721

3879

# In case the text cannot be converted into one of these exactly,

3722

# mutt uses ``$charset'' as a fallback.

3880

# mutt uses $charset as a fallback.

3723

3881

#

3724

3882

#

3725

3883

# set sendmail="/usr/sbin/sendmail -oem -oi"

3741

3899

# Default: 0

3742

3900

#

3743

3901

#

3744

# Specifies the number of seconds to wait for the ``$sendmail'' process

3902

# Specifies the number of seconds to wait for the $sendmail process

3745

3903

# to finish before giving up and putting delivery in the background.

3746

3904

#

3747

3905

# Mutt interprets the value of this variable as follows:

3773

3931

# Default: yes

3774

3932

#

3775

3933

#

3776

# If set, a line containing ``-- '' will be inserted before your

3777

# ``$signature''. It is strongly recommended that you not unset

3778

# this variable unless your ``signature'' contains just your name. The

3934

# If set, a line containing ``-- '' (note the trailing space) will be inserted before your

3935

# $signature. It is strongly recommended that you not unset

3936

# this variable unless your signature contains just your name. The

3779

3937

# reason for this is because many software packages use ``-- \n'' to

3780

3938

# detect your signature. For example, Mutt has the ability to highlight

3781

3939

# the signature in a different color in the builtin pager.

3804

3962

# Specifies the filename of your signature, which is appended to all

3805

3963

# outgoing messages. If the filename ends with a pipe (``|''), it is

3806

3964

# assumed that filename is a shell command and input should be read from

3807

# its stdout.

3965

# its standard output.

3808

3966

#

3809

3967

#

3810

3968

# set simple_search="~f %s | ~s %s"

3815

3973

#

3816

3974

#

3817

3975

# Specifies how Mutt should expand a simple search into a real search

3818

# pattern. A simple search is one that does not contain any of the ~

3976

# pattern. A simple search is one that does not contain any of the ``~'' pattern

3819

3977

# operators. See ``patterns'' for more information on search patterns.

3820

3978

#

3821

# For example, if you simply type joe at a search or limit prompt, Mutt

3822

# will automatically expand it to the value specified by this variable.

3823

# For the default value it would be:

3824

#

3825

# ~f joe | ~s joe

3979

# For example, if you simply type ``joe'' at a search or limit prompt, Mutt

3980

# will automatically expand it to the value specified by this variable by

3981

# replacing ``%s'' with the supplied string.

3982

# For the default value, ``joe'' would be expanded to: ``~f joe | ~s joe''.

3826

3983

#

3827

3984

#

3828

3985

# set smart_wrap=yes

3835

3992

# Controls the display of lines longer than the screen width in the

3836

3993

# internal pager. If set, long lines are wrapped at a word boundary. If

3837

3994

# unset, lines are simply wrapped at the screen edge. Also see the

3838

# ``$markers'' variable.

3995

# $markers variable.

3839

3996

#

3840

3997

#

3841

3998

# set smileys="(>From )|(:[-^]?[][)(><}{|/DP])"

3846

4003

#

3847

4004

#

3848

4005

# The pager uses this variable to catch some common false

3849

# positives of ``$quote_regexp'', most notably smileys in the beginning

3850

# of a line

4006

# positives of $quote_regexp, most notably smileys and not consider

4007

# a line quoted text if it also matches $smileys. This mostly

4008

# happens at the beginning of a line.

3851

4009

#

3852

4010

#

3853

4011

# set sleep_time=1

3859

4017

#

3860

4018

# Specifies time, in seconds, to pause while displaying certain informational

3861

4019

# messages, while moving from folder to folder and after expunging

3862

# messages from the current folder. The default is to pause one second, so

4020

# messages from the current folder. The default is to pause one second, so

3863

4021

# a value of zero for this option suppresses the pause.

3864

4022

#

3865

4023

#

3874

4032

# attempt to use to log in to an SMTP server, in the order mutt should

3875

4033

# try them. Authentication methods are any SASL mechanism, eg

3876

4034

# ``digest-md5'', ``gssapi'' or ``cram-md5''.

3877

# This parameter is case-insensitive. If this parameter is unset

4035

# This option is case-insensitive. If it is ``unset''

3878

4036

# (the default) mutt will try all available methods, in order from

3879

4037

# most-secure to least-secure.

3880

4038

#

3881

# Example: set smtp_authenticators="digest-md5:cram-md5"

4039

# Example:

4040

# set smtp_authenticators="digest-md5:cram-md5"

3882

4041

#

3883

4042

#

3884

4043

# set smtp_pass=""

3890

4049

#

3891

4050

# Specifies the password for your SMTP account. If unset, Mutt will

3892

4051

# prompt you for your password when you first send mail via SMTP.

3893

# See ``smtp_url'' to configure mutt to send mail via SMTP.

4052

# See $smtp_url to configure mutt to send mail via SMTP.

4053

#

3894

4054

# Warning: you should only use this option when you are on a

3895

4055

# fairly secure machine, because the superuser can read your muttrc even

3896

4056

# if you are the only one who can read the file.

3903

4063

# Default: ""

3904

4064

#

3905

4065

#

3906

# Defines the SMTP ``smart'' host where sent messages should relayed for

4066

# Defines the SMTP smarthost where sent messages should relayed for

3907

4067

# delivery. This should take the form of an SMTP URL, eg:

3908

#

3909

4068

# smtp[s]://[user[:pass]@]host[:port]/

3910

4069

#

3911

# Setting this variable overrides the value of the ``$sendmail''

4070

# ... where ``[...]'' denotes an optional part.

4071

# Setting this variable overrides the value of the $sendmail

3912

4072

# variable.

3913

4073

#

3914

4074

#

3919

4079

# Default: date

3920

4080

#

3921

4081

#

3922

# Specifies how to sort messages in the index menu. Valid values

4082

# Specifies how to sort messages in the ``index'' menu. Valid values

3923

4083

# are:

3924

#

3925

# date or date-sent

3926

# date-received

3927

# from

3928

# mailbox-order (unsorted)

3929

# score

3930

# size

3931

# spam

3932

# subject

3933

# threads

3934

# to

3935

#

3936

# You may optionally use the reverse- prefix to specify reverse sorting

3937

# order (example: set sort=reverse-date-sent).

4084

# - date or date-sent

4085

# - date-received

4086

# - from

4087

# - mailbox-order (unsorted)

4088

# - score

4089

# - size

4090

# - spam

4091

# - subject

4092

# - threads

4093

# - to

4094

#

4095

#

4096

# You may optionally use the ``reverse-'' prefix to specify reverse sorting

4097

# order (example: ``set sort=reverse-date-sent'').

3938

4098

#

3939

4099

#

3940

4100

# set sort_alias=alias

3944

4104

# Default: alias

3945

4105

#

3946

4106

#

3947

# Specifies how the entries in the `alias' menu are sorted. The

4107

# Specifies how the entries in the ``alias'' menu are sorted. The

3948

4108

# following are legal values:

3949

#

3950

# address (sort alphabetically by email address)

3951

# alias (sort alphabetically by alias name)

3952

# unsorted (leave in order specified in .muttrc)

4109

# - address (sort alphabetically by email address)

4110

# - alias (sort alphabetically by alias name)

4111

# - unsorted (leave in order specified in .muttrc)

3953

4112

#

3954

4113

#

3955

4114

# set sort_aux=date

3961

4120

#

3962

4121

# When sorting by threads, this variable controls how threads are sorted

3963

4122

# in relation to other threads, and how the branches of the thread trees

3964

# are sorted. This can be set to any value that ``$sort'' can, except

3965

# threads (in that case, mutt will just use date-sent). You can also

3966

# specify the last- prefix in addition to the reverse- prefix, but last-

3967

# must come after reverse-. The last- prefix causes messages to be

4123

# are sorted. This can be set to any value that $sort can, except

4124

# ``threads'' (in that case, mutt will just use ``date-sent''). You can also

4125

# specify the ``last-'' prefix in addition to the ``reverse-'' prefix, but ``last-''

4126

# must come after ``reverse-''. The ``last-'' prefix causes messages to be

3968

4127

# sorted against its siblings by which has the last descendant, using

3969

# the rest of sort_aux as an ordering. For instance, set sort_aux=last-

3970

# date-received would mean that if a new message is received in a

4128

# the rest of $sort_aux as an ordering. For instance,

4129

# set sort_aux=last-date-received

4130

#

4131

# would mean that if a new message is received in a

3971

4132

# thread, that thread becomes the last one displayed (or the first, if

3972

# you have set sort=reverse-threads.) Note: For reversed ``$sort''

4133

# you have ``set sort=reverse-threads''.)

4134

#

4135

# Note: For reversed $sort

3973

4136

# order $sort_aux is reversed again (which is not the right thing to do,

3974

4137

# but kept to not break any existing configuration setting).

3975

4138

#

3983

4146

#

3984

4147

# Specifies how to sort entries in the file browser. By default, the

3985

4148

# entries are sorted alphabetically. Valid values:

3986

#

3987

# alpha (alphabetically)

3988

# date

3989

# size

3990

# unsorted

3991

#

3992

# You may optionally use the reverse- prefix to specify reverse sorting

3993

# order (example: set sort_browser=reverse-date).

4149

# - alpha (alphabetically)

4150

# - date

4151

# - size

4152

# - unsorted

4153

#

4154

#

4155

# You may optionally use the ``reverse-'' prefix to specify reverse sorting

4156

# order (example: ``set sort_browser=reverse-date'').

3994

4157

#

3995

4158

#

3996

4159

# set sort_re=yes

4001

4164

#

4002

4165

#

4003

4166

# This variable is only useful when sorting by threads with

4004

# ``$strict_threads'' unset. In that case, it changes the heuristic

4005

# mutt uses to thread messages by subject. With sort_re set, mutt will

4167

# $strict_threads unset. In that case, it changes the heuristic

4168

# mutt uses to thread messages by subject. With $sort_re set, mutt will

4006

4169

# only attach a message as the child of another message by subject if

4007

4170

# the subject of the child message starts with a substring matching the

4008

# setting of ``$reply_regexp''. With sort_re unset, mutt will attach

4171

# setting of $reply_regexp. With $sort_re unset, mutt will attach

4009

4172

# the message whether or not this is the case, as long as the

4010

# non-``$reply_regexp'' parts of both messages are identical.

4173

# non-$reply_regexp parts of both messages are identical.

4011

4174

#

4012

4175

#

4013

4176

# set spam_separator=","

4017

4180

# Default: ","

4018

4181

#

4019

4182

#

4020

# ``spam_separator'' controls what happens when multiple spam headers

4183

# This variable controls what happens when multiple spam headers

4021

4184

# are matched: if unset, each successive header will overwrite any

4022

4185

# previous matches value for the spam label. If set, each successive

4023

# match will append to the previous, using ``spam_separator'' as a

4186

# match will append to the previous, using this variable's value as a

4024

4187

# separator.

4025

4188

#

4026

4189

#

4044

4207

# Default: "-*%A"

4045

4208

#

4046

4209

#

4047

# Controls the characters used by the "%r" indicator in

4048

# ``$status_format''. The first character is used when the mailbox is

4210

# Controls the characters used by the ``%r'' indicator in

4211

# $status_format. The first character is used when the mailbox is

4049

4212

# unchanged. The second is used when the mailbox has been changed, and

4050

4213

# it needs to be resynchronized. The third is used if the mailbox is in

4051

4214

# read-only mode, or if the mailbox will not be written when exiting

4052

4215

# that mailbox (You can toggle whether to write changes to a mailbox

4053

# with the toggle-write operation, bound by default to "%"). The fourth

4216

# with the <toggle-write> operation, bound by default to ``%''). The fourth

4054

4217

# is used to indicate that the current folder has been opened in attach-

4055

4218

# message mode (Certain operations like composing a new mail, replying,

4056

4219

# forwarding, etc. are not permitted in this mode).

4063

4226

# Default: "-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---"

4064

4227

#

4065

4228

#

4066

# Controls the format of the status line displayed in the index

4067

# menu. This string is similar to ``$index_format'', but has its own

4068

# set of printf()-like sequences:

4069

#

4229

# Controls the format of the status line displayed in the ``index''

4230

# menu. This string is similar to $index_format, but has its own

4231

# set of printf(3)-like sequences:

4070

4232

# %b number of mailboxes with new mail *

4071

4233

# %d number of deleted messages *

4072

4234

# %f the full pathname of the current mailbox

4073

4235

# %F number of flagged messages *

4074

4236

# %h local hostname

4075

4237

# %l size (in bytes) of the current mailbox *

4076

# %L size (in bytes) of the messages shown

4238

# %L size (in bytes) of the messages shown

4077

4239

# (i.e., which match the current limit) *

4078

4240

# %m the number of messages in the mailbox *

4079

4241

# %M the number of messages shown (i.e., which match the current limit) *

4089

4251

# %u number of unread messages *

4090

4252

# %v Mutt version string

4091

4253

# %V currently active limit pattern, if any *

4092

# %>X right justify the rest of the string and pad with "X"

4093

# %|X pad to the end of the line with "X"

4094

# %*X soft-fill with character "X" as pad

4095

#

4096

#

4097

# For an explanation of `soft-fill', see the ``$index_format'' documentation.

4254

# %>X right justify the rest of the string and pad with ``X''

4255

# %|X pad to the end of the line with ``X''

4256

# %*X soft-fill with character ``X'' as pad

4257

#

4258

#

4259

# For an explanation of ``soft-fill'', see the $index_format documentation.

4098

4260

#

4099

4261

# * = can be optionally printed if nonzero

4100

4262

#

4114

4276

#

4115

4277

# Here is an example illustrating how to optionally print the number of

4116

4278

# new messages in a mailbox:

4279

#

4117

4280

# %?n?%n new messages.?

4118

4281

#

4119

4282

# You can also switch between two strings using the following construct:

4123

4286

# If the value of sequence_char is non-zero, if_string will

4124

4287

# be expanded, otherwise else_string will be expanded.

4125

4288

#

4126

# You can force the result of any printf-like sequence to be lowercase

4127

# by prefixing the sequence character with an underscore (_) sign.

4289

# You can force the result of any printf(3)-like sequence to be lowercase

4290

# by prefixing the sequence character with an underscore (``_'') sign.

4128

4291

# For example, if you want to display the local hostname in lowercase,

4129

# you would use:

4130

# %_h

4292

# you would use: ``%_h''.

4131

4293

#

4132

# If you prefix the sequence character with a colon (:) character, mutt

4133

# will replace any dots in the expansion by underscores. This might be helpful

4294

# If you prefix the sequence character with a colon (``:'') character, mutt

4295

# will replace any dots in the expansion by underscores. This might be helpful

4134

4296

# with IMAP folders that don't like dots in folder names.

4135

4297

#

4136

4298

#

4142

4304

#

4143

4305

#

4144

4306

# Setting this variable causes the ``status bar'' to be displayed on

4145

# the first line of the screen rather than near the bottom.

4307

# the first line of the screen rather than near the bottom. If $help

4308

# is set, too it'll be placed at the bottom.

4146

4309

#

4147

4310

#

4148

4311

# set strict_threads=no

4153

4316

#

4154

4317

#

4155

4318

# If set, threading will only make use of the ``In-Reply-To'' and

4156

# ``References'' fields when you ``$sort'' by message threads. By

4319

# ``References:'' fields when you $sort by message threads. By

4157

4320

# default, messages with the same subject are grouped together in

4158

4321

# ``pseudo threads.''. This may not always be desirable, such as in a

4159

4322

# personal mailbox where you might have several unrelated messages with

4160

# the subject ``hi'' which will get grouped together. See also

4161

# ``$sort_re'' for a less drastic way of controlling this

4323

# the subjects like ``hi'' which will get grouped together. See also

4324

# $sort_re for a less drastic way of controlling this

4162

4325

# behaviour.

4163

4326

#

4164

4327

#

4170

4333

#

4171

4334

#

4172

4335

# When unset, mutt won't stop when the user presses the terminal's

4173

# susp key, usually ``control-Z''. This is useful if you run mutt

4174

# inside an xterm using a command like xterm -e mutt.

4336

# susp key, usually ``^Z''. This is useful if you run mutt

4337

# inside an xterm using a command like ``xterm -e mutt''.

4175

4338

#

4176

4339

#

4177

4340

# set text_flowed=no

4181

4344

# Default: no

4182

4345

#

4183

4346

#

4184

# When set, mutt will generate text/plain; format=flowed attachments.

4347

# When set, mutt will generate ``format=flowed'' bodies with a content type

4348

# of ``text/plain; format=flowed''.

4185

4349

# This format is easier to handle for some mailing software, and generally

4186

# just looks like ordinary text. To actually make use of this format's

4350

# just looks like ordinary text. To actually make use of this format's

4187

4351

# features, you'll need support in your editor.

4188

4352

#

4189

4353

# Note that $indent_string is ignored when this option is set.

4208

4372

#

4209

4373

#

4210

4374

# Affects the ~b and ~h search operations described in

4211

# section ``patterns'' above. If set, the headers and attachments of

4212

# messages to be searched are decoded before searching. If unset,

4375

# section ``patterns''. If set, the headers and body/attachments of

4376

# messages to be searched are decoded before searching. If unset,

4213

4377

# messages are searched as they appear in the folder.

4214

4378

#

4379

# Users searching attachments or for non-ASCII characters should set

4380

# this value because decoding also includes MIME parsing/decoding and possible

4381

# character set conversions. Otherwise mutt will attempt to match against the

4382

# raw message received (for example quoted-printable encoded or with encoded

4383

# headers) which may lead to incorrect search results.

4384

#

4215

4385

#

4216

4386

# set tilde=no

4217

4387

#

4221

4391

#

4222

4392

#

4223

4393

# When set, the internal-pager will pad blank lines to the bottom of the

4224

# screen with a tilde (~).

4394

# screen with a tilde (``~'').

4225

4395

#

4226

4396

#

4227

4397

# set time_inc=0

4231

4401

# Default: 0

4232

4402

#

4233

4403

#

4234

# Along with ``read_inc'', ``write_inc'', and ``net_inc'', this

4404

# Along with $read_inc, $write_inc, and $net_inc, this

4235

4405

# variable controls the frequency with which progress updates are

4236

# displayed. It suppresses updates less than ``time_inc'' milliseconds

4406

# displayed. It suppresses updates less than $time_inc milliseconds

4237

4407

# apart. This can improve throughput on systems with slow terminals,

4238

4408

# or when running mutt on a remote system.

4239

4409

#

4410

# Also see the ``tuning'' section of the manual for performance considerations.

4411

#

4240

4412

#

4241

4413

# set timeout=600

4242

4414

#

4267

4439

#

4268

4440

# This variable allows you to specify where Mutt will place its

4269

4441

# temporary files needed for displaying and composing messages. If

4270

# this variable is not set, the environment variable TMPDIR is

4271

# used. If TMPDIR is not set then "/tmp" is used.

4442

# this variable is not set, the environment variable $TMPDIR is

4443

# used. If $TMPDIR is not set then ``/tmp'' is used.

4272

4444

#

4273

4445

#

4274

4446

# set to_chars=" +TCFL"

4279

4451

#

4280

4452

#

4281

4453

# Controls the character used to indicate mail addressed to you. The

4282

# first character is the one used when the mail is NOT addressed to your

4283

# address (default: space). The second is used when you are the only

4284

# recipient of the message (default: +). The third is when your address

4285

# appears in the TO header field, but you are not the only recipient of

4286

# the message (default: T). The fourth character is used when your

4287

# address is specified in the CC header field, but you are not the only

4454

# first character is the one used when the mail is not addressed to your

4455

# address. The second is used when you are the only

4456

# recipient of the message. The third is when your address

4457

# appears in the ``To:'' header field, but you are not the only recipient of

4458

# the message. The fourth character is used when your

4459

# address is specified in the ``Cc:'' header field, but you are not the only

4288

4460

# recipient. The fifth character is used to indicate mail that was sent

4289

4461

# by you. The sixth character is used to indicate when a mail

4290

# was sent to a mailing-list you subscribe to (default: L).

4462

# was sent to a mailing-list you subscribe to.

4291

4463

#

4292

4464

#

4293

4465

# set tunnel=""

4299

4471

#

4300

4472

# Setting this variable will cause mutt to open a pipe to a command

4301

4473

# instead of a raw socket. You may be able to use this to set up

4302

# preauthenticated connections to your IMAP/POP3 server. Example:

4303

#

4304

# tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"

4305

#

4306

# NOTE: For this example to work you must be able to log in to the remote

4474

# preauthenticated connections to your IMAP/POP3/SMTP server. Example:

4475

# set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"

4476

#

4477

# Note: For this example to work you must be able to log in to the remote

4307

4478

# machine without having to enter a password.

4308

4479

#

4309

4480

#

4318

4489

# of sendmail which supports the -B8BITMIME flag (such as sendmail

4319

4490

# 8.8.x) or you may not be able to send mail.

4320

4491

#

4321

# When set, Mutt will invoke ``$sendmail'' with the -B8BITMIME

4492

# When set, Mutt will invoke $sendmail with the -B8BITMIME

4322

4493

# flag when sending 8-bit messages to enable ESMTP negotiation.

4323

4494

#

4324

4495

#

4330

4501

#

4331

4502

#

4332

4503

# When set, Mutt will qualify all local addresses (ones without the

4333

# @host portion) with the value of ``$hostname''. If unset, no

4504

# ``@host'' portion) with the value of $hostname. If unset, no

4334

4505

# addresses will be qualified.

4335

4506

#

4336

4507

#

4342

4513

#

4343

4514

#

4344

4515

# When set, mutt will set the envelope sender of the message.

4345

# If ``$envelope_from_address'' is set, it will be used as the sender

4346

# address. If not, mutt will attempt to derive the sender from the

4347

# "From:" header.

4516

# If $envelope_from_address is set, it will be used as the sender

4517

# address. If unset, mutt will attempt to derive the sender from the

4518

# ``From:'' header.

4348

4519

#

4349

4520

# Note that this information is passed to sendmail command using the

4350

# "-f" command line switch. Therefore setting this option is not useful

4351

# if the ``$sendmail'' variable already contains "-f" or if the

4352

# executable pointed to by $sendmail doesn't support the "-f" switch.

4521

# -f command line switch. Therefore setting this option is not useful

4522

# if the $sendmail variable already contains -f or if the

4523

# executable pointed to by $sendmail doesn't support the -f switch.

4353

4524

#

4354

4525

#

4355

4526

# set use_from=yes

4359

4530

# Default: yes

4360

4531

#

4361

4532

#

4362

# When set, Mutt will generate the `From:' header field when

4363

# sending messages. If unset, no `From:' header field will be

4533

# When set, Mutt will generate the ``From:'' header field when

4534

# sending messages. If unset, no ``From:'' header field will be

4364

4535

# generated unless the user explicitly sets one using the ``my_hdr''

4365

4536

# command.

4366

4537

#

4396

4567

# Default: yes

4397

4568

#

4398

4569

#

4399

# When set, mutt will add a "User-Agent" header to outgoing

4570

# When set, mutt will add a ``User-Agent:'' header to outgoing

4400

4571

# messages, indicating which version of mutt was used for composing

4401

4572

# them.

4402

4573

#

4408

4579

# Default: ""

4409

4580

#

4410

4581

#

4411

# Specifies the visual editor to invoke when the ~v command is

4582

# Specifies the visual editor to invoke when the ``~v'' command is

4412

4583

# given in the builtin editor.

4413

4584

#

4414

4585

#

4419

4590

# Default: yes

4420

4591

#

4421

4592

#

4422

# Controls whether Mutt will ask you to press a key after shell-

4423

# escape, pipe-message, pipe-entry, print-message,

4424

# and print-entry commands.

4593

# Controls whether Mutt will ask you to press a key after an external command

4594

# has been invoked by these functions: <shell-escape>,

4595

# <pipe-message>, <pipe-entry>, <print-message>,

4596

# and <print-entry> commands.

4425

4597

#

4426

4598

# It is also used when viewing attachments with ``auto_view'', provided

4427

4599

# that the corresponding mailcap entry has a needsterminal flag,

4461

4633

# Default: yes

4462

4634

#

4463

4635

#

4464

# Controls whether searches wrap around the end of the mailbox.

4636

# Controls whether searches wrap around the end.

4465

4637

#

4466

# When set, searches will wrap around the first (or last) message. When

4467

# unset, searches will not wrap.

4638

# When set, searches will wrap around the first (or last) item. When

4639

# unset, incremental searches will not wrap.

4468

4640

#

4469

4641

#

4470

4642

# set wrapmargin=0

4474

4646

# Default: 0

4475

4647

#

4476

4648

#

4477

# (DEPRECATED) Equivalent to setting wrap with a negative value.

4649

# (DEPRECATED) Equivalent to setting $wrap with a negative value.

4478

4650

#

4479

4651

#

4480

4652

# set write_inc=10

4485

4657

#

4486

4658

#

4487

4659

# When writing a mailbox, a message will be printed every

4488

# write_inc messages to indicate progress. If set to 0, only a

4660

# $write_inc messages to indicate progress. If set to 0, only a

4489

4661

# single message will be displayed before writing a mailbox.

4490

4662

#

4491

# Also see the ``$read_inc'' variable.

4663

# Also see the $read_inc, $net_inc and $time_inc variables and the

4664

# ``tuning'' section of the manual for performance considerations.

4492

4665

#

4493

4666

#

4494

4667

# set write_bcc=yes

4498

4671

# Default: yes

4499

4672

#

4500

4673

#

4501

# Controls whether mutt writes out the Bcc header when preparing

4674

# Controls whether mutt writes out the ``Bcc:'' header when preparing

4502

4675

# messages to be sent. Exim users may wish to unset this. If mutt

4503

# is set to deliver directly via SMTP (see ``$smtp_url''), this

4504

# option does nothing: mutt will never write out the BCC header

4676

# is set to deliver directly via SMTP (see $smtp_url), this

4677

# option does nothing: mutt will never write out the ``Bcc:'' header

4505

4678

# in this case.

4506

4679

#

4507

4680

#