Error handling and documentation suggestions

[bjornbm]

These commits are related to error handling and documentation. Refer to the commits messages and diffs for details.

[bjornbm]

You may not want all of these. I think the git commands to selectively apply patches should be:

First add my fork to the sources (“remotes”) you can pull commits from. I think you will only have to do this once. The name of the “remote” will be “bjornbm”:

git remote add --fetch bjornbm https://github.com/bjornbm/ple.git

Then you should be able to apply individual commits, for example:

git cherry-pick 57a679f

If you want to merge the entire errors branch to your master at the command line (instead of on Github), just do (while on your master branch):

git merge bjornbm/errors

[philanc]

Thanks for your commits.

And thanks for your patience and the details about cherry-pick! I managed to get the commits I wanted, but it was not straightforward, probably because I did not apply all the commit, and in order, or because I didn't apply the first one, and didn't know what to do in case of merge errors / failure of cherry-pick

I am close to clueless regarding git, except the most basic use case: commit my own change at the end of the (only) current branch!

Each time I have departed from that, I have fallen "into a maze of twisty little passages, all alike" :-)

Regarding your commit "Don't toggle away from OUT on error (clobbers previous buffer), I don't understand the issue. Using ^O from the OUT buffer works ok here. What happens on your side?

[bjornbm]

The git user experience is a UX disaster. I barely scrape along, too.

Try triggering an error (^Xt) in *OUT* and you will see what happens: it swaps to the previous buffer and does a settext there instead of in *OUT*, clobbering the other buffer. The commit fixes that.

[philanc]

Try triggering an error (^Xt) in *OUT* and you will see what happens: it swaps to the previous buffer and does a settext there instead of in *OUT*, clobbering the other buffer.

Commit f8e0b82 should fix this.

[bjornbm]

That is indeed a less intrusive fix.