about summary refs log tree commit diff stats
path: root/README.md
Commit message (Collapse)AuthorAgeFilesLines
* clean up some issues I now feel confident aboutKartik K. Agaram2024-08-311-7/+0
|
* clarify that PRs and patches are both welcomeKartik K. Agaram2024-07-221-1/+2
|
* add a forkKartik K. Agaram2024-07-221-0/+2
|
* register a new add-on toolKartik K. Agaram2024-07-121-0/+3
| | | | Thanks eril!
* fix a crash involving mouse and drawingsKartik K. Agaram2024-06-091-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Thanks Alex Schroeder for reporting this crash. The scenario: * Edit a file like say this repo's Readme. * The second line is empty and there's a '+' to insert a drawing. Click on that. * Resize the window so just the first line of text and the drawing are visible. * Close the window. * Reopen lines.love, it will reopen the same file. * Click on the left margin to the left of the drawing. Before this commit these steps yielded the following crash: Error: bad argument #1 to 'len' (string expected, got nil) text.lua:626: in function 'pos_at_end_of_screen_line' edit.lua:298: in function 'mouse_press' There were two distinct problems here: 1. State.screen_bottom1 is not required to point to a text line, it could just as well be a drawing. I have been sloppy in handling that. 2. The bug was partially masked (the need to close and reopen the window) by a second bug: inserting a drawing was not invalidating the cache I save of starty coordinates for each line. (I've inserted and deleted starty invalidations a few times in the past, but it looks like I'd never had one in this particular location edit.draw before.) How did these issues get missed for years? - Even though I use lines.love on a daily basis, it turns out I don't actually create line drawings all that often. - When I do, I'm still living in files that are mostly text with only an occasional drawing. - I keep my windows fairly large. Between these 3 patterns, the odds of running into a drawing as the first or bottom-most line on the screen were fairly small. And then I had to interact with it. I suspect I tend to interact with drawings after centering them vertically. --- Bug #1 in particular has some interesting past history. * Near the start of the project, when I implemented line-wrapping I started saving screen_bottom, the bottom-most line displayed on screen. I did this so I could scroll down easily just by assigning `screen_top = screen_bottom`. (On the other hand, scrolling up still required some work. I should perhaps get rid of it and just compute scrolls from scratch each time.) * Also near the start of the project, I supported selecting text by a complex state machine spanning keypress, mouse press and mouse release: mouse click (press and immediate release) moves cursor mouse drag (press and much later release) creates selection shift-click selects from current cursor to click location shift-movement creates/grows a selection * On 2023-06-01, inscript reported a bug. Opening a window with just a little bit of text (lots of unused space in the window), selecting all the text and then clicking below all the text would crash the editor. To fix this I added code at the bottom of edit.mouse_press which computed the final visible line+pos location and used that in the cursor-move/text-selection state machine. It did this computation based on.. screen_bottom. But I didn't notice that screen_bottom could be a drawing (which has no pos). This commit's bug/regression was created. * On 2023-09-20, Matt Wynne encountered a crash which got me to realize I need code at the bottom of edit.mouse_release symmetric to the code at the bottom of edit.mouse_press. I still didn't notice that screen_bottom could be a drawing. So in fixing inscript's bug report, I introduced (at least) 2 regressions, because I either had no idea or quickly forgot that screen_bottom could point at a drawing. While I created regressions, the underlying mental bug feels new. I just never focused on the fact that screen_bottom could point at a drawing. This past history makes me suspicious of my mouse_press/mouse_release code. I think I'm going to get rid of screen_bottom entirely as a concept. I'll still have to be careful though about the remaining locations and which of them are allowed to point at drawings: - cursor and selection are not allowed to point at drawings - screen_top and screen_bottom are allowed to point at drawings I sometimes copy between these 4 location variables. Auditing shows no gaps where cursor could ever end up pointing at a drawing. It's just when I started using screen_bottom for a whole new purpose (in the mouse_press/release state machine) that I went wrong. I should also try getting rid of starty entirely. Is it _really_ needed for a responsive editor? I think I introduced it back when I didn't know what I was doing with LÖVE and was profligately creating text objects willy-nilly just to compute widths. Getting rid of these two fairly global bits of mutable state will hopefully make lines much more robust when the next person tries it out in 6 months :-/ X-( Thanks everyone for the conversation around this bug: https://merveilles.town/@akkartik/112567862542495637 --- Bug #2 has some complexity as well, and might lead to some follow-on cleanup. When I click on the button to insert a new drawing, the mouse_release hook triggers and moves the cursor below the new drawing. This is desirable, but I'd never noticed this happy accident. It stops working when I invalidate starty for all lines (which gets recomputed and cached for all visible lines on every frame). Fixing this caused a couple of unit tests start crashing for 2 reasons that required their own minor fixes: - My emulated mouse press and release didn't have an intervening frame and so mouse_release no longer receives starty. Now I've added a call to edit.draw() between press and release. This might actually bite someone for real someday, if they're running on a slow computer or something like that. I've tried to click really fast but I can't seem to put mouse_press and release in the same frame (assuming 30 frames per second) - My tests' window dimensions often violate my constraint that the screen always have one line of text for showing the cursor. They're unrealistically small or have a really wide aspect ratio (width 2x of height). I suspect lines.love will itself crash in those situations, but hopefully they're unrealistic. Hmm, I wonder what would happen if someone maximized in a 16:9 screen, that's almost 2x.. Anyways, I've cleaned a couple of tests up, but might need to fix up others at some point. I'd have to rejigger all my brittle line-wrapping tests if I modify the screen width :-/ X-(
* add a mirror and reorg mirrorsKartik K. Agaram2024-03-101-3/+4
|
* Revert "deemphasize the source editor"Kartik K. Agaram2023-09-101-0/+1
| | | | | | | Now that we have decent error handling, I think we can encourage people to press ctrl+e again. This reverts commit 4b43e9e85d985bcedd105fa9693ae751e5b6d0b6.
* experiment: convert to PijulKartik K. Agaram2023-06-251-0/+1
| | | | https://pijul.org
* delete inapplicable issueKartik K. Agaram2023-04-211-4/+0
|
* correct a characterizationKartik K. Agaram2023-04-211-2/+2
|
* deemphasize the source editorKartik K. Agaram2023-04-091-1/+0
| | | | | | | | | This repo does not support freewheeling modification. It's a primitive to enable freewheeling modification in downstream forks. The source editor is a convenience, but it's a sharp tool and can easily leave the app in a broken state that requires dropping down to external tools (editor, file manager) to fix.
* update stale informationKartik K. Agaram2023-03-251-2/+2
|
* mention a new toolKartik K. Agaram2023-03-211-0/+2
|
* remove a stale issueKartik K. Agaram2023-03-171-2/+0
|
* include instructions to install LÖVEKartik K. Agaram2023-01-241-1/+5
|
* demote codeberg.org in the list of mirrorsKartik K. Agaram2023-01-231-2/+2
| | | | It's been slow to push to lately, so I'm going to update it less frequently.
* ctrl+a: select entire bufferKartik K. Agaram2022-11-191-0/+1
|
* one issue lessKartik K. Agaram2022-09-061-3/+1
| | | | | Selecting text is also almost done. I just need to figure out what to do with bifold text.
* editing source code from within the appKartik K. Agaram2022-09-031-0/+5
| | | | | integrated from pong.love via text.love: https://merveilles.town/@akkartik/108933336531898243
* include pensieve.love even though it's in developmentKartik K. Agaram2022-08-221-0/+5
|
* include a forkKartik K. Agaram2022-08-211-0/+2
|
* new mirrorKartik K. Agaram2022-08-141-0/+1
|
* more cogent onboarding instructionsKartik K. Agaram2022-08-141-4/+7
| | | | Someone looking at the repo will probably prefer the terminal.
* click to the left of a lineKartik K. Agaram2022-07-291-0/+4
|
* affirm a priorityKartik K. Agaram2022-07-081-0/+2
|
* link to export toolKartik K. Agaram2022-07-021-0/+5
|
* deemphasize the terminal in ReadmeKartik K. Agaram2022-07-011-22/+4
|
* drop stale flag from documentationKartik K. Agaram2022-07-011-10/+0
|
* clarify what "large files" meansKartik K. Agaram2022-06-291-1/+2
|
* clean upKartik K. Agaram2022-06-171-3/+0
|
* better handle moving pointsKartik K. Agaram2022-06-171-15/+0
| | | | | This should hopefully address #5. I'm removing some constraints from manhattan lines, rectangles and squares.
* document one more shortcutKartik K. Agaram2022-06-171-0/+1
|
* tweak to ReadmeKartik K. Agaram2022-06-151-2/+2
|
* new fork for #1Kartik K. Agaram2022-06-151-0/+4
|
* .Kartik K. Agaram2022-06-111-1/+1
|
* things seem to feel snappier nowKartik K. Agaram2022-06-101-6/+2
| | | | | However, I think a lot of the benefit comes from just turning JIT off. Turning it on is still noticably sluggish.
* slight reorg in ReadmeKartik K. Agaram2022-06-101-2/+4
|
* faster pasteKartik K. Agaram2022-06-101-4/+4
| | | | | We don't need to perform the scroll calculations after inserting every single character from the clipboard.
* fix contact linkKartik K. Agaram2022-06-091-1/+1
|
* forgot to commit documentation for the commandline argKartik K. Agaram2022-06-071-0/+10
|
* clearer discription of how to run lines.loveKartik K. Agaram2022-06-071-5/+22
|
* a likely source of issuesKartik K. Agaram2022-06-071-0/+4
|
* freudian typoKartik K. Agaram2022-06-071-1/+1
|
* flesh out ReadmeKartik K. Agaram2022-06-061-0/+49
|
* another known issueKartik K. Agaram2022-06-061-4/+4
|
* record another known issue I don't know how to fix yetKartik K. Agaram2022-06-051-0/+5
| | | | | | | Perhaps I need to switch to the next more sophisticated data structure for Lines: a gap buffer around the line the cursor is on. I'm not sure why it would help here, though.
* one more known issueKartik K. Agaram2022-06-031-0/+3
|
* taking stockKartik K. Agaram2022-06-031-0/+4
| | | | | | | | couple of more temporary bugs: find sometimes draws highlighted text in wrong place esc after C-f sometimes ends up with cursor before screen top But the known issues are harder.
* more efficient undo/redoKartik K. Agaram2022-06-021-3/+2
| | | | | Now the bottleneck shifts to applying undo/redo in large files. But things should be snappy if you don't use the sluggish feature.
* after much struggle, a brute-force undoKartik K. Agaram2022-06-021-0/+4
| | | | | | | | | Incredibly inefficient, but I don't yet know how to efficiently encode undo mutations that can span multiple lines. There seems to be one bug related to creating new drawings; they're not spawning events and undoing past drawing creation has some weird artifacts. Redo seems to consistently work, though.