git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 2/4] notes doc: tidy up `--no-stripspace` paragraph

From
Teng Long <dyroneteng@gmail.com>
Date
Aug 17, 2023, 02:52 UTC
Message-ID
<20230817025222.75033-1-tenglong.tl@alibaba-inc.com>
In-Reply-To
<f2e31e70ff6cbf105d00aa5d1188554def34e142.1692194193.git.martin.agren@gmail.com>
"Martin Ågren" <martin.agren@gmail.com> writes:
> Where we document the `--no-stripspace` option, remove a superfluous
> "For" to fix the grammar. Mark option names and command names using
> `backticks` to set them in monospace.
Show 19 quoted lines
> Signed-off-by: Martin Ågren <martin.agren@gmail.com>
> ---
>  Documentation/git-notes.txt | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt
> index 9043274ce8..f8310e56a8 100644
> --- a/Documentation/git-notes.txt
> +++ b/Documentation/git-notes.txt
> @@ -179,9 +179,9 @@ OPTIONS
>  --[no-]stripspace::
>  	Strip leading and trailing whitespace from the note message.
>  	Also strip out empty lines other than a single line between
> -	paragraphs. For lines starting with `#` will be stripped out
> -	in non-editor cases like "-m", "-F" and "-C", but not in
> -	editor case like "git notes edit", "-c", etc.
> +	paragraphs. Lines starting with `#` will be stripped out
> +	in non-editor cases like `-m`, `-F` and `-C`, but not in
> +	editor case like `git notes edit`, `-c`, etc.

Oops! I didn't notice to distingush ` and ", there are some places still using ", but here we think to use ` is the apppropriate way to surround option and command, etc. in docs, right?

>  --ref <ref>::
>  	Manipulate the notes tree in <ref>.  This overrides
> -- 
> 2.42.0.rc2.215.g538df5cf27
Thanks for fixing this.
Previous: Martin ÅgrenNext: Martin Ågren
Message 9 of 12 in “some doc fixes on v2.42.0-rc2”
  1. 0/4 some doc fixes on v2.42.0-rc2Martin Ågren, Aug 16, 2023
  2. 1/4 notes doc: split up run-on sentencesMartin Ågren, Aug 16, 2023
  3. 1/4 notes doc: split up run-on sentencesTeng Long, Aug 17, 2023
  4. 4/4 rev-list-options: fix typo in `--stdin` documentationMartin Ågren, Aug 16, 2023
  5. Junio C HamanoAug 16, 2023
  6. Junio C HamanoAug 16, 2023
  7. Martin ÅgrenAug 17, 2023
  8. 2/4 notes doc: tidy up `--no-stripspace` paragraphMartin Ågren, Aug 16, 2023
  9. 2/4 notes doc: tidy up `--no-stripspace` paragraphTeng Long, Aug 17, 2023
  10. Martin ÅgrenAug 17, 2023
  11. 3/4 show-ref doc: fix carets in monospaceMartin Ågren, Aug 16, 2023
  12. Junio C HamanoAug 16, 2023

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.