Re: [PATCH 0/4] docs: e100[0] fix build errors

From: Randy Dunlap
Date: Fri Jun 22 2018 - 16:22:48 EST


Hi Tobin,

On 06/21/2018 05:37 PM, Tobin C. Harding wrote:
> Hi Jonathan,
>
> This patch set fixes current docs build failure on Linus' mainline
>
> commit: (ba4dbdedd3ed Merge tag 'jfs-4.18' of git://github.com/kleikamp/linux-shaggy)
>
> (FYI this is 8 commits after Linux 4.18-rc1).
>
> And also same build errors on today's linux-next
>
> 8439c34f07a3 (tag: next-20180621, linux-next/master, linux-next) Add linux-next specific files for 20180621
>
>
> I split the patches in between the two drivers to enable use of the
> 'Fixes:' tag.
>
> Tobin C. Harding (4):
> Documentation: e100: Use correct heading adornment
> Documentation: e1000: Use correct heading adornment
> Documentation: e100: Fix docs build error
> Documentation: e1000: Fix docs build error
>
> Documentation/networking/e100.rst | 112 +++++++++++++++--------------
> Documentation/networking/e1000.rst | 76 ++++++++++----------
> 2 files changed, 96 insertions(+), 92 deletions(-)

I am still seeing a few warnings (your 4 patches applied to
linux-next-20180622):

linux-next-20180622/Documentation/networking/e100.rst:57: WARNING: Literal block expected; none found.
linux-next-20180622/Documentation/networking/e100.rst:68: WARNING: Literal block expected; none found.
linux-next-20180622/Documentation/networking/e100.rst:75: WARNING: Literal block expected; none found.
linux-next-20180622/Documentation/networking/e100.rst:84: WARNING: Literal block expected; none found.
linux-next-20180622/Documentation/networking/e100.rst:93: WARNING: Inline emphasis start-string without end-string.
linux-next-20180622/Documentation/networking/e1000.rst:83: ERROR: Unexpected indentation.
linux-next-20180622/Documentation/networking/e1000.rst:84: WARNING: Block quote ends without a blank line; unexpected unindent.
linux-next-20180622/Documentation/networking/e1000.rst:173: WARNING: Definition list ends without a blank line; unexpected unindent.
linux-next-20180622/Documentation/networking/e1000.rst:236: WARNING: Definition list ends without a blank line; unexpected unindent.


You didn't get these warnings? or they weren't important?
or "perfect" was not your primary goal? :) [which is fine]

[I see around 50 similar doc formatting warnings/errors in the entire
Documentation build.]

Anyway, much better than it was. Thanks.

Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

--
~Randy