org-add-note puts a '\\' at the end of the first line. Is it expected
the user will put '\\' at the end of each line of a multiline note
(except the last line)? Why is this done?
--
David Masterson
David Masterson writes:
> org-add-note puts a '\\' at the end of the first line. Is it expected
> the user will put '\\' at the end of each line of a multiline note
> (except the last line)?
No.
> .. Why is this done?
To prevent fill-region from concatenating the auto-generated text in the
fi
Ihor Radchenko writes:
> David Masterson writes:
>
>> org-add-note puts a '\\' at the end of the first line. Is it expected
>> the user will put '\\' at the end of each line of a multiline note
>> (except the last line)?
>
> No.
>
>> .. Why is this done?
>
> To prevent fill-region from concaten
(info "(org) Paragraphs")
On 12/4/23, David Masterson wrote:
> Ihor Radchenko writes:
>
>> David Masterson writes:
>>
>>> org-add-note puts a '\\' at the end of the first line. Is it expected
>>> the user will put '\\' at the end of each line of a multiline note
>>> (except the last line)?
>>
Samuel Wales writes:
> On 12/4/23, David Masterson wrote:
>> Ihor Radchenko writes:
>>
>>> David Masterson writes:
>>>
org-add-note puts a '\\' at the end of the first line. Is it expected
the user will put '\\' at the end of each line of a multiline note
(except the last line)
David Masterson writes:
>> To prevent fill-region from concatenating the auto-generated text in the
>> first line and the user input in the following lines.
>
> Ah. Is that mentioned somewhere in the Org manual? I don't mean the
> details of filll-region, but a little something to answer "why i
Ihor Radchenko writes:
> David Masterson writes:
>
>>> To prevent fill-region from concatenating the auto-generated text in the
>>> first line and the user input in the following lines.
>>
>> Ah. Is that mentioned somewhere in the Org manual? I don't mean the
>> details of fill-region, but a l
David Masterson writes:
> Hmm. glancing through the manual, there is a bit of assumption implicit
> about the use of '\\'. We had the problem with Unix Shell scripts that
> we would need a backslash at the end of a line to prevent the EOL as
> being interpreted as end-of-input. Depending on the
Ihor Radchenko writes:
> David Masterson writes:
>
>> Hmm. glancing through the manual, there is a bit of assumption implicit
>> about the use of '\\'. We had the problem with Unix Shell scripts that
>> we would need a backslash at the end of a line to prevent the EOL as
>> being interpreted as
David Masterson writes:
>> We do document the line breaks in
>> https://orgmode.org/manual/Paragraphs.html
>
> The only thing I see with respect to '\\' is:
>
> Paragraphs are separated by at least one empty line. If you need to
> enforce a line break within a paragraph, use ‘\\’ at the end
Ihor Radchenko writes:
> David Masterson writes:
>
>>> We do document the line breaks in
>>> https://orgmode.org/manual/Paragraphs.html
>>
>> The only thing I see with respect to '\\' is:
>>
>> Paragraphs are separated by at least one empty line. If you need to
>> enforce a line break withi
David Masterson writes:
>> The detailed reason why we use this particular markup is that
>> otherwise some internal code assumptions inside Org mode may break when
>> users run `fill-region' on the notes. This is an internal implementation
>> detail which should not be explained in the manual.
>
Ihor Radchenko writes:
> David Masterson writes:
>
>>> The detailed reason why we use this particular markup is that
>>> otherwise some internal code assumptions inside Org mode may break when
>>> users run `fill-region' on the notes. This is an internal implementation
>>> detail which should no
David Masterson writes:
>> No. See `org-skip-over-state-notes'.
>
> Hmm. The docstring on that should discuss what it's looking for to say
> "this is the end of the state notes". Does a plain note (org-add-note)
> count as a state note?
Yes, it does.
I tried to improve a docstring a little on m
Ihor Radchenko writes:
> Patches welcome.
* What is my status as far as submitting patches to documentation
(including docstrings)?
* Is there a write-up on the process of "patching" I can follow?
--
David Masterson
David Masterson writes:
> Ihor Radchenko writes:
>
>> Patches welcome.
>
> * What is my status as far as submitting patches to documentation
> (including docstrings)?
I can see two commits of yours in Org repo. Beyond the 15LOC limit.
So, we cannot accept more TINYCHANGE patches and need FSF
Ihor Radchenko writes:
> David Masterson writes:
>
>> Ihor Radchenko writes:
>>
>>> Patches welcome.
>>
>> * What is my status as far as submitting patches to documentation
>> (including docstrings)?
>
> I can see two commits of yours in Org repo. Beyond the 15LOC limit.
> So, we cannot accep
David Masterson writes:
> The form for copyright assignment asks what files have you changed so
> far. I assumed the form would be universal for any past and future
> changes you make to the program (Emacs). Do people really need to fill
> that part out? Do I need the info from the 2 commits?
I
18 matches
Mail list logo