finish up a bit more manual

This commit is contained in:
Ted Unangst 2019-10-02 00:19:00 -04:00
parent 2b9797e277
commit d2d9ae7772
1 changed files with 46 additions and 13 deletions

View File

@ -30,9 +30,9 @@ For administration, see
.Xr honk 8 .
.Pp
This manual is very incomplete.
Refer to the text files.
It'll get there eventually.
.Ss Following
In order to receive posts from other users, one must follow them.
In order to receive regular updates from other users, one must first follow them.
Begin at the
.Pa honkers
tab.
@ -58,30 +58,63 @@ The special combo name of one hyphen
.Sq -
will remove a honker's posts from the primary feed.
.Ss Viewing
The primary feed is accessed via the home tab, labelled
.Pa honk .
The primary feed is accessed via the home tab.
It will contain posts from all followed honkers.
Posts mentioning the user, both followed and not, are collected under the
.Pa @me
tab.
.Pp
.Lk screenshot-honk.png screen of one honk
.Ss Honking
On the home page and most other pages, there will be a button marked
.Dq it's honking time
which activates the honk form.
Individual honks contain a visual representation of the honker's ID,
their name, the activity (with a link back to origin), a link to the
parent post if applicable, and the convoy (thread) identifier.
.Pp
The in reply to field is an advanced feature.
.Lk screenshot-honk.png screenshot of one honk
.Ss Honking
Begin by pressin button marked
.Dq it's honking time
to activate the honk form.
.Pp
One may attach a file to a post.
Images are automatically rescaled and reduced in size for federation.
A description, or caption, is encouraged.
Text files are also supported as attachments.
.Pp
A limited subset of markdown is supported.
Bold, italics, and code blocks.
Mentioning a specfic user
One may also check in to a location.
The available fields, all optional, are
.Ar name ,
.Ar url ,
.Ar latitude ,
and
.Ar longitude .
By default, location data is rounded to approximately 1/500 decimal degree
accuracy.
Pressing the check in button a second time will refine this to more a
precise location.
.Pp
A limited subset of markdown is supported, including bold, italics, quotes,
and code blocks.
Mentioning a specfic user such as
.Pq @user@example.social
will send a copy of the message to them.
When replying, the author of the parent post is automatically mentioned.
.Pp
Threads from the tiny bird site may be included as quotes in a post via the
.Ar hoot
operator.
.Dl hoot: https://twitter.com/tedunangst/status/835172824734175234
.Pp
Custom emoji may included via colon wrapping
.Pq :hellsyeah: .
A meme (sticker, reacion gif) may be included with the
.Ar meme
operator.
.Dl meme: honk.mp4
A full list of emoji and memes may be found in the
.Pa funzone .
.Pp
When everything is at last ready to go, press the
.Dq it's gonna be honked
button.
.Ss zonkzone
Sometimes other users of the federation can get unruly.
The zonkzone can be of great use to restore order to one's timeline.