all repos — honk @ 3e1b9733df9c8ee5aa0c73213734a5fdf20146f6

my fork of honk

more documentation stuff
Ted Unangst tedu@tedunangst.com
Sun, 20 Oct 2019 15:49:02 -0400
commit

3e1b9733df9c8ee5aa0c73213734a5fdf20146f6

parent

0fefd080a1f248b0437c4228d0f0a3084338ae61

2 files changed, 29 insertions(+), 4 deletions(-)

jump to
M docs/hfcs.1docs/hfcs.1

@@ -24,6 +24,9 @@ The honk filtering and censorship system,

.Nm hfcs , controls what messages are seen and how they are presented to the user. Filter rules are based on series of matches and actions. +It is accessed via the +.Pa filters +menu item. .Pp The following match types are possible. All criteria must match.
M docs/honk.1docs/honk.1

@@ -26,10 +26,13 @@ utility processes federated status updates and other microblog activities.

This is the user manual. For administration, see .Xr honk 8 . +For other documentation, refer to the +.Xr intro 1 . .Pp This manual is still incomplete. It'll get there eventually. .Ss Honkers +Initially, there won't be much to see after logging in. In order to receive regular updates from other users, they must first be added to one's honker collection. Begin at the

@@ -56,13 +59,26 @@ .Pa combos

tab and allow easy access to particular groupings. The special combo name of one hyphen .Sq - -will remove a honker's posts from the primary feed. +will exclude a honker's posts from the primary feed. +.Pp +It is also possible to skip subscribing. +In this case, regular posts are not received, but replies and posts fetched +via other means will appear in the relevant combos. .Ss Viewing -The primary feed is accessed via the home tab. -It will contain posts from nearly all honkers. +The primary feed is accessed via the +.Pa home +tab. +It will contain posts from all honkers except those specifically excluded. Posts mentioning the user, both followed and not, are collected under the .Pa @me tab. +Other feeds include +.Pa first +which excludes replies, the user defined options under the +.Pa combos +subheading, and the +.Pa events +page which lists only events. .Pp 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

@@ -103,6 +119,12 @@ Sometimes other users of the federation can get unruly.

The honk filtering and censorship system, .Xr hfcs 1 , can be of great use to restore order to one's timeline. +.Ss xzone +The +.Pa xzone +page lists recently seen honkers that are not otherwise tracked. +It also allows the import of external objects via URL, either individual +posts or actor URLs, in which case their recent outbox is imported. .Sh ENVIRONMENT .Nm is designed to work with most browsers, but for optimal results it is

@@ -122,7 +144,7 @@ .Lk https://www.w3.org/TR/activitystreams-vocabulary/ "Activity Vocabulary"

.Sh HISTORY Started March 2019. .Sh AUTHORS -.An Ted Unangst Lk @tedu@honk.tedunangst.com https://honk.tedunangst.com/u/tedu +.An Ted Unangst Lk https://honk.tedunangst.com/u/tedu @tedu@honk.tedunangst.com .Sh CAVEATS The ActivityPub standard is subject to interpretation, and not all implementations are as enlightened as