Hi Thomas, I intentionally sent the email via my gmx address. But I want my commit under the infinite-omicron email address.
I had a few warnings on my end, but it builds fine with Sphinx v3.4.3 on Debian Bullseye. I can clean up the warnings in the new patch. Yeah, it renders fine. Let me submit a new patch for the rest of these changes too. Regards, ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ On Wednesday, January 5th, 2022 at 4:11 AM, Thomas Huth <th...@redhat.com> wrote: > On 17/12/2021 22.21, oxr...@gmx.us wrote: > > > From: Lucas Ramage lucas.ram...@infinite-omicron.com > > Hi! > > Thanks for your patch! This looks like a good idea, but I think there are > > some minor issues which should be fixed... > > First: Please check your mailer setup. The mail has been sent via @gmx.us, > > but the Signed-off-by uses @infinite-omicron.com ... not a big issue, I > > guess, but it might be better to use the same address for both. > > Second, it does not work here, at least not with Sphinx 1.7 which I have > > installed on my system: > > docs/can.rst:39:Enumerated list ends without a blank line; > > unexpected unindent. > > Does this render correctly on your system? > > Also there are paragraphs in this file which should be clearly marked as > > pre-formatted text (use "::" for those), e.g.: > > diff --git a/docs/can.rst b/docs/can.rst > > --- a/docs/can.rst > > +++ b/docs/can.rst > > @@ -122,7 +125,7 @@ is setup according to the previous SJA1000 section. > > -device ctucan_pci,canbus0=canbus0-bus,canbus1=canbus0-bus \ > > -nographic > > -Setup of CTU CAN FD controller in a guest Linux system > > +Setup of CTU CAN FD controller in a guest Linux system:: > > insmod ctucanfd.ko || modprobe ctucanfd > > insmod ctucanfd_pci.ko || modprobe ctucanfd_pci > > > Bug: https://gitlab.com/qemu-project/qemu/-/issues/527 > > Please use "Buglink:" instead, it's more common in the QEMU project. > > > Signed-off-by: Lucas Ramage lucas.ram...@infinite-omicron.com > > ------------------------------------------------------------- > > > > docs/{can.txt => can.rst} | 14 ++++++-------- > > While you're at it, I think this file should be moved into one of the > > subfolders as well, likely docs/system/ I guess. > > > docs/index.rst | 1 + > > > > 2 files changed, 7 insertions(+), 8 deletions(-) > > > > rename docs/{can.txt => can.rst} (97%) > > > > diff --git a/docs/can.txt b/docs/can.rst > > > > similarity index 97% > > > > rename from docs/can.txt > > > > rename to docs/can.rst > > > > index 0d310237df..995134d079 100644 > > > > --- a/docs/can.txt > > > > +++ b/docs/can.rst > > [...] > > > @@ -196,3 +193,4 @@ Links to other resources > > > > http://canbus.pages.fel.cvut.cz/ctucanfd_ip_core/driver_doc/ctucanfd-driver.html > > > > (11) Integration with PCIe interfacing for Intel/Altera Cyclone IV based > > board > > > > https://gitlab.fel.cvut.cz/canbus/pcie-ctu_can_fd > > > > + > > This look like an unnecessary addition of an empty line. > > > diff --git a/docs/index.rst b/docs/index.rst > > > > index 0b9ee9901d..beb868ca7f 100644 > > > > --- a/docs/index.rst > > > > +++ b/docs/index.rst > > > > @@ -18,3 +18,4 @@ Welcome to QEMU's documentation! > > > > interop/index > > > > specs/index > > > > devel/index > > > > - can > > > > -- > > > > 2.32.0 > > Thomas