commit d8487e5

Updated documentation.

1@@ -269,7 +269,7 @@ for a job to be assigned), input or output (processing I/O packets)
2 or stopped (not running, only to be seen while starting or stopping
3 the server).
4 .El
5-.Ss Migrating an account from Mastodon
6+.Ss Migrating an account to/from Mastodon
7 See 
8 .Xr snac 8
9 for details.

 1@@ -381,7 +381,81 @@ is supported. Intentionally, the
 2 and
 3 .Pa /following
 4 paths return empty lists.
 5-.Ss Migrating from Mastodon
 6+.Ss Migrating from snac to Mastodon
 7+Since version 2.60, you can migrate your
 8+.Nm
 9+account to other ActivityPub instances. I will describe the process to do it from
10+.Nm
11+to Mastodon; on other software implementations, it will surely be very different. All
12+the steps regarding your
13+.Nm
14+account must be done from the command line. For the sake of the example, let's
15+say that you want to migrate from an account named @origin@snac.example.org to
16+another one named @destination@mastodon.example.com and that both of them
17+already exist. I've used this very informative page as a guideline:
18+.Pp
19+.Lk https://fedi.tips/transferring-your-mastodon-account-to-another-server/
20+.Pp
21+1. On your
22+.Nm
23+server, first export your data to CSV by running:
24+.Bd -literal -offset indent
25+snac export_csv $SNAC_BASEDIR origin
26+.Ed
27+.Pp
28+You'll find the following CSV files in the current directory:
29+.Pa bookmarks.csv ,
30+.Pa blocked_accounts.csv ,
31+.Pa lists.csv , and
32+.Pa following_accounts.csv .
33+.Pp
34+2. In the web interface of your new Mastodon account, click on
35+.Vt Preferences
36+>
37+.Vt Import and Export
38+>
39+.Vt Import
40+and upload the CSV files one at a time. You must specify the type of
41+file you are uploading.
42+.Pp
43+3. Still in the web interface of your new Mastodon account, click on
44+.Vt Preferences
45+>
46+.Vt Account
47+>
48+.Vt Moving From a Different Account ,
49+then click on
50+.Vt Create an account alias
51+and follow the instructions. (When it asks you to
52+write your old account’s handle, it needs to include the @ at the start
53+as well as the @ in the middle, in our example, @origin@snac.example.org).
54+According to the link above, you must wait at least five minutes for
55+this to be effective.
56+.Pp
57+4. Meanwhile, you must tell
58+.Nm
59+about your new account by creating an alias from your current one.
60+So, on your
61+.Nm
62+server, run
63+.Bd -literal -offset indent
64+snac alias $SNAC_BASEDIR origin "@destination@mastodon.example.com"
65+.Ed
66+.Pp
67+5. Finally, you must order
68+.Nm
69+to start the migration process, that will consist in iterating all the
70+people that follows your account and sending them a
71+.Vt Move
72+message, notifying all of them that they must unfollow your old account
73+and follow the new one. The command is
74+.Bd -literal -offset indent
75+snac migrate $SNAC_BASEDIR origin
76+.Ed
77+.Pp
78+This process can be very long and unreliable. I recommend you to read
79+the document I linked above to know how heartbreaking it can be.
80+.Ss Migrating from Mastodon to snac
81 User migration from different Fediverse instances is a pain in the ass
82 that has been implemented everywhere as a kludgy afterthought. There is
83 not much that can be done, other than importing the list of people you