Even after reading through
and pijul/pijul - Discussion #521 - Can’t get a new repo going, pijul/manual - Discussion #58 - Update documentation on keys/identities including the change proposed there, I’m still not sure I understood what’s what.
So it seems like “key” has been renamed to “identity”, probably to better capture what the concept it is actually about, and that with
pijul identity new I can create such an identity. (Which I’d need to
pijul record changes.) But what are all those different names?
Here’s what I could find out so far:
||arg / option description||
|“Unique identity name”||(none, use positional argument
||“Set the new identity name”||Entry directly under “Identities”||Must be locally unique. Positional argument ignored (and default or answer to prompt used), unless
||“Set the display name”||“Display name: …”|
||“Set the username”||“Login:
With that I can make some guesses. Thus: Are the following assumptions correct?
- The “Unique identity name” is not part of the identity, but just a way to reference it locally. (Similar to an “Account Name” in Thunderbird or to the name of a Git “remote”.)
- It is never transmitted anywhere outside the local machine, even when the concerning identity is being transmitted.
pijul identity newprompts for “Unique identity name” even when the positional
NAMEargument is passed (and that it ignores whatever is passed there, in favor of the reply to the prompt or even the default) unless
--no-promptis also passed, is simply a bug.
- The “Display name” is for how I want others to recognize me when I’m acting with said identity. (E.g. when authoring changes.)
- It can be my real name (or part thereof), a pen name, nickname, username or other alias,
- It does not need to be unique, neither among my own identities nor globally.
- … nor does it need to correspond between different of my identities. (⇒ I can have as many alter egos as I have Pajul identities.)
- The “Remote username” is used for authentication towards the service pointed to by the “Remote URL” (e.g. Nest).