continuo editando README

README.md

@@ -4,71 +4,41 @@ Este rol instala y configura el servidor IMAP Dovecot.
 
 ## Configuración
 
-### Single-instance storage para adjuntos
-
-* `dovecot_sis_enable` (`yes`): Indica si activar single-instance
-  storage para los adjuntos.
-* `dovecot_sis_directory`: (`{{ vmail_home }}/attachments`): lugar
-  donde se guardan los adjuntos desduplicados.
-* `dovecot_sis_min_size` (`128k`): tamaño minimo de adjuntos a guardar
-  en SIS.
-* `dovecot_sis_hash` (`%{sha1}`): hash a usar para desduplicar.
-* `dovecot_sis_queue_enable` (`no`): habilitar desduplicacion
-  postergada,
-* `dovecot_sis_queue_directory` (`{{vmail_home}}/attachments-queue`):
-  carpeta donde se guardan los pendientes para desduplicar.
-
-### Carpeta alternativa para correo
-
-* `dovecot_altstorage_enable` (`no`): habilitar uso de carpeta
-  alternativa de correo.
-* `dovecot_altstorage_directory` (`{{ vmail_home }}/alt-storage`):
-  carpeta alternativa de correo.
+* `vmail_home` (`/srv/vmail`): home del usuario `vmail`.
 
 ### Generales
 
-* `dovecot_mailbox_junk` (`Junk`): Nombre de la carpeta de spam.
-* `dovecot_mailbox_format` (`dbox`): formato del mailbox. Valores
-  posibles: `dbox`, `mdbox`, `sdbox`, `maildir`.
+* `dovecot_user_home` (`{{ vmail_home }}/mail/%d/%n`): carpeta home de
+  cada usuario.
 * `dovecot_mail_location` (`{{dovecot_mailbox_format}}:~/dbox` o
   `maildir:~/Maildir` según el valor de `dovecot_mailbox_format`):
   ubicación de los mails de cada usuario.
+* `dovecot_mailbox_junk` (`Junk`): Nombre de la carpeta de spam.
+* `dovecot_mailbox_format` (`dbox`): formato del mailbox. Valores
+  posibles: `dbox`, `mdbox`, `sdbox`, `maildir`.
+* `dovecot_auth_username_format` (`%Lu`): formato del nombre de
+  usuario utilizado para autenticar.
+* `dovecot_auth_mechanisms` (`plain`): mecanismos de autenticación,
+  agregar `login` para compatibilidad con MS Outlook.
+* `dovecot_auth_system_enable` (`no`): habilitar login para usuarios
+  del sistema.
+* `dovecot_auth_master_enable` (`no`): habilitar usuarios _master_.
 
+### Protocolos
 
-dovecot_user_home:                     "{{ vmail_home }}/mail/%d/%n" carpeta "home" de los usuarios de dovecot
-
-dovecot_auth_username_format:          "%Lu" como transformar el nombre de usuario antes de autenticar
-
-
-dovecot_auth_mechanisms:               "plain" mecanismos de autenticacion: agregar login para compat. outlook
-
-
-dovecot_auth_system_enable:            no habilitar userdb/passdb de usuarios del sistema?
-
-dovecot_proto_imap_enable:              yes activar IMAP?
-
-
-dovecot_proto_imaps_enable:             no activar IMAPS?
-
-
-dovecot_proto_pop3_enable:              no activar POP3?
-
-
-dovecot_proto_pop3s_enable:             no activar POP3S?
-
-dovecot_auth_master_enable:             no habilitar usuarios master?
-
+* `dovecot_proto_imap_enable` (`yes`): activar IMAP.
+* `dovecot_proto_imaps_enable` (`no`) activar IMAPS.
+* `dovecot_proto_pop3_enable` (`no`) activar POP3.
+* `dovecot_proto_pop3s_enable` (`no`) activar POP3S.
 
 ### SSL
 
-dovecot_ssl_enable:                     yes habilitar ssl
-
-dovecot_ssl_require:                    no requerir ssl
-
-dovecot_ssl_cert:                       "{{ tls_certificate }}" path absoluto al certificado SSL
-
-dovecot_ssl_key:                        "{{ tls_certificate_key }}" path absoluto a la clave privada SSL
-
+* `dovecot_ssl_enable` (`yes`): habilitar ssl.
+* `dovecot_ssl_require` (`no`): requerir ssl.
+* `dovecot_ssl_cert` (`{{ tls_certificate }}`): path absoluto al
+  certificado SSL.
+* `dovecot_ssl_key` (`{{ tls_certificate_key }}`): path absoluto a la
+  clave privada SSL.
 
 ### LDAP
 
@@ -179,3 +149,24 @@ dovecot_plugin_sieve: opciones de sieve
 
   dir con scripts ejecutados luego de los del usuario
   after:                        "/etc/dovecot/sieve/after"
+
+### Single-instance storage para adjuntos
+
+* `dovecot_sis_enable` (`yes`): Indica si activar single-instance
+  storage para los adjuntos.
+* `dovecot_sis_directory`: (`{{ vmail_home }}/attachments`): lugar
+  donde se guardan los adjuntos desduplicados.
+* `dovecot_sis_min_size` (`128k`): tamaño minimo de adjuntos a guardar
+  en SIS.
+* `dovecot_sis_hash` (`%{sha1}`): hash a usar para desduplicar.
+* `dovecot_sis_queue_enable` (`no`): habilitar desduplicacion
+  postergada,
+* `dovecot_sis_queue_directory` (`{{vmail_home}}/attachments-queue`):
+  carpeta donde se guardan los pendientes para desduplicar.
+
+### Carpeta alternativa para correo
+
+* `dovecot_altstorage_enable` (`no`): habilitar uso de carpeta
+  alternativa de correo.
+* `dovecot_altstorage_directory` (`{{ vmail_home }}/alt-storage`):
+  carpeta alternativa de correo.