[PATCH] document ~/.local/bin

Submitted by Lennart Poettering

Assigned to Allison Lortie @desrt

Link to original bug (#106360)

Description

Created attachment 139280 basedir: Reformat text and indentation, fix inconsistent hyphenation

This patch set is based on the two patches originally put together by Johannes Löthberg:

https://lists.freedesktop.org/archives/xdg/2017-August/013938.html

I promised to commit these, but never did. Let's get this done now.

I discussed this with Allison Karlitskaya (as one of the original spec authors) and we agreed that it might be wise not to introduce yet another set of env vars, but simply document that ~/.local/bin is suitable for dropping binaries in. Hence I reworked Johannes' patches accordingly, and dropped all mentions of any new XDG env vars for this. Instead I added a reference to $PATH however, to clarify that the search path concept already exists and with a recommendation that distributions include ~/.local/bin in it.

I also toned down the wording a bit, from "shall" to "may", to make this more compatible with other views of the world.

Anyway, I hope this is enough to get in.

Josh Triplett reviewed the original patch and liked it, I hope he's OK with this version too.

https://lists.freedesktop.org/archives/xdg/2017-August/013943.html

Patch 139280, "basedir: Reformat text and indentation, fix inconsistent hyphenation":
0001-basedir-Reformat-text-and-indentation-fix-inconsiste.patch