Linux 9p file system development
 help / color / mirror / Atom feed
From: Michael Grzeschik <mgr@pengutronix.de>
To: Bagas Sanjaya <bagasdotme@gmail.com>
Cc: Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
	Linux Documentation <linux-doc@vger.kernel.org>,
	Linux USB <linux-usb@vger.kernel.org>,
	Linux Next Mailing List <linux-next@vger.kernel.org>,
	v9fs@lists.linux.dev, Eric Van Hensbergen <ericvh@kernel.org>,
	Latchesar Ionkov <lucho@ionkov.net>,
	Dominique Martinet <asmadeus@codewreck.org>,
	Christian Schoenebeck <linux_oss@crudebyte.com>,
	Jonathan Corbet <corbet@lwn.net>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	Jan Luebbe <jlu@pengutronix.de>,
	Stephen Rothwell <sfr@canb.auug.org.au>
Subject: Re: [PATCH] tools: usb: p9_fwd: wrap USBG shell command examples in literal code blocks
Date: Sun, 8 Sep 2024 22:54:42 +0200	[thread overview]
Message-ID: <Zt4PEp8z1rfhFZCm@pengutronix.de> (raw)
In-Reply-To: <20240908113423.158352-1-bagasdotme@gmail.com>

[-- Attachment #1: Type: text/plain, Size: 2690 bytes --]

Thanks for taking care of this.

On Sun, Sep 08, 2024 at 06:34:23PM +0700, Bagas Sanjaya wrote:
>Stephen Rothwell reported htmldocs warning when merging usb tree:
>
>Documentation/filesystems/9p.rst:99: ERROR: Unexpected indentation.
>
>That's because Sphinx tries rendering p9_fwd.py output as a grid table
>instead.
>
>Wrap shell commands in "USBG Example" section in literal code blocks
>to fix above warning and to be in line with rest of commands in the doc.
>
>Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
>Closes: https://lore.kernel.org/linux-next/20240905184059.0f30ff9a@canb.auug.org.au/
>Fixes: 673f0c3ffc75 ("tools: usb: p9_fwd: add usb gadget packet forwarder script")
>Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>

Acked-by: Michael Grzeschik <m.grzeschik@pengutronix.de>

>---
> Documentation/filesystems/9p.rst | 6 +++---
> 1 file changed, 3 insertions(+), 3 deletions(-)
>
>diff --git a/Documentation/filesystems/9p.rst b/Documentation/filesystems/9p.rst
>index 2cc85f3e8659ff..514ed13a0122b0 100644
>--- a/Documentation/filesystems/9p.rst
>+++ b/Documentation/filesystems/9p.rst
>@@ -86,11 +86,11 @@ When using the usbg transport, for now there is no native usb host
> service capable to handle the requests from the gadget driver. For
> this we have to use the extra python tool p9_fwd.py from tools/usb.
>
>-Just start the 9pfs capable network server like diod/nfs-ganesha e.g.:
>+Just start the 9pfs capable network server like diod/nfs-ganesha e.g.::
>
>         $ diod -f -n -d 0 -S -l 0.0.0.0:9999 -e $PWD
>
>-Optionaly scan your bus if there are more then one usbg gadgets to find their path:
>+Optionaly scan your bus if there are more then one usbg gadgets to find their path::
>
>         $ python $kernel_dir/tools/usb/p9_fwd.py list
>
>@@ -99,7 +99,7 @@ Optionaly scan your bus if there are more then one usbg gadgets to find their pa
>           2 |   67 | unknown          | unknown          | 1d6b:0109 | 2-1.1.2
>           2 |   68 | unknown          | unknown          | 1d6b:0109 | 2-1.1.3
>
>-Then start the python transport:
>+Then start the python transport::
>
>         $ python $kernel_dir/tools/usb/p9_fwd.py --path 2-1.1.2 connect -p 9999
>
>
>base-commit: 9c0c11bb87b09a8b7cdc21ca1090e7b36abe9d09
>-- 
>An old man doll... just what I always wanted! - Clara
>
>

-- 
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
31137 Hildesheim, Germany                  | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

      reply	other threads:[~2024-09-08 20:55 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-09-08 11:34 [PATCH] tools: usb: p9_fwd: wrap USBG shell command examples in literal code blocks Bagas Sanjaya
2024-09-08 20:54 ` Michael Grzeschik [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=Zt4PEp8z1rfhFZCm@pengutronix.de \
    --to=mgr@pengutronix.de \
    --cc=asmadeus@codewreck.org \
    --cc=bagasdotme@gmail.com \
    --cc=corbet@lwn.net \
    --cc=ericvh@kernel.org \
    --cc=gregkh@linuxfoundation.org \
    --cc=jlu@pengutronix.de \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-next@vger.kernel.org \
    --cc=linux-usb@vger.kernel.org \
    --cc=linux_oss@crudebyte.com \
    --cc=lucho@ionkov.net \
    --cc=sfr@canb.auug.org.au \
    --cc=v9fs@lists.linux.dev \
    /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