Prettify default offlineimap.conf a bit

Comment out all values that are the default values and make it a bit
more consistent in general. We should have a man page for those values,
really.

Signed-off-by: Sebastian Spaeth <Sebastian@SSpaeth.de>
This commit is contained in:
Sebastian Spaeth 2012-02-04 20:35:31 +01:00
parent 314a4e3b2c
commit e351ab736c

View File

@ -1,27 +1,11 @@
# Sample configuration file # Offlineimap sample configuration file
# Copyright (C) 2002-2011 John Goerzen & contributors
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
# This file documents all possible options and can be quite scary. # This file documents all possible options and can be quite scary.
# Looking for a quick start? Take a look at offlineimap.conf.minimal. # Looking for a quick start? Take a look at offlineimap.conf.minimal.
# Settings support interpolation. This means values can contain python # Settings generally support interpolation. This means values can
# format strings which refer to other values in the same section, or # contain python format strings which refer to other values in the same
# values in a special DEFAULT section. This allows you for example to # section, or values in a special DEFAULT section. This allows you for
# use common settings for multiple accounts: # example to use common settings for multiple accounts:
# #
# [Repository Gmail1] # [Repository Gmail1]
# trashfolder: %(gmailtrashfolder)s # trashfolder: %(gmailtrashfolder)s
@ -35,7 +19,6 @@
# would set the trashfolder setting for your German gmail accounts. # would set the trashfolder setting for your German gmail accounts.
################################################## ##################################################
# General definitions # General definitions
################################################## ##################################################
@ -45,13 +28,12 @@
# This specifies where offlineimap is to store its metadata. # This specifies where offlineimap is to store its metadata.
# This directory will be created if it does not already exist. # This directory will be created if it does not already exist.
metadata = ~/.offlineimap #metadata = ~/.offlineimap
# This variable specifies which accounts are defined. Separate them # This variable specifies which accounts are defined. Separate them
# with commas. Account names should be alphanumeric only. # with commas. Account names should be alphanumeric only.
# You will need to specify one section per account below. You may # You will need to specify one section per account below. You may
# not use "general" for an account name. # not use "general" for an account name.
#
accounts = Test accounts = Test
@ -65,7 +47,7 @@ accounts = Test
# since any given sync run never "finishes" due to a timer, you will never # since any given sync run never "finishes" due to a timer, you will never
# sync your additional accounts if this is 1. # sync your additional accounts if this is 1.
maxsyncaccounts = 1 #maxsyncaccounts = 1
# You can specify one or more user interface modules for OfflineIMAP # You can specify one or more user interface modules for OfflineIMAP
# to use. OfflineIMAP will try the first in the list, and if it # to use. OfflineIMAP will try the first in the list, and if it
@ -82,7 +64,7 @@ maxsyncaccounts = 1
# #
# You can override this with a command-line option -u. # You can override this with a command-line option -u.
ui = Blinkenlights #ui = basic
# If you try to synchronize messages to a folder which the IMAP server # If you try to synchronize messages to a folder which the IMAP server
# considers read-only, OfflineIMAP will generate a warning. If you want # considers read-only, OfflineIMAP will generate a warning. If you want
@ -92,7 +74,8 @@ ui = Blinkenlights
# will prevent OfflineIMAP from propagating those changes to the IMAP # will prevent OfflineIMAP from propagating those changes to the IMAP
# server. Note that ignore-readonly is unrelated to the "readonly" # server. Note that ignore-readonly is unrelated to the "readonly"
# setting which prevents a repository from being modified at all. # setting which prevents a repository from being modified at all.
ignore-readonly = no
#ignore-readonly = no
########## Advanced settings ########## Advanced settings
@ -334,8 +317,9 @@ ssl = yes
# fingerprint here. OfflineImap will verify that the server fingerprint # fingerprint here. OfflineImap will verify that the server fingerprint
# has not changed on each connect and refuse to connect otherwise. # has not changed on each connect and refuse to connect otherwise.
# You can also configure this in addition to CA certificate validation # You can also configure this in addition to CA certificate validation
# above and it will check both ways. cert_fingerprint = # above and it will check both ways.
# <SHA1_of_server_certificate_here>
#cert_fingerprint = <SHA1_of_server_certificate_here>
# Specify the port. If not specified, use a default port. # Specify the port. If not specified, use a default port.
# remoteport = 993 # remoteport = 993
@ -421,7 +405,7 @@ remoteuser = username
# cases, it may slow things down. The safe answer is 1. You should # cases, it may slow things down. The safe answer is 1. You should
# probably never set it to a value more than 5. # probably never set it to a value more than 5.
maxconnections = 2 #maxconnections = 2
# OfflineIMAP normally closes IMAP server connections between refreshes if # OfflineIMAP normally closes IMAP server connections between refreshes if
# the global option autorefresh is specified. If you wish it to keep the # the global option autorefresh is specified. If you wish it to keep the
@ -429,15 +413,15 @@ maxconnections = 2
# false. Keeping the connection open means a faster sync start the # false. Keeping the connection open means a faster sync start the
# next time and may use fewer server resources on connection, but uses # next time and may use fewer server resources on connection, but uses
# more server memory. This setting has no effect if autorefresh is not set. # more server memory. This setting has no effect if autorefresh is not set.
#
holdconnectionopen = no #holdconnectionopen = no
# If you want to have "keepalives" sent while waiting between syncs, # If you want to have "keepalives" sent while waiting between syncs,
# specify the amount of time IN SECONDS between keepalives here. Note that # specify the amount of time IN SECONDS between keepalives here. Note that
# sometimes more than this amount of time might pass, so don't make it # sometimes more than this amount of time might pass, so don't make it
# tight. This setting has no effect if autorefresh and holdconnectionopen # tight. This setting has no effect if autorefresh and holdconnectionopen
# are not both set. # are not both set.
#
# keepalive = 60 # keepalive = 60
# Normally, OfflineIMAP will expunge deleted messages from the server. # Normally, OfflineIMAP will expunge deleted messages from the server.
@ -447,11 +431,12 @@ holdconnectionopen = no
# setting; otherwise, the messgaes will just pile up there forever. # setting; otherwise, the messgaes will just pile up there forever.
# Therefore, this setting is definitely NOT recommended. # Therefore, this setting is definitely NOT recommended.
# #
# expunge = no #expunge = no
# Specify whether to process all mail folders on the server, or only # Specify whether to process all mail folders on the server, or only
# those listed as "subscribed". # those listed as "subscribed".
subscribedonly = no #
#subscribedonly = no
# You can specify a folder translator. This must be a eval-able # You can specify a folder translator. This must be a eval-able
# Python expression that takes a foldername arg and returns the new # Python expression that takes a foldername arg and returns the new
@ -525,7 +510,8 @@ subscribedonly = no
# repository will not be modified during synchronization. Use to # repository will not be modified during synchronization. Use to
# e.g. backup an IMAP server. The readonly setting can be applied to any # e.g. backup an IMAP server. The readonly setting can be applied to any
# type of Repository (Maildir, Imap, etc). # type of Repository (Maildir, Imap, etc).
readonly = False #
#readonly = False
[Repository GmailExample] [Repository GmailExample]
@ -539,7 +525,6 @@ readonly = False
# `remoteport`, `tunnel` and `ssl`. (See # `remoteport`, `tunnel` and `ssl`. (See
# http://mail.google.com/support/bin/answer.py?answer=78799&topic=12814) # http://mail.google.com/support/bin/answer.py?answer=78799&topic=12814)
# Any attempt to set those parameters will be silently ignored. # Any attempt to set those parameters will be silently ignored.
#
type = Gmail type = Gmail
@ -571,4 +556,5 @@ remoteuser = username@gmail.com
# spamfolder = [Google Mail]/Spam # spamfolder = [Google Mail]/Spam
# Enable 1-way synchronization. See above for explanation. # Enable 1-way synchronization. See above for explanation.
readonly = False #
#readonly = False