[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#30139: 25.3; Passing callback to align-region raises an error when u
From: |
Eli Zaretskii |
Subject: |
bug#30139: 25.3; Passing callback to align-region raises an error when using `justify` rule |
Date: |
Sat, 03 Mar 2018 13:11:33 +0200 |
Ping!
> Date: Sat, 24 Feb 2018 12:21:04 +0200
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: 30139@debbugs.gnu.org, k.michal@zoho.com
>
> > Date: Wed, 21 Feb 2018 20:30:00 +0200
> > From: Eli Zaretskii <eliz@gnu.org>
> > Cc: 30139@debbugs.gnu.org
> >
> > > From: MichaĆ Kondraciuk <k.michal@zoho.com>
> > > Date: Tue, 20 Feb 2018 22:07:10 +0100
> > >
> > > is there any news on the status of this bug? Should I just send the
> > > patch to emacs-devel?
> >
> > Sorry for the delay, I will look at the patch soon.
>
> John, could you please have a look at this?
>
> Btw, I find the documentation in align.el hard to understand. It
> sounds like a very powerful feature, but I would have difficulties
> using it, with the doc strings as my only guidance. Some examples of
> unclear or confusing documentation:
>
> . align-region-separate has this to describe the 'group' method:
>
> Each contiguous set of lines where a specific alignment occurs is
> considered a section for that alignment rule.
>
> What is a "contiguous set of lines"? Does it mean non-empty lines,
> i.e. that groups are separated by empty lines (that's what the
> example seems to imply)?
>
> . align-rules-list has this to describe the 'group' attribute:
>
> [...] For alignment rules, these are the characters that will be
> deleted/expanded for the purposes of alignment. The "alignment
> character" is always the first character immediately following
> this parenthesis group. This attribute may also be a list of
> integers, in which case multiple alignment characters will be
> aligned, with the list of integers identifying the whitespace
> groups which precede them. The default for this attribute is 1.
>
> Which "this parenthesis group" is being alluded to here? Also, it
> leaves unexplained how characters are specified by integers, and
> the meaning of the default value of 1 is thus unclear.
>
> So patches to clarify the documentation in align.el are most welcome.
>
>
>
>
- bug#30139: 25.3; Passing callback to align-region raises an error when using `justify` rule,
Eli Zaretskii <=