Portuguese (Brazilian)

Informações sobre clientes de email para Linux

Git

Hoje em dia a maioria dos desenvolvedores usa git send-email em vez de clientes de email comuns. A página de manual desse comando é bem útil. No lado de quem recebe, os mantenedores usam git am para aplicar os patches.

Se você é novo no git, envie seu primeiro patch para si mesmo. Salve-o como texto bruto, incluindo todos os cabeçalhos. Execute git am raw_email.txt e então revise o changelog com git log. Quando isso funcionar, envie o patch para a(s) lista(s) de discussão apropriada(s).

Preferências Gerais

Os patches para o kernel Linux são enviados por email, preferencialmente como texto inline no corpo da mensagem. Alguns mantenedores aceitam anexos, mas, nesse caso, os anexos devem ter o content-type text/plain. Contudo, anexos são, em geral, desaconselhados porque dificultam citar trechos do patch durante o processo de revisão.

Também é altamente recomendável que você use plain text no corpo do email, tanto para patches quanto para outras mensagens. https://useplaintext.email pode ser útil para obter informações sobre como configurar seu cliente de email preferido, além de listar clientes de email recomendados caso você ainda não tenha preferência.

Clientes de email usados para patches do kernel Linux devem enviar o texto do patch sem alterações. Por exemplo, eles não devem modificar ou apagar tabs ou espaços, mesmo no início ou no fim das linhas.

Não envie patches com format=flowed. Isso pode causar quebras de linha inesperadas e indesejadas.

Não deixe seu cliente de email fazer quebra automática de linha para você. Isso também pode corromper seu patch.

Clientes de email não devem modificar a codificação do conjunto de caracteres do texto. Patches enviados por email devem usar apenas codificação ASCII ou UTF-8. Se você configurar seu cliente de email para enviar mensagens com codificação UTF-8, você evita alguns possíveis problemas de charset.

Clientes de email devem gerar e manter “References:” ou “In-Reply-To:” cabeçalhos para que o encadeamento de mensagens não seja quebrado.

Copiar e colar (ou recortar e colar) geralmente não funciona para patches porque tabs são convertidos em espaços. Usar xclipboard, xclip e/ou xcutsel pode funcionar, mas é melhor testar isso você mesmo ou simplesmente evitar copiar e colar.

Não use assinaturas PGP/GPG em emails que contenham patches. Isso quebra muitos scripts que leem e aplicam os patches. (Isso deve ser corrigível.)

É uma boa ideia enviar um patch para si mesmo, salvar a mensagem recebida e aplicá-la com sucesso com o comando ‘patch’ antes de enviar patches para as listas de discussão do Linux.

Algumas dicas de clientes de email (MUA)

Aqui estão algumas dicas específicas de configuração de MUA para editar e enviar patches para o kernel Linux. Estas dicas não pretendem ser resumos completos da configuração dos pacotes de software.

Legenda:

  • TUI = Interface de Usuário Baseada em Texto

  • GUI = Interface Gráfica de Usuário

Alpine (TUI)

Opções de configuração:

Na seção Preferências de Envio:

  • Não Envie Texto com Quebra de Linha Automática deve estar habilitado

  • Remover Espaços em Branco Antes de Enviar deve estar desabilitado

Ao compor a mensagem, o cursor deve ser posicionado onde o patch deverá aparecer, e então pressionar CTRL-R permite especificar o arquivo de patch a ser inserido na mensagem.

Claws Mail (GUI)

Funciona. Algumas pessoas usam isso com sucesso para patches.

Para inserir um patch, use Mensagem‣Inserir Arquivo`(`CTRL-I) ou um editor externo.

Se o patch inserido precisar ser editado na janela de composição do Claws, a opção “Quebra automática” em Configuração‣Preferências‣Escrever‣Quebra de linha deve estar desabilitada.

Evolution (GUI)

Algumas pessoas usam isso com sucesso para patches.

Ao compor o e-mail, selecione: Preformatado

