Re: [PATCH] MyFirstContribution: render literal *

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Apr 5, 2023 at 12:39 AM Linus Arver <linusa@xxxxxxxxxx> wrote:
> Felipe Contreras <felipe.contreras@xxxxxxxxx> writes:

> > And for what it's worth I would revamp the whole section, something like
> > this:
>
> > --- a/Documentation/MyFirstContribution.txt
> > +++ b/Documentation/MyFirstContribution.txt
> > @@ -1136,18 +1136,18 @@ information on how to handle comments from
> > reviewers.
> >   We'll reuse our `psuh` topic branch for v2. Before we make any changes,
> > we'll
> >   mark the tip of our v1 branch for easy reference:
>
> > -----
> > +....
> >   $ git checkout psuh
> >   $ git branch psuh-v1
> > -----
> > +....
>
>
> While I see the four dots (....) being used to denote regions in other
> files like SubmittingPatches, they are not used at all in
> MyFirstContribution.txt. So I am not sure why we would want to change
> this.

"We" probably don't want to change it, *I* do. Because in AsciiDoc
there's a difference between a listing block and a literal block, but
the Git documentation does a very poor job of being compatible with
AsciiDoc anyway. It doesn't even use the modern syntax. So it probably
doesn't matter.

Cheers.

-- 
Felipe Contreras




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux