--- ./warnquota.conf
+++ ./warnquota.conf
@@ -1,55 +1,116 @@
-# this is an example warnquota.conf
+###################################################################
+# Configuration file for the warnquota utility
 #
-; ; and # type comments are allowed
-# and even blank lines
+# File Format:
+# ^^^^^^^^^^^^
+# (1) lines begining with # or ; are comments
+# (2) blank lines are ignored
+# (3) other lines have the form 'value = string'
+# (4) strings may be quoted (double quotes) but they don't have to
+# (5) strings may end with backslash in order to continue
+#     on the next line
+# (6) line breaks are marked with '|' character
+###################################################################
 
-# values can be quoted:
-MAIL_CMD 	= "/usr/my/sendmail/instead/sendmail -t"
-FROM 		= "bas@localhost"
-# but they don't have to be:
-SUBJECT 	= Hey, user, clean up your account!
-CC_TO 		= "sysadm@localhost"
+#
+# Comment this out or remove it once you have edited this config file
+#
+FAIL		= "configure /etc/warnquota.conf before running warnquota"
+
+#
+# command used for sending mails
+#
+MAIL_CMD 	= "/usr/lib/sendmail -t"
+
+#
+# Standard mail fields
+#
+FROM 		= "root@localhost"
+SUBJECT 	= "Your account quota has exceeded!"
+CC_TO 		= "root@localhost"
+
+#
 # If you set this variable CC will be used only when user has less than
 # specified grace time left (examples of possible times: 5 seconds, 1 minute,
 # 12 hours, 5 days)
+#
 # CC_BEFORE = 2 days
-SUPPORT 	= "support@myhost.com"
-PHONE 		= "(123) 456-1111 or (222) 333-4444"
+
+#
+# These variables are used in the default signatures,
+# provided SIGNATURE or GROUP_SIGNATURE is not specified (see below)
+#
+SUPPORT 	= "root@localhost"
+PHONE 		= "123 456 789"
+
+#
 # Text in the beginning of the mail (if not specified, default text is used)
-# This way text can be split to more lines
-# Line breaks are done by '|' character
+#
 # The expressions %i, %h, %d, and %% are substituted for user/group name,
 # host name, domain name, and '%' respectively. For backward compatibility
 # %s behaves as %i but is deprecated.
 MESSAGE         = Hello user %i, I've noticed you use too much space\
  on my disk in %h.%d.|Delete your files on the following filesystems:|
-# Text in the end of the mail (if not specified, default text using SUPPORT and PHONE
-# is created)
+
+#
+# Text in the end of the mail.
+# If not specified, default text using SUPPORT and PHONE is created.
+#
 SIGNATURE	= See you!|			Your admin of %h|
-# Following text is used for mails about group exceeding quotas
+
+#
+# The following text is used for mails about group exceeding quotas
+#
 GROUP_MESSAGE	= Hello, a group '%i' you're member of use too much space at %h.|\
 I chose you to do the cleanup.|Delete group files on the following filesystems:|
-# Text in the end of the mail to the group (if not specified, default text using SUPPORT
-# and PHONE is created).
+
+#
+# Text in the end of the mail to the group.
+# If not specified, default text using SUPPORT and PHONE is created.
+#
 GROUP_SIGNATURE	= See you!|			Your admin|
+
+#
+# If you are running warnquota on a mail server, and don't want bounces
+# because clients can not receive mail setting this to "any" will cause
+# warnquota to not send them mail for all devices.  If you set this to the
+# device name (for example /dev/hdb1) then they will not be sent mail if they
+# are overquota on that device only, and will be sent mail for all other
+# devices.
 #
-#If you are running warnquota on a mail server, and don't want bounces
-#because clients cannot receive mail setting this to "any" will cause
-#warnquota to not send them mail for all devices.  If you set this to the
-#device name (for example /dev/hdb1) then they will not be sent mail if they
-#are overquota on that device only, and will be sent mail for all other
-#devices.
 #MAILDEV        =
+
+#
+# Here you can set a charset for emails sent by warnquota (e.g. UTF-8)
 #
-#Here you can set a charset for emails sent by warnquota (e.g. UTF-8)
 #CHARSET	= 
-# If you are using LDAP mail lookups.
+
+##############################################################
+# Configuration for LDAP (if you are using LDAP mail lookups)
 # host, port, tls, binddn, and bindpw are straight forward.
-# LDAP_BASEDN is your search base dn
-# LDAP_SEARCH_ATTRIBUTE is the attr for the value you are looking for
-# LDAP_MAIL_ATTRIBUTE is the attribute you want used for the mail address
-# LDAP_DEFAULT_MAIL_DOMAIN is the default domain
-#    if the attribute isn't found
+##############################################################
+
+#
+# Your search base dn
+#
+# LDAP_BASEDN
+
+#
+# The attr for the value you are looking for
+#
+# LDAP_SEARCH_ATTRIBUTE
+#
+
+#
+# The attribute you want used for the mail address
+#
+# LDAP_MAIL_ATTRIBUTE
+
+#
+# The default domain if the attribute isn't found
+#
+# LDAP_DEFAULT_MAIL_DOMAIN
+
 # if binddn and bindpw are blank or left out, an anonymous bind is used
 # 
 # LDAP_MAIL = false # or false if you don't want to use it
@@ -64,6 +125,5 @@
 # LDAP_SEARCH_ATTRIBUTE = uid
 # LDAP_MAIL_ATTRIBUTE = mailLocalAddress
 # LDAP_DEFAULT_MAIL_DOMAIN = YourDefaultMailDomain.com
-#
-# end of example warnquota.conf file
-#
+
+# end of warnquota.conf file