em Formatar‣Estilo de Parágrafo‣Preformatado (CTRL-7) ou na barra de ferramentas

Depois use: Inserir‣Arquivo de Texto... (ALT-N x) para inserir o patch.

Você também pode usar diff -Nru old.c new.c | xclip, selecionar Preformatado, depois colar com o botão do meio.

Kmail (GUI)

Algumas pessoas usam o KMail com sucesso para patches.

A configuração padrão de não compor em HTML é apropriada; não a habilite.

Ao compor um email, em opções, desmarque “quebra de linha automática”. A única desvantagem é que qualquer texto que você digitar no email não será quebrado automaticamente, então você terá que quebrar manualmente o texto antes do patch. A maneira mais fácil é compor o email com quebra de linha automática habilitado, depois salvá-lo como rascunho. Depois de abri-lo novamente dos rascunhos, ele estará com quebras de linha rígidas e você poderá desmarcar “quebra de linha automática” sem perder a quebra existente.

No final do seu email, coloque o delimitador de patch comumente usado antes de inserir o patch: três hífens (---).

Então, no menu Mensagem, selecione inserir arquivo e escolha o seu patch. Como benefício adicional, você pode personalizar a barra de ferramentas de criação de mensagens e colocar o ícone inserir arquivo lá.

Deixe a janela do compositor larga o suficiente para que nenhuma linha seja quebrada. A partir do KMail 1.13.5 (KDE 4.5.4), o KMail aplica quebra de linha ao enviar o email se as linhas quebrarem na janela do compositor. Ter a quebra de linha desativada no menu Opções não é suficiente. Por isso se o seu patch tiver linhas muito longas, você deve deixar a janela do seu compositor bem larga antes de enviar o email. Veja: https://bugs.kde.org/show_bug.cgi?id=174034

Você pode assinar anexos com GPG com segurança, mas texto em linha é preferido para patches, então não os assine com GPG. Assinar patches que foram inseridos como texto em linha torna mais difícil extraí-los de sua codificação 7 bits.

Se você absolutamente precisar enviar patches como anexos em vez de inseri-los como texto, clique com o botão direito no anexo e selecione propriedades, e destaque Sugerir exibição automática para fazer o anexo ser exibido como texto inserido e ficar mais fácil de visualizar.

Ao salvar patches enviados como texto inserido, selecione o email que contém o patch no painel da lista de mensagens, clique com o botão direito e selecione salvar como. Você pode usar o email inteiro sem alterações como patch se ele tiver sido composto corretamente. Emails são salvos como leitura e escrita apenas para o usuário, então você terá que alterar as permissões para torná-los legíveis por grupo e por todos se copiá-los para outro lugar.

Lotus Notes (GUI)

Fuja dele.

IBM Verse (Web GUI)

Veja Lotus Notes.

Mutt (TUI)

Muitos desenvolvedores Linux usam mutt, então deve funcionar muito bem.

O mutt não vem com editor, então qualquer editor que você use deve ser usado de forma que não haja quebras de linha automáticas. A maioria dos editores tem uma opção Inserir Arquivo que insere o conteúdo de um arquivo sem alterações.

Para usar vim com o mutt:

set editor="vi"

Se estiver usando xclip, digite o comando:

:set paste

antes do botão do meio ou shift-insert ou use:

:r filename

se você quiser incluir o patch inline. (a)ttach funciona bem sem set paste.

Você também pode gerar patches com git format-patch e depois usar o Mutt para enviá-los:

$ mutt -H 0001-some-bug-fix.patch

Opções de configuração:

Deve funcionar com as configurações padrão. No entanto, é uma boa ideia definir o send_charset como:

set send_charset="us-ascii:utf-8"

O Mutt é altamente personalizável. Aqui está uma configuração mínima para começar a usar o Mutt para enviar patches pelo Gmail:

# .muttrc
# ================  IMAP  ====================
set imap_user = 'seuusuario@gmail.com'
set imap_pass = 'suasenha'
set spoolfile = imaps://imap.gmail.com/INBOX
set folder = imaps://imap.gmail.com/
set record="imaps://imap.gmail.com/[Gmail]/Sent Mail"
set postponed="imaps://imap.gmail.com/[Gmail]/Drafts"
set mbox="imaps://imap.gmail.com/[Gmail]/All Mail"

# ================  SMTP  ====================
set smtp_url = "smtp://usuario@smtp.gmail.com:587/"
set smtp_pass = $imap_pass
set ssl_force_tls = yes # Exige conexão criptografada

# ================  Composição  ====================
set editor = `echo \$EDITOR`
set edit_headers = yes  # Exibe os cabeçalhos ao editar
set charset = UTF-8     # valor de $LANG; também usado como
                        # fallback para send_charset
# Remetente, endereço de e-mail e linha de assinatura devem
# corresponder
unset use_domain        # porque joe@localhost é constrangedor
set realname = "SEU NOME"
set from = "usuario@gmail.com"
set use_from = yes

A documentação do Mutt tem muito mais informações:

Pine (TUI)

O Pine já teve alguns problemas de truncamento de espaços em branco no passado, mas isso deve estar todo corrigido agora.

Use o alpine (sucessor do pine) se possível.

Opções de configuração:

  • quell-flowed-text é necessário para versões recentes

  • a opção no-strip-whitespace-before-send é necessária

Sylpheed (GUI)

  • Funciona bem para inserir texto inline (ou usando anexos).

  • Permite o uso de um editor externo.

  • É lento em pastas grandes.

  • Não fará autenticação TLS SMTP sobre uma conexão não-SSL.

  • Tem uma barra de régua útil na janela de composição.

  • Adicionar endereços ao catálogo de endereços não reconhece corretamente o nome de exibição.

Thunderbird (GUI)

O Thunderbird é um clone do Outlook que gosta de bagunçar o texto, mas há formas de convencê-lo a se comportar.

Depois de fazer as modificações, incluindo a instalação das extensões, você precisa reiniciar o Thunderbird.

  • Permitir o uso de um editor externo:

    A forma mais fácil de trabalhar com patches no Thunderbird é usar extensões que abrem seu editor externo favorito.

    Aqui estão alguns exemplos de extensões capazes de fazer isso.

Para colocar juízo no editor interno, faça o seguinte:

  • Edite as configurações do Thunderbird para que ele não use format=flowed! Vá até a janela principal e encontre o botão do menu suspenso principal. Menu Principal‣Preferências‣Geral‣Editor de Configurações... para abrir o editor de registro do Thunderbird.

  • Não escreva mensagens em HTML! Vá até a janela principal Menu Principal‣Configurações da Conta‣suaconta@servidor.algo‣Composição e Endereçamento! Lá você pode desabilitar a opção “Compor mensagens em formato HTML”.

  • Abra mensagens apenas como texto simples! Vá até a janela principal Menu Principal‣Visualizar‣Corpo da Mensagem Como‣Texto Simples!

TkRat (GUI)

Funciona. Use “Inserir arquivo...” ou um editor externo.

Gmail (Web GUI)

Não funciona para enviar patches.

O cliente web do Gmail converte tabulações em espaços automaticamente.

Ao mesmo tempo, ele quebra linhas a cada 78 caracteres com quebras de linha no estilo CRLF, embora o problema de tab para espaço possa ser resolvido com um editor externo.

Outro problema é que o Gmail codifica em base64 qualquer mensagem que tenha um caractere não-ASCII. Isso inclui coisas como nomes europeus.

HacKerMaiL (TUI)

HacKerMaiL (hkml) é uma ferramenta simples de gerenciamento de e-mails baseada em public-inbox que não exige inscrição em listas de discussão. É desenvolvida e mantida pelo mantenedor do DAMON e visa oferecer suporte a fluxos de trabalho de desenvolvimento simples para o DAMON e para subsistemas gerais do kernel. Consulte o README (https://github.com/sjp38/hackermail/blob/master/README.md) para mais detalhes.