Re: [PATCH] Documentation: networking: device drivers: Remove stray asterisks

From: Jonathan NeuschÃfer
Date: Thu Oct 03 2019 - 13:39:09 EST


On Thu, Oct 03, 2019 at 10:47:37AM -0600, Jonathan Corbet wrote:
> On Wed, 2 Oct 2019 17:09:55 +0200
> Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx> wrote:
>
> > These asterisks were once references to a line that said:
> > "* Other names and brands may be claimed as the property of others."
> > But now, they serve no purpose; they can only irritate the reader.
> >
> > Fixes: de3edab4276c ("e1000: update README for e1000")
> > Fixes: a3fb65680f65 ("e100.txt: Cleanup license info in kernel doc")
> > Fixes: da8c01c4502a ("e1000e.txt: Add e1000e documentation")
> > Fixes: f12a84a9f650 ("Documentation: fm10k: Add kernel documentation")
> > Fixes: b55c52b1938c ("igb.txt: Add igb documentation")
> > Fixes: c4e9b56e2442 ("igbvf.txt: Add igbvf Documentation")
> > Fixes: d7064f4c192c ("Documentation/networking/: Update Intel wired LAN driver documentation")
> > Fixes: c4b8c01112a1 ("ixgbevf.txt: Update ixgbevf documentation")
> > Fixes: 1e06edcc2f22 ("Documentation: i40e: Prepare documentation for RST conversion")
> > Fixes: 105bf2fe6b32 ("i40evf: add driver to kernel build system")
> > Fixes: 1fae869bcf3d ("Documentation: ice: Prepare documentation for RST conversion")
> > Fixes: df69ba43217d ("ionic: Add basic framework for IONIC Network device driver")
> > Signed-off-by: Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx>
>
> So just FYI: as I applied this, I removed most of the "Fixes" tags. The
> cited commits were adding documentation as plain-text files, so the extra
> asterisk was *not* an error to be fixed at that point. The RST-conversion
> patches, instead, should have caught that...

Ah, ok. My reasoning here was more that the asterisks had no meaning
when the text files were added, rather than about potential ReST syntax
errors.


Thanks

Attachment: signature.asc
Description: PGP signature