# [PATCH] doc: fast-import: replace literal block with paragraph

3 messages from 2025-09-08 to 2025-09-08. Participants: kristofferhaugsbakk@fastmail.com, Jeff King.
Thread: https://gitlist.dev/t/64114

## kristofferhaugsbakk@fastmail.com, 2025-09-08 20:28

Subject: [PATCH] doc: fast-import: replace literal block with paragraph
Message-ID: <09aaad696895c18c6d4dda7d6a2f4b77f84f39ba.1757363213.git.code@khaugsbakk.name>
URL: https://gitlist.dev/e/09aaad696895c18c6d4dda7d6a2f4b77f84f39ba.1757363213.git.code%40khaugsbakk.name

```
From: Kristoffer Haugsbakk <code@khaugsbakk.name>

68061e34702 (fast-import: disallow "feature export-marks" by default,
2019-08-29) added the documentation for this option.  The second
paragraph is a literal block but it looks like it should just be
a regular paragraph.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---

Notes (series):
    > but it looks like it should just be a regular paragraph.
    
    ... unless this is some kind of callout-block style?

 Documentation/git-fast-import.adoc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/git-fast-import.adoc b/Documentation/git-fast-import.adoc
index 3144ffcdb68..c3951f5f879 100644
--- a/Documentation/git-fast-import.adoc
+++ b/Documentation/git-fast-import.adoc
@@ -61,10 +61,10 @@ OPTIONS
 	currently impacts only the `export-marks`, `import-marks`, and
 	`import-marks-if-exists` feature commands.
 +
-	Only enable this option if you trust the program generating the
-	fast-import stream! This option is enabled automatically for
-	remote-helpers that use the `import` capability, as they are
-	already trusted to run their own code.
+Only enable this option if you trust the program generating the
+fast-import stream! This option is enabled automatically for
+remote-helpers that use the `import` capability, as they are
+already trusted to run their own code.
 
 Options for Frontends
 ~~~~~~~~~~~~~~~~~~~~~

base-commit: 2462961280690837670d997bde64bd4ebf8ae66d
-- 
2.51.0.16.gcd94ab5bf81


```

## Jeff King, 2025-09-08 21:05

Subject: Re: [PATCH] doc: fast-import: replace literal block with paragraph
Message-ID: <20250908210546.GA1327610@coredump.intra.peff.net>
URL: https://gitlist.dev/e/20250908210546.GA1327610%40coredump.intra.peff.net
In-Reply-To: <09aaad696895c18c6d4dda7d6a2f4b77f84f39ba.1757363213.git.code@khaugsbakk.name>

```
On Mon, Sep 08, 2025 at 10:28:45PM +0200, kristofferhaugsbakk@fastmail.com wrote:

>     > but it looks like it should just be a regular paragraph.
>     
>     ... unless this is some kind of callout-block style?

Nope, I think it was just a mistake on my part. IIRC it is a common
asciidoc pitfall not to remove indentation when doing a continuation
block. Your patch looks like the right fix. Thanks for finding it.

-Peff

```

## kristofferhaugsbakk@fastmail.com, 2025-09-08 21:20

Subject: [PATCH v2] doc: fast-import: replace literal block with paragraph
Message-ID: <724b975078daf11e17f26472c0da5638a5d1ca86.1757366352.git.code@khaugsbakk.name>
URL: https://gitlist.dev/e/724b975078daf11e17f26472c0da5638a5d1ca86.1757366352.git.code%40khaugsbakk.name
In-Reply-To: <09aaad696895c18c6d4dda7d6a2f4b77f84f39ba.1757363213.git.code@khaugsbakk.name>

```
From: Kristoffer Haugsbakk <code@khaugsbakk.name>

68061e34702 (fast-import: disallow "feature export-marks" by default,
2019-08-29) added the documentation for this option.  The second
paragraph is a literal block but it looks like it should just be
a regular paragraph.

Acked-by: Jeff King <peff@peff.net>
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---

Notes (series):
    v1:
    
    > but it looks like it should just be a regular paragraph.
    
    ... unless this is some kind of callout-block style?

 Documentation/git-fast-import.adoc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/git-fast-import.adoc b/Documentation/git-fast-import.adoc
index 3144ffcdb68..c3951f5f879 100644
--- a/Documentation/git-fast-import.adoc
+++ b/Documentation/git-fast-import.adoc
@@ -61,10 +61,10 @@ OPTIONS
 	currently impacts only the `export-marks`, `import-marks`, and
 	`import-marks-if-exists` feature commands.
 +
-	Only enable this option if you trust the program generating the
-	fast-import stream! This option is enabled automatically for
-	remote-helpers that use the `import` capability, as they are
-	already trusted to run their own code.
+Only enable this option if you trust the program generating the
+fast-import stream! This option is enabled automatically for
+remote-helpers that use the `import` capability, as they are
+already trusted to run their own code.
 
 Options for Frontends
 ~~~~~~~~~~~~~~~~~~~~~

Range-diff against v1:
1:  09aaad69689 ! 1:  724b975078d doc: fast-import: replace literal block with paragraph
    @@ Commit message
         paragraph is a literal block but it looks like it should just be
         a regular paragraph.
     
    +    Acked-by: Jeff King <peff@peff.net>
         Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
     
     
      ## Notes (series) ##
    +    v1:
    +
         > but it looks like it should just be a regular paragraph.
     
         ... unless this is some kind of callout-block style?

base-commit: 2462961280690837670d997bde64bd4ebf8ae66d
-- 
2.51.0.16.gcd94ab5bf81


```
