Change how login works

packages/bare-os-coreutils/scripts/seed-man-pages.mjs

@@ -218,10 +218,10 @@ EXAMPLES.ln = [
 ]
 EXAMPLES.login = [
   {
-    caption: 'unlock existing identity',
-    code: 'login my passphrase words here'
+    caption: 'unlock: run login, then type passphrase at prompt (multi-word ok)',
+    code: 'login'
   },
-  { caption: 'register new', code: 'login --new first time passphrase' }
+  { caption: 'register new identity', code: 'login --new' }
 ]
 EXAMPLES.logout = [
   { caption: 'end session', code: 'logout' },
@@ -1044,9 +1044,9 @@ function shellPage() {
       },
       {
         name: 'login / logout',
-        synopsis: ['login [--new] passphrase...', 'logout [--save]'],
+        synopsis: ['login [--new]', 'logout [--save]'],
         description:
-          'Identity unlock/register and session teardown; require booter hooks.'
+          'login is a /bin utility: run it with no passphrase on the command line, then type the passphrase at the TTY prompt (hidden). logout remains a shell builtin for session teardown; both require booter hooks.'
       },
       {
         name: ':',