is there a rationale for the numerous "^::$" lines:

is there a rationale for the numerous "^::$" lines:

[Robert P. J. Day]

  just noticed the myriad of .rst content of the form:

  ... blah blah woof woof:
  ::

     code snippet

if memory serves, that would be equivalent to the simpler:

  ... blah blah woof woof::

      code snippet

as a trailing "::", as long as it is not preceded by white space, has
the same effect. not suggesting massive refactoring, just wondering if
there is a subtle difference between the two.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: [docs] is there a rationale for the numerous "^::$" lines:

[Nicolas Dechesne]

On Thu, Oct 29, 2020 at 8:58 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
>
>

you are correct, they are equivalent. we've been rushing with these
changes, and it's lack of consistency

>   just noticed the myriad of .rst content of the form:
>
>   ... blah blah woof woof:
>   ::
>
>      code snippet
>
> if memory serves, that would be equivalent to the simpler:
>
>   ... blah blah woof woof::

I tend to prefer this form, and I tried to use this one for the files
I edited.. We should agree on which one to use, and fix
inconsistencies.

>
>       code snippet
>
> as a trailing "::", as long as it is not preceded by white space, has
> the same effect. not suggesting massive refactoring, just wondering if
> there is a subtle difference between the two.


>
> rday
>
> --
>
> ========================================================================
> Robert P. J. Day                                 Ottawa, Ontario, CANADA
>                          http://crashcourse.ca
>
> LinkedIn:                               http://ca.linkedin.com/in/rpjday
> ========================================================================
>
> 
>

Re: [docs] is there a rationale for the numerous "^::$" lines:

[Robert P. J. Day]

On Thu, 29 Oct 2020, Nicolas Dechesne wrote:

> On Thu, Oct 29, 2020 at 8:58 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> >
> >
>
> you are correct, they are equivalent. we've been rushing with these
> changes, and it's lack of consistency
>
> >   just noticed the myriad of .rst content of the form:
> >
> >   ... blah blah woof woof:
> >   ::
> >
> >      code snippet
> >
> > if memory serves, that would be equivalent to the simpler:
> >
> >   ... blah blah woof woof::
>
> I tend to prefer this form, and I tried to use this one for the files
> I edited.. We should agree on which one to use, and fix
> inconsistencies.

  if no one objects, i can probably whip up a perl script this weekend
and transmogrify all of this to the shorter form for consistency.

rday

Re: [docs] is there a rationale for the numerous "^::$" lines:

[Nicolas Dechesne]

On Thu, Oct 29, 2020 at 9:53 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
>
> On Thu, 29 Oct 2020, Nicolas Dechesne wrote:
>
> > On Thu, Oct 29, 2020 at 8:58 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> > >
> > >
> >
> > you are correct, they are equivalent. we've been rushing with these
> > changes, and it's lack of consistency
> >
> > >   just noticed the myriad of .rst content of the form:
> > >
> > >   ... blah blah woof woof:
> > >   ::
> > >
> > >      code snippet
> > >
> > > if memory serves, that would be equivalent to the simpler:
> > >
> > >   ... blah blah woof woof::
> >
> > I tend to prefer this form, and I tried to use this one for the files
> > I edited.. We should agree on which one to use, and fix
> > inconsistencies.
>
>   if no one objects, i can probably whip up a perl script this weekend
> and transmogrify all of this to the shorter form for consistency.

what if I object to doing that with perl ;)

>
> rday

Re: [docs] is there a rationale for the numerous "^::$" lines:

[Robert P. J. Day]

On Thu, 29 Oct 2020, Nicolas Dechesne wrote:

> On Thu, Oct 29, 2020 at 9:53 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> >
> > On Thu, 29 Oct 2020, Nicolas Dechesne wrote:
> >
> > > On Thu, Oct 29, 2020 at 8:58 PM Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> > > >
> > > >
> > >
> > > you are correct, they are equivalent. we've been rushing with these
> > > changes, and it's lack of consistency
> > >
> > > >   just noticed the myriad of .rst content of the form:
> > > >
> > > >   ... blah blah woof woof:
> > > >   ::
> > > >
> > > >      code snippet
> > > >
> > > > if memory serves, that would be equivalent to the simpler:
> > > >
> > > >   ... blah blah woof woof::
> > >
> > > I tend to prefer this form, and I tried to use this one for the files
> > > I edited.. We should agree on which one to use, and fix
> > > inconsistencies.
> >
> >   if no one objects, i can probably whip up a perl script this weekend
> > and transmogrify all of this to the shorter form for consistency.
>
> what if I object to doing that with perl ;)

COBOL it is then.

rday