* Feature request: filling of long captions
@ 2014-02-06 7:46 Andreas Leha
2014-02-06 8:43 ` Bastien
0 siblings, 1 reply; 18+ messages in thread
From: Andreas Leha @ 2014-02-06 7:46 UTC (permalink / raw)
To: emacs-orgmode
Hi all,
a currently active thread about filling
(http://permalink.gmane.org/gmane.emacs.orgmode/77700) reminded me of a
long standing wish of mine: Filling of captions.
Would it be possible to have filling of captions? Ideally that would
mean at least two things: auto-fill and M-q working on long captions.
Example:
--8<---------------cut here---------------start------------->8---
#+name: test
#+begin_src R :results graphics :file tettr.png
plot(1:10, 1:10)
#+end_src
#+results: test
[[file:tettr.png]]
#+caption: A very long long long long long long long long long long long long long long long long long long long long long long long long long long caption.
[[file:tettr.png]]
It would be very convenient if that could be automatically broken to
#+caption: A very long long long long long long long long long long long long long long
#+caption: long long long long long long long long long long long long caption.
[[file:tettr.png]]
--8<---------------cut here---------------end--------------->8---
Regards,
Andreas
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 7:46 Feature request: filling of long captions Andreas Leha
@ 2014-02-06 8:43 ` Bastien
2014-02-06 10:20 ` Andreas Leha
` (2 more replies)
0 siblings, 3 replies; 18+ messages in thread
From: Bastien @ 2014-02-06 8:43 UTC (permalink / raw)
To: Andreas Leha; +Cc: emacs-orgmode
Hi Andreas,
Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
> Would it be possible to have filling of captions?
I guess so.
> Ideally that would mean at least two things: auto-fill and M-q
> working on long captions.
Yes.
Could you list other options that are good candidates for such
auto-filling fonctionality? We'd better implement them all at
once.
Thanks,
--
Bastien
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 8:43 ` Bastien
@ 2014-02-06 10:20 ` Andreas Leha
2014-02-06 10:40 ` Bastien
2014-02-06 17:26 ` Scott Randby
2014-02-06 22:08 ` Andrea Rossetti
2 siblings, 1 reply; 18+ messages in thread
From: Andreas Leha @ 2014-02-06 10:20 UTC (permalink / raw)
To: emacs-orgmode
Hi Bastien,
Bastien <bzg@gnu.org> writes:
> Hi Andreas,
>
> Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
>
>> Would it be possible to have filling of captions?
>
> I guess so.
>
Thanks for the good news! Now I am waiting for christmas ;-)
>> Ideally that would mean at least two things: auto-fill and M-q
>> working on long captions.
>
> Yes.
>
> Could you list other options that are good candidates for such
> auto-filling fonctionality? We'd better implement them all at
> once.
>
Do you mean (1) other places in org files (other than #+caption) or
(2) other functionality that should be supported at #+caption filling?
If (2) than the only other functionality that comes to my mind is M-^
(delete-indentation), which could remove the #+caption on joining with
the previous line.
If (1) than I can't think of anything too obvious. Other candidates
such as '#+header[s]:' or '#+latex_header[_extra]:' might benefit from
some level of additional support, but autofill is not suitable here.
Regards,
Andreas
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 10:20 ` Andreas Leha
@ 2014-02-06 10:40 ` Bastien
2014-02-06 11:14 ` Andreas Leha
0 siblings, 1 reply; 18+ messages in thread
From: Bastien @ 2014-02-06 10:40 UTC (permalink / raw)
To: Andreas Leha; +Cc: emacs-orgmode
Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
> Do you mean (1) other places in org files (other than #+caption) or
> (2) other functionality that should be supported at #+caption
> filling?
Normally lines matching the regexp ^#\+\S-+ (like #+CAPTION) should
not be filled. We would introduce an exception where successive
#+CAPTION lines are correctly parsed by Org -- so the question is
how many of such options should fill like #+CAPTION will do (maybe
before Christmas.)
--
Bastien
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 10:40 ` Bastien
@ 2014-02-06 11:14 ` Andreas Leha
2014-02-06 11:40 ` Thomas Holst
0 siblings, 1 reply; 18+ messages in thread
From: Andreas Leha @ 2014-02-06 11:14 UTC (permalink / raw)
To: emacs-orgmode
Hi Bastien,
Bastien <bzg@gnu.org> writes:
> Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
>
>> Do you mean (1) other places in org files (other than #+caption) or
>> (2) other functionality that should be supported at #+caption
>> filling?
>
> Normally lines matching the regexp ^#\+\S-+ (like #+CAPTION) should
> not be filled. We would introduce an exception where successive
> #+CAPTION lines are correctly parsed by Org -- so the question is
> how many of such options should fill like #+CAPTION will do (maybe
> before Christmas.)
Well, I am not sure that I understand this. #+CAPTION lines are IMO
parsed correctly by Org -- just the filling is missing.
I do not (at the moment) see other 'options' like #+CAPTION that are
missing auto-fill capabilities.
Regards,
Andreas
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 11:14 ` Andreas Leha
@ 2014-02-06 11:40 ` Thomas Holst
0 siblings, 0 replies; 18+ messages in thread
From: Thomas Holst @ 2014-02-06 11:40 UTC (permalink / raw)
To: emacs-orgmode@gnu.org
Hi,
· Andreas Leha <andreas.leha@med.uni-goettingen.de> wrote:
> Hi Bastien,
>
> Bastien <bzg@gnu.org> writes:
>
>> Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
>>
>>> Do you mean (1) other places in org files (other than #+caption) or
>>> (2) other functionality that should be supported at #+caption
>>> filling?
>>
>> Normally lines matching the regexp ^#\+\S-+ (like #+CAPTION) should
>> not be filled. We would introduce an exception where successive
>> #+CAPTION lines are correctly parsed by Org -- so the question is
>> how many of such options should fill like #+CAPTION will do (maybe
>> before Christmas.)
>
> Well, I am not sure that I understand this. #+CAPTION lines are IMO
> parsed correctly by Org -- just the filling is missing.
>
> I do not (at the moment) see other 'options' like #+CAPTION that are
> missing auto-fill capabilities.
what about #+HEADER: for source code blocks. Filling might be difficult since
I don't know if something like:
#+HEADER: :var foo=
#+HEADER: "bar"
is handled correctly by babel parser.
The same holds true for #+ATTR_LATEX:
--
Mit freundlichen Grüßen / Best regards
Thomas Holst
DGS-EC/ESE4
Tel. +49 (711) 811-40681
PC-Fax +49 (711) 811-5182208
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 8:43 ` Bastien
2014-02-06 10:20 ` Andreas Leha
@ 2014-02-06 17:26 ` Scott Randby
2014-02-06 22:08 ` Andrea Rossetti
2 siblings, 0 replies; 18+ messages in thread
From: Scott Randby @ 2014-02-06 17:26 UTC (permalink / raw)
To: emacs-orgmode
On Thu, Feb 6, 2014 at 3:43 AM, Bastien <bzg@gnu.org> wrote:
> Hi Andreas,
>
> Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
>
>> Would it be possible to have filling of captions?
>
> I guess so.
>
>> Ideally that would mean at least two things: auto-fill and M-q
>> working on long captions.
>
> Yes.
>
> Could you list other options that are good candidates for such
> auto-filling fonctionality? We'd better implement them all at
> once.
Filling of table formulas would be nice.
Scott Randby
>
> Thanks,
>
> --
> Bastien
>
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 8:43 ` Bastien
2014-02-06 10:20 ` Andreas Leha
2014-02-06 17:26 ` Scott Randby
@ 2014-02-06 22:08 ` Andrea Rossetti
2014-02-07 2:18 ` Eric Schulte
2 siblings, 1 reply; 18+ messages in thread
From: Andrea Rossetti @ 2014-02-06 22:08 UTC (permalink / raw)
To: Bastien; +Cc: Andreas Leha, emacs-orgmode
Hello Bastien and everyone reading,
Bastien <bzg@gnu.org> writes:
> Could you list other options that are good candidates for such
> auto-filling fonctionality? We'd better implement them all at
> once.
I'd suggest to split the wish-list in two buckets, i.e.
1) some "#+..." commands would benefit of a line-continuation
mechanism (like the backslash at EOL in a multilined C/C++
#define macro)
2) some line-continuation-aware "#+..." commands (thanks to
implementations for step 1) would benefit of auto-filling
To me #+TBLFM seems to fit into bucket 1, #+CAPTION into
bucket 2. My Christmas wish is #+MACRO into bucket 1.
Kindest regards,
Andrea
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-06 22:08 ` Andrea Rossetti
@ 2014-02-07 2:18 ` Eric Schulte
2014-02-07 7:36 ` Andreas Leha
2014-02-07 8:37 ` Nicolas Goaziou
0 siblings, 2 replies; 18+ messages in thread
From: Eric Schulte @ 2014-02-07 2:18 UTC (permalink / raw)
To: Andrea Rossetti; +Cc: Bastien, Andreas Leha, emacs-orgmode
Andrea Rossetti <andrea.rossetti@gmail.com> writes:
> Hello Bastien and everyone reading,
>
> Bastien <bzg@gnu.org> writes:
>> Could you list other options that are good candidates for such
>> auto-filling fonctionality? We'd better implement them all at
>> once.
>
> I'd suggest to split the wish-list in two buckets, i.e.
>
> 1) some "#+..." commands would benefit of a line-continuation
> mechanism (like the backslash at EOL in a multilined C/C++
> #define macro)
>
> 2) some line-continuation-aware "#+..." commands (thanks to
> implementations for step 1) would benefit of auto-filling
>
> To me #+TBLFM seems to fit into bucket 1, #+CAPTION into
> bucket 2. My Christmas wish is #+MACRO into bucket 1.
>
> Kindest regards,
>
> Andrea
>
For a while now I've been wishing that keywords (namely #+Caption:)
could be equivalently specified as blocks (e.g., #+begin/end_Caption:).
Would that be another possible solution here?
Best,
--
Eric Schulte
https://cs.unm.edu/~eschulte
PGP: 0x614CA05D
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 2:18 ` Eric Schulte
@ 2014-02-07 7:36 ` Andreas Leha
2014-02-07 8:37 ` Nicolas Goaziou
1 sibling, 0 replies; 18+ messages in thread
From: Andreas Leha @ 2014-02-07 7:36 UTC (permalink / raw)
To: emacs-orgmode
Eric Schulte <schulte.eric@gmail.com> writes:
> Andrea Rossetti <andrea.rossetti@gmail.com> writes:
>
>> Hello Bastien and everyone reading,
>>
>> Bastien <bzg@gnu.org> writes:
>>> Could you list other options that are good candidates for such
>>> auto-filling fonctionality? We'd better implement them all at
>>> once.
>>
>> I'd suggest to split the wish-list in two buckets, i.e.
>>
>> 1) some "#+..." commands would benefit of a line-continuation
>> mechanism (like the backslash at EOL in a multilined C/C++
>> #define macro)
>>
>> 2) some line-continuation-aware "#+..." commands (thanks to
>> implementations for step 1) would benefit of auto-filling
>>
>> To me #+TBLFM seems to fit into bucket 1, #+CAPTION into
>> bucket 2. My Christmas wish is #+MACRO into bucket 1.
>>
>> Kindest regards,
>>
>> Andrea
>>
>
> For a while now I've been wishing that keywords (namely #+Caption:)
> could be equivalently specified as blocks (e.g., #+begin/end_Caption:).
>
> Would that be another possible solution here?
I can not think of any downside, so I guess it would work at least
as well for me.
It might be harder to implement, since multiple caption lines are
already parsed correctly by Org.
The begin/end_caption blocks would have their advantages in terms of
syntax highlighting / readability of the Org buffer.
Regards,
Andreas
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 2:18 ` Eric Schulte
2014-02-07 7:36 ` Andreas Leha
@ 2014-02-07 8:37 ` Nicolas Goaziou
2014-02-07 8:47 ` Bastien
1 sibling, 1 reply; 18+ messages in thread
From: Nicolas Goaziou @ 2014-02-07 8:37 UTC (permalink / raw)
To: Eric Schulte; +Cc: Bastien, Andrea Rossetti, emacs-orgmode, Andreas Leha
Hello,
Eric Schulte <schulte.eric@gmail.com> writes:
> For a while now I've been wishing that keywords (namely #+Caption:)
> could be equivalently specified as blocks (e.g., #+begin/end_Caption:).
>
> Would that be another possible solution here?
That would defeat the purpose of the distinction between a block and an
affiliated keyword (i.e., a property added to that block). Besides the
change of paradigm, it would introduce a lot of problems (handle syntax
limitation in such block, for example, since I assume plain lists would
be forbidden).
Also, current syntax also handles short captions, so you would have to
rely on another trick for them.
I'm sure this idea wouldn't be a net benefit for Org syntax clarity,
even for the occasional three lines caption need.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 8:37 ` Nicolas Goaziou
@ 2014-02-07 8:47 ` Bastien
2014-02-07 9:56 ` Nicolas Goaziou
2014-02-07 16:49 ` Eric Schulte
0 siblings, 2 replies; 18+ messages in thread
From: Bastien @ 2014-02-07 8:47 UTC (permalink / raw)
To: Nicolas Goaziou
Cc: Andrea Rossetti, emacs-orgmode, Andreas Leha, Eric Schulte
Hi all,
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> I'm sure this idea wouldn't be a net benefit for Org syntax clarity,
> even for the occasional three lines caption need.
I agree.
Nicolas, what do you think of enhancing the auto-filling (and
delete-indentation) capabilities for some affiliated keywords?
#+CAPTION:
#+HEADER:
#+TBLFM:
The last two would require special auto-filling functions,
but at least for #+TBLFM I see the point of enabling this.
Thanks,
--
Bastien
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 8:47 ` Bastien
@ 2014-02-07 9:56 ` Nicolas Goaziou
2014-02-07 10:12 ` Andreas Leha
2014-02-07 16:49 ` Eric Schulte
1 sibling, 1 reply; 18+ messages in thread
From: Nicolas Goaziou @ 2014-02-07 9:56 UTC (permalink / raw)
To: Bastien; +Cc: Andrea Rossetti, emacs-orgmode, Andreas Leha, Eric Schulte
Hello,
> Nicolas, what do you think of enhancing the auto-filling (and
> delete-indentation) capabilities for some affiliated keywords?
>
> #+CAPTION:
> #+HEADER:
> #+TBLFM:
Not that it matters much, but "TBLFM" is not an affiliated keyword per
se, it belongs to the table syntax. OTOH, you can have "CAPTION" and
"HEADER" keywords on top of almost any element type.
Anyway, the three keywords are very different.
To start with the one I know the most, CAPTION can have an optional
value, and multiple caption lines can have as many optional values.
#+CAPTION[short caption]: long caption
#+CAPTION[short caption, continued]: long caption, continued.
Therefore, filling it can be tricky since you have to pay attention to
both values.
Moreover, if the "short" caption is too long to fit on one line, that
line still needs to end with "]:" to be valid.
#+CAPTION[very very ... long "short" caption]:
#+CAPTION[continued even here]: long caption
#+CAPTION: long caption continued.
The difficulty lies elsewhere for "HEADER" and "TBLFM". The question is:
can we split a HEADER or TBLFM line anywhere, e.g., in the between
a keyword and its value (or at a space in the middle of a value) for the
former, and in the middle of a formula in the latter? It depends on how
"org-table.el" and "ob.el" read these keywords. I didn't check.
Also, please bear in mind that filling functions have unit tests, so any
new feature ought to be also tested.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 9:56 ` Nicolas Goaziou
@ 2014-02-07 10:12 ` Andreas Leha
2014-02-07 10:28 ` Bastien
0 siblings, 1 reply; 18+ messages in thread
From: Andreas Leha @ 2014-02-07 10:12 UTC (permalink / raw)
To: emacs-orgmode
Hello,
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> Hello,
>
>> Nicolas, what do you think of enhancing the auto-filling (and
>> delete-indentation) capabilities for some affiliated keywords?
>>
>> #+CAPTION:
>> #+HEADER:
>> #+TBLFM:
>
> Not that it matters much, but "TBLFM" is not an affiliated keyword per
> se, it belongs to the table syntax. OTOH, you can have "CAPTION" and
> "HEADER" keywords on top of almost any element type.
>
> Anyway, the three keywords are very different.
>
> To start with the one I know the most, CAPTION can have an optional
> value, and multiple caption lines can have as many optional values.
>
> #+CAPTION[short caption]: long caption
> #+CAPTION[short caption, continued]: long caption, continued.
>
> Therefore, filling it can be tricky since you have to pay attention to
> both values.
>
> Moreover, if the "short" caption is too long to fit on one line, that
> line still needs to end with "]:" to be valid.
>
> #+CAPTION[very very ... long "short" caption]:
> #+CAPTION[continued even here]: long caption
> #+CAPTION: long caption continued.
>
This is something, that I had not thought about when I expressed my
wish. I did not even know, that consecutive #+CAPTION lines could also
have consecutive short captions. I see the difficulty here.
Usually, my votes are in favour of backwards compatibility. So, I am
not too sure about this suggestion myself: But here an obvious
'solution' would be to move the short caption to #+SHORT_CAPTION.
I see that such change would bring its own difficulties besides breaking
the backwards compatibility. Like what to do when there is a short
caption but no 'long' caption.
I am just continuing this discussion, as I do not have 'the occasional
three lines caption need' but the 'always multi-lines caption need'. In
my opinion, images in an article/paper/thesis/... should tell their
story independently of the text referring to them. So, my captions
tend to be (too?) long.
So, I would benefit a lot from whatever filling mechanism might get
implemented.
[...]
Regards,
Andreas
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 10:12 ` Andreas Leha
@ 2014-02-07 10:28 ` Bastien
2014-02-07 10:30 ` Nicolas Goaziou
0 siblings, 1 reply; 18+ messages in thread
From: Bastien @ 2014-02-07 10:28 UTC (permalink / raw)
To: Andreas Leha; +Cc: emacs-orgmode
Andreas Leha <andreas.leha@med.uni-goettingen.de> writes:
> But here an obvious
> 'solution' would be to move the short caption to #+SHORT_CAPTION.
Yes. #+CAPTION[...]: is clumsy.
--
Bastien
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 10:28 ` Bastien
@ 2014-02-07 10:30 ` Nicolas Goaziou
2014-02-07 10:35 ` Bastien
0 siblings, 1 reply; 18+ messages in thread
From: Nicolas Goaziou @ 2014-02-07 10:30 UTC (permalink / raw)
To: Bastien; +Cc: Andreas Leha, emacs-orgmode
Bastien <bzg@gnu.org> writes:
> Yes. #+CAPTION[...]: is clumsy.
It follows #+RESULTS[...]: model.
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 10:30 ` Nicolas Goaziou
@ 2014-02-07 10:35 ` Bastien
0 siblings, 0 replies; 18+ messages in thread
From: Bastien @ 2014-02-07 10:35 UTC (permalink / raw)
To: Nicolas Goaziou; +Cc: Andreas Leha, emacs-orgmode
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> Bastien <bzg@gnu.org> writes:
>
>> Yes. #+CAPTION[...]: is clumsy.
>
> It follows #+RESULTS[...]: model.
Which I feel clumsy too :) No offense to either Eric or you.
The important difference is that #+RESULTS[...] is generated,
while #+CAPTION[...] is manually entered. As a user, I'm more
tolerant to generated clumsy syntax than to the one I need to
*learn*.
Anyway, that's kinda bikeshed for now.
--
Bastien
^ permalink raw reply [flat|nested] 18+ messages in thread
* Re: Feature request: filling of long captions
2014-02-07 8:47 ` Bastien
2014-02-07 9:56 ` Nicolas Goaziou
@ 2014-02-07 16:49 ` Eric Schulte
1 sibling, 0 replies; 18+ messages in thread
From: Eric Schulte @ 2014-02-07 16:49 UTC (permalink / raw)
To: Bastien; +Cc: emacs-orgmode, Andrea Rossetti, Nicolas Goaziou, Andreas Leha
Bastien <bzg@gnu.org> writes:
> Hi all,
>
> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>
>> I'm sure this idea wouldn't be a net benefit for Org syntax clarity,
>> even for the occasional three lines caption need.
>
> I agree.
>
> Nicolas, what do you think of enhancing the auto-filling (and
> delete-indentation) capabilities for some affiliated keywords?
>
I did not realize that consecutive caption lines would be merged. This
largely addresses my problem (no more Org-mode files going to column
600).
If Org-mode had been thoughtful enough to autofill my #+Column lines as
they got too long then I would have been completely satisfied.
Thanks,
>
> #+CAPTION:
> #+HEADER:
> #+TBLFM:
>
> The last two would require special auto-filling functions,
> but at least for #+TBLFM I see the point of enabling this.
>
> Thanks,
--
Eric Schulte
https://cs.unm.edu/~eschulte
PGP: 0x614CA05D
^ permalink raw reply [flat|nested] 18+ messages in thread
end of thread, other threads:[~2014-02-07 16:56 UTC | newest]
Thread overview: 18+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-02-06 7:46 Feature request: filling of long captions Andreas Leha
2014-02-06 8:43 ` Bastien
2014-02-06 10:20 ` Andreas Leha
2014-02-06 10:40 ` Bastien
2014-02-06 11:14 ` Andreas Leha
2014-02-06 11:40 ` Thomas Holst
2014-02-06 17:26 ` Scott Randby
2014-02-06 22:08 ` Andrea Rossetti
2014-02-07 2:18 ` Eric Schulte
2014-02-07 7:36 ` Andreas Leha
2014-02-07 8:37 ` Nicolas Goaziou
2014-02-07 8:47 ` Bastien
2014-02-07 9:56 ` Nicolas Goaziou
2014-02-07 10:12 ` Andreas Leha
2014-02-07 10:28 ` Bastien
2014-02-07 10:30 ` Nicolas Goaziou
2014-02-07 10:35 ` Bastien
2014-02-07 16:49 ` Eric Schulte
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).