.. SPDX-License-Identifier: GPL-2.0-or-later

Setting up git for the LTP mailing list
=======================================

Before using :manpage:`git-send-email(1)`, you need to set up your email client
to send emails from the command line. This typically involves configuring an
SMTP server and authentication details.

Open a terminal and configure Git with your email settings using the following
commands:

.. code-block:: bash

    git config --global sendemail.from "Your Name <your_email@example.com>"
    git config --global sendemail.smtpserver "smtp.example.com"
    git config --global sendemail.smtpuser "your_email@example.com"
    git config --global sendemail.smtpserverport 587
    git config --global sendemail.smtpencryption tls

Replace ``smtp.example.com`` with the SMTP server address provided by your email
provider. Replace ``your_email@example.com`` with your email address. Adjust the
SMTP port and encryption settings according to your email provider's
requirements.

To test the configuration you can use ``--dry-run`` parameter.

.. code-block:: bash

    git send-email --dry-run --to "ltp@lists.linux.it" --subject "Test Email" HEAD^

Depending on your SMTP server's configuration, you may need to authenticate
before sending emails. If required, configure authentication settings using:

.. code-block:: bash

    git config --global sendemail.smtpuser "your_email@example.com"
    git config --global sendemail.smtppass "your_password"

Replace ``your_email@example.com`` with your email address and ``your_password``
with your email account password.

For any corner case, please take a look at the
`email + git <https://git-send-email.io/>`_ tutorial.

.. note::

    This method still works in most of the cases, but nowadays we often
    require to setup a two factor authentication. If this is the case, please
    consider setting up Git accordingly.

    Instead of :manpage:`git-send-email(1)` you may want to use
    `b4 tool <https://b4.docs.kernel.org/en/latest/contributor/send.html>`_.
    See LTP ``b4`` configuration: :master:`.b4-config`.