Re: No more big code changes to Leo

[jkn]

I'm pleased to see this change - those hanging indented comments always me
twitch a little  when I browsed the codebase. I wasn't going to make a noise
about it because ... hey, it's your code ... but FWIW I think this is 
useful work.

J^n


On Tuesday, April 26, 2022 at 3:31:02 AM UTC+1 Edward K. Ream wrote:

>
>
> On Monday, April 25, 2022 at 9:00:08 AM UTC-5 Edward K. Ream wrote:
>
> > My subconscious complained doing the work by hand.
>
> Not my subconscious, my inner critic. Anyway, I developed the script and 
> removed hanging comments in less than 24 hours.  See PR #2622 
> .  I'll merge this PR 
> into devel after releasing 6.6.1.
>
> When I see the results, I wonder why hanging indents were a good idea.
>
> Edward
>

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/791b9d4e-6577-4759-8875-49bf0e034fd0n%40googlegroups.com.

Re: No more big code changes to Leo

[Edward K. Ream]

On Tuesday, April 26, 2022 at 5:26:58 AM UTC-5 jkn wrote:

> I'm pleased to see this change - those hanging indented comments always me
> twitch a little  when I browsed the codebase. I wasn't going to make a 
> noise
> about it because ... hey, it's your code ... but FWIW I think this is 
> useful work.
>

Thanks. As I made the changes I became more and more dissatisfied with the 
hanging comments.

Edward

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/f4a6247b-d2bc-412e-9ee4-45ca0d487797n%40googlegroups.com.

Leo will never write pep-8 style sentinels

[Edward K. Ream]

This post is part of Leo's transition to maintenance mode.

At present, Leo can *read *external files that have been "blackened". That 
is, Leo allows whitespace between the opening comment delim ('#' for 
python) and the following `@' characters. However, Leo does not write 
sentinel lines in pep 8 format.

*Leo will never write pep-8 sentinels*

Here are my reasons:

1. Pep 8 conventions do not apply. Leo's sentinels predate python! Users do 
not see Leo's sentinels, so readability or stylistic issues are irrelevant.

2. Writing `# @` instead of `#@` would be wrong. Old versions of Leo would 
not be able to read external files containing those sentinels.

3. There are several easy and obvious workarounds for those who want to 
beautify their external files with black, including using `@clean` instead 
of `@file`.

*Summary*

I will reject proposals to add command-line options or user settings to 
change how Leo writes sentinels.

I have just created info issue #2625 
 as a permanent 
version of this post.

Edward

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/caa993a0-6238-4fc3-969d-6c1b51fb97b2n%40googlegroups.com.

How To Make New Features Known?

[tbp1...@gmail.com]

I'm particularly thinking of new UI features, which are mostly turned off 
by default and need to be turned on by new settings.  For the most part, 
only a few people who read about them here in Groups will see them, and 
most of those won't remember later.  New users won't know about them.  And 
where does one go to find the right settings?

An example is the relatively new highlighting of the cursor line in the 
body editor.  In this case, I added a new item to the Help menu with a 
description and the settings.  For the upcoming (after Leo 6.6.1) right 
margin guide line, I also added a new Help menu item.

But that's not a good long term solution, and anyway, who looks closely at 
their Help menu?

Looking through the list of settings is rather overwhelming, especially if 
you don't even know what to look for.

The Leo User's Guide is unlikely to be current enough, and, again, who is 
going to look through the whole thing looking for new features?

One of the Leo docs has a brief list of new features for various releases, 
but I never remember which one or where it is.

So how to improve the situation?  At the moment, I favor adding a What's 
New? menu.  As a feature ages, it would move further down the list, and 
perhaps eventually drop off.  Each item should have a description and 
include the settings needed to make it work.

Since menu items are implemented by launching commands, there would be a 
command for each such item, and so it could be launched from the minibuffer 
(if one could remember how to find it).  It would be similar to how the 
Plugins menu has a help page for the various plugins.

I don't think this would be the whole solution, but it would be a good 
start.

Please chip in here with your thoughts.

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/cab5a14c-b69c-459a-985d-381f6e6cc89en%40googlegroups.com.

Re: How To Make New Features Known?

[Edward K. Ream]

On Tue, Apr 26, 2022 at 1:13 PM tbp1...@gmail.com 
wrote:

> I'm particularly thinking of new UI features, which are mostly turned off
> by default and need to be turned on by new settings.  For the most part,
> only a few people who read about them here in Groups will see them, and
> most of those won't remember later.  New users won't know about them.  And
> where does one go to find the right settings?


This is a FAQ, although there may not be a FAQ entry.

Imo, the best answer is to look in leoSettings.leo. It's authoritative,
it's up-to-date, and it's searchable.

All other solutions require continuous attention from devs. In my
experience, such attention is too much to expect.

Edward

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/CAMF8tS0rUA5Gicg%2BWJ8A1ByKqPnyXjf%2BuBjEJbSS-h%3DyPRav%3DQ%40mail.gmail.com.

Re: How To Make New Features Known?

[Zoom.Quiet]

Edward K. Ream  于2022年4月27日周三 07:11写道：
>
>
>
> On Tue, Apr 26, 2022 at 1:13 PM tbp1...@gmail.com  wrote:
>>
>> I'm particularly thinking of new UI features, which are mostly turned off by 
>> default and need to be turned on by new settings.  For the most part, only a 
>> few people who read about them here in Groups will see them, and most of 
>> those won't remember later.  New users won't know about them.  And where 
>> does one go to find the right settings?
>
>
> This is a FAQ, although there may not be a FAQ entry.
>
> Imo, the best answer is to look in leoSettings.leo. It's authoritative, it's 
> up-to-date, and it's searchable.
>

of course leoSettings.leo is the full manual,
but it is real too larger,
suggest for the best or most in common use option,
record video, publish into Youtube,
make easy know, which open make what change ...
each video make clean know one option...

of course, these usage video is better make by tbp100...@gmail.com etc. ;-)


> All other solutions require continuous attention from devs. In my experience, 
> such attention is too much to expect.
>
> Edward
>
> --
> You received this message because you are subscribed to the Google Groups 
> "leo-editor" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to leo-editor+unsubscr...@googlegroups.com.
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/leo-editor/CAMF8tS0rUA5Gicg%2BWJ8A1ByKqPnyXjf%2BuBjEJbSS-h%3DyPRav%3DQ%40mail.gmail.com.



-- 

life is pathetic, go Pythonic. 人生苦短, Python当歌 ;-)
课: https://py.101.camp/
怼: https://du.101.camp/
俺: http://zoomquiet.io
许: http://creativecommons.org/licenses/by-sa/2.5/cn/
怒: 冗余不做,日子甭过!备份不做,十恶不赦.
KM keep growing environment culture which promoting organization learning ;-)

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/CAAFijRcuOdn%3Dpv4DgbNqE3WoamOhEapqeB60BJJpbQt3FW%3DSWA%40mail.gmail.com.