aboutsummaryrefslogtreecommitdiffstats
path: root/docs/USERGUIDE.md
diff options
context:
space:
mode:
authorChristophe Besson <cbesson@gmail.com>2026-08-15 15:48:36 +0200
committerChristophe Besson <cbesson@gmail.com>2026-08-15 15:48:36 +0200
commit4066c754a613deb965472853fe69727d68be593e (patch)
treef93b7d7129576f7406a2c97ac7399a8d7e606897 /docs/USERGUIDE.md
parent8528bce49bb637f4e9fb653fff148b7ea45cfdac (diff)
downloadmeshbay-4066c754a613deb965472853fe69727d68be593e.tar.gz
fix(downloads): automatic really is automatic, and a selection downloads all of it
Two bugs in what shipped last, and both were mine. Automatic mode still opened Save As, because with no folder granted the code fell through to the file picker — while the documentation said it would use the browser's own download folder. It does that now. Over 512 MB it still asks, since getting there means holding the file in memory and a tab will not survive a 40 GB blob; Settings is where to stop it asking again. Selecting two files downloaded one. They were started without awaiting, so each asked the browser for a save dialog at once, and a browser allows exactly one — the rest were rejected and the errors went nowhere. They are awaited one at a time now, which serializes the dialogs and not the transfers: each call returns as soon as its transfer is registered. Then the adjustments. The transfers widget offers Open on a finished download that went into a granted folder — the bytes go to a new tab, and that is the whole of what a page can do: no browser lets one start a desktop application or show a file manager, so the folder half of that request cannot be built and the guide says so. The Files toolbar was four controls of three different heights in a row. It is three groups now — what you can add, where you are, what you can do with what is here — on one baseline, with icons from the set and a gap between the dots and the word Actions. Chat comes first among the tabs and is the one you land on. The three Discover entries in the sidebar have icons. And a link in a chat message becomes a link: built as an element and never as markup, http and https only, so `javascript:` is not one message away from running here. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Diffstat (limited to 'docs/USERGUIDE.md')
-rw-r--r--docs/USERGUIDE.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 1bc3045..fea02fd 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -548,6 +548,17 @@ one and something else in another before choosing an action.
- **Ask every time** opens a Save As dialog per file, which is right for one file
and wrong for a selection of twenty.
+With no folder chosen, automatic still does not put a dialog in your way: the file
+goes to the browser's own download folder. The exception is a download over 512 MB,
+which cannot be held in memory to get there — that one asks where to put it, and
+choosing a folder in Settings stops it asking again.
+
+A finished download offers **Open** in the transfers widget when it went into a
+folder you granted: the file is handed to a new tab and the browser decides what
+to do with it. That is the whole of what a web page can do here — it cannot start
+a desktop application, and it cannot show you a file manager. No browser offers an
+API for either, deliberately.
+
A web page cannot be given a filesystem path, and cannot read one either: there
is no `~/Downloads` to configure, on any operating system, and nothing changes
here on Windows for the same reason. What a browser grants is access to a folder