From: Jonathan Corbet <corbet@lwn.net>
To: Shibu Kumar <shibukumar.bit@gmail.com>,
agk@redhat.com, snitzer@kernel.org, mpatocka@redhat.com
Cc: Shibu Kumar <shibukumar.bit@gmail.com>,
dm-devel@lists.linux.dev, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] Removal of unexpected indentation error
Date: Wed, 07 Aug 2024 13:29:07 -0600 [thread overview]
Message-ID: <87cymkrv24.fsf@trenco.lwn.net> (raw)
In-Reply-To: <20240803183306.32425-1-shibukumar.bit@gmail.com>
Shibu Kumar <shibukumar.bit@gmail.com> writes:
> While building kernel documention using make htmldocs command, I was getting unexpected indentation error. Single description was given for two module parameters with wrong indentation.So,I corrected the indentation of both the parameter and description and also added the description separately for both the module param.
>
> Signed-off-by: Shibu kumar shibukumar.bit@gmail.com
> ---
> .../admin-guide/device-mapper/dm-crypt.rst | 20 ++++++++++++-------
> 1 file changed, 13 insertions(+), 7 deletions(-)
Thanks for your patch, I have applied it. Please keep the following in
mind for future changes, though:
- A patch should make a single change; this one made two (fixing the
indentation error and splitting the documentation for the two
parameters). For anything more significant than this, combining two
changes in this way could have resulted in the patch being rejected.
- Please read our documentation on the writing of commit messages
(Documentation/process/submitting-patches.rst in particular) and
line-wrap your changelogs at a reasonable length.
I rewrote the changelog as:
> docs: dm-crypt: Removal of unexpected indentation error
>
> Add the required indentation to fix this docs build error:
>
> Documentation/admin-guide/device-mapper/dm-crypt.rst:167: ERROR: Unexpected indentation.
>
> Also split the documentation for read and write into separate blocks.
Thanks,
jon
prev parent reply other threads:[~2024-08-07 19:29 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-08-03 18:33 [PATCH] Removal of unexpected indentation error Shibu Kumar
2024-08-07 19:29 ` Jonathan Corbet [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87cymkrv24.fsf@trenco.lwn.net \
--to=corbet@lwn.net \
--cc=agk@redhat.com \
--cc=dm-devel@lists.linux.dev \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mpatocka@redhat.com \
--cc=shibukumar.bit@gmail.com \
--cc=snitzer@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox