Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37;
Message-ID: <a7b30487-21db-45ae-bb49-596971c32b25@infradead.org>
Date:   Mon, 2 Oct 2023 00:02:18 -0700
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH] drm/i915/uapi: fix doc typos
Content-Language: en-US
To:     =?UTF-8?B?VmlsbGUgU3lyasOkbMOk?= <ville.syrjala@linux.intel.com>
Cc:     linux-kernel@vger.kernel.org,
        Tvrtko Ursulin <tvrtko.ursulin@linux.intel.com>,
        dri-devel@lists.freedesktop.org, intel-gfx@lists.freedesktop.org,
        Maxime Ripard <mripard@kernel.org>,
        Thomas Zimmermann <tzimmermann@suse.de>,
        Rodrigo Vivi <rodrigo.vivi@intel.com>
References: <20231002010824.14781-1-rdunlap@infradead.org>
 <ZRpnjU3Myknj81Ff@intel.com>
From:   Randy Dunlap <rdunlap@infradead.org>
In-Reply-To: <ZRpnjU3Myknj81Ff@intel.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Precedence: bulk

Hi--

On 10/1/23 23:47, Ville Syrjälä wrote:
> On Sun, Oct 01, 2023 at 06:08:24PM -0700, Randy Dunlap wrote:
>> Correct typo of "its".
>> Add a comma for clarity.
>>
>> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
>> Cc: Jani Nikula <jani.nikula@linux.intel.com>
>> Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com>
>> Cc: Rodrigo Vivi <rodrigo.vivi@intel.com>
>> Cc: Tvrtko Ursulin <tvrtko.ursulin@linux.intel.com>
>> Cc: intel-gfx@lists.freedesktop.org
>> Cc: Maarten Lankhorst <maarten.lankhorst@linux.intel.com>
>> Cc: Maxime Ripard <mripard@kernel.org>
>> Cc: Thomas Zimmermann <tzimmermann@suse.de>
>> Cc: dri-devel@lists.freedesktop.org
>> ---
>>  include/uapi/drm/i915_drm.h |    6 +++---
>>  1 file changed, 3 insertions(+), 3 deletions(-)
>>
>> diff -- a/include/uapi/drm/i915_drm.h b/include/uapi/drm/i915_drm.h
>> --- a/include/uapi/drm/i915_drm.h
>> +++ b/include/uapi/drm/i915_drm.h
>> @@ -38,13 +38,13 @@ extern "C" {
>>   */
>>  
>>  /**
>> - * DOC: uevents generated by i915 on it's device node
>> + * DOC: uevents generated by i915 on its device node
>>   *
>>   * I915_L3_PARITY_UEVENT - Generated when the driver receives a parity mismatch
>> - *	event from the gpu l3 cache. Additional information supplied is ROW,
>> + *	event from the GPU l3 cache. Additional information supplied is ROW,
> 
> s/l3/L3/ would also be appropriate if aim to fix the caps.

Sure, I can do that.

> 
>>   *	BANK, SUBBANK, SLICE of the affected cacheline. Userspace should keep
>>   *	track of these events and if a specific cache-line seems to have a
>                              ^
> I'd put the comma there, but my grasp of English punctuation isn't
> all that great so I might be wrong. Or maybe both places should have
> one?

I don't see a need for a comma there but I'll put one there if you would like it.

>> - *	persistent error remap it with the l3 remapping tool supplied in
>> + *	persistent error, remap it with the l3 remapping tool supplied in
>>   *	intel-gpu-tools.  The value supplied with the event is always 1.
>>   *
>>   * I915_ERROR_UEVENT - Generated upon error detection, currently only via
> 

Thanks.
-- 
~Randy