@@ -270,9 +270,10 @@ you.)
270270- `idle` - inactive
271271- `gone` - not present
272272
273−`;name ~some/circle 'my nickname'`
274−Set a nickname for yourself in a specific circle. It will display to users
275−who have done `;set nick`.
273+`;name ~some/circle 'my handle'`
274+Set a handle ("name") for yourself in a specific circle. It will display
275+to users who have done `;set nick`, but gets truncated if it's longer
276+than 14 characters.
276277
277278### Audience
278279
@@ -374,13 +375,14 @@ Clear an assigned nickname.
374375
375376`;set nicks`
376377Show nicknames instead of urbit names. If no local nickname is set, uses
377−that user's self-set name.
378+that user's handle. If the user has no handle, just the urbit name.
378379
379380`;unset nicks`
380381Show urbit names instead of nicknames.
381382
382−Nicknames longer than 14 character will be truncated in output. Nicknames
383−are strictly local - like the names on entries in a phonebook.
383+Nicknames and handles longer than 14 character will be truncated in
384+output. Nicknames are strictly local - like the names on entries in a
385+phonebook.
384386
385387### Miscellaneous configuration
386388