-.SH "SIMILARITY FORMAT"
-.PP
-The
-\fIsimilarity_string\fR
-has to be formatted following a special pattern in order for simadb_cli to extract similarity relations between artists names\&. Usually a similarity entry is defined as a main artist, lets say
-\fImain_art\fR, followed by a list of similar artists which you want to be related to that
-\fImain_art\fR, each artist of that list with a specific similarity value, a match score, quantifying the similarity relation with the
-\fImain_art\fR\&. The match score value is an integer in [0 ,100] with 100 corresponding to a perfect match\&.
-.PP
-\fIsimilarity_string\fR
-is then to be formatted as follow:
-.PP
-\fBmain_art,first artist:<score>,second artist:<score>\fR
-.PP
-Each artist group are separated with commas (",") and inside each group the artist name and the match score is colon (":") separated\&. Obviously the first artist group, as the main artist, does not have a match score\&.
-.PP
-Lets see how it works with an example\&. I consider "Led Zeppelin" to be similar to "Tool" with a match score of 25, I also want to have "Audioslave" related to "Led Zeppelin" with a score of 20\&. Then the
-\fIsimilarity_string\fR
-will be the following:
-.PP
-\fBLed Zeppelin,Tool:25,Audiosalve:20\fR
-.PP
-See
-the section called \(lqA WORD ABOUT SIMA DATA BASE\(rq
-for more details about how similarities are handled
-.SH "A WORD ABOUT SIMA DATA BASE"
-.PP
-The similarity database is defined from the point of view of a
-\fImain artist\fR
-which is declared related to a list of
-\fIsimilar artists\fR\&. That means when you define
-\fImain_art\fR
-to be similar to
-\fIsim_art A\fR
-and
-\fIsim_art B\fR
-the reciprocal won\*(Aqt be true,
-\fIsim_art A\fR
-and
-\fIsim_art B\fR
-are not similar to
-\fImain_art\fR\&. At least this is the default behavior when you edit entries with simadb_cli, this is also the way last\&.fm is working concerning similar artists\&. This documentation is using that particular terminology to specify which kind of artist we are dealing with : "main artist" or "similar artist"\&.
-.br
-The
-\fB\-\-reciprocal\fR
-option allows one to add reciprocal relation where
-\fIsim_art A\fR
-and
-\fIsim_art B\fR
-become respectively the
-\fImain_art\fR\&. Using
-\fB\-\-reciprocal\fR
-you will then edit two more entries in the database\&. To summarize here is what you\*(Aqll end up with in your data base adding similarity with this string
-\fBmain_art,sim_art A:34,sim_art B:45\fR\&.
-.PP
-\fBsimadb_cli \-\-reciprocal \-\-add_similarity=main_art,sim_art A:34,sim_art B:45\fR
-.PP
-main_art similar to sim_art A:34 and sim_art B:45
-.br
-sim_art A similar to main_art:34
-.br
-sim_art B similar to main_art:45
-.PP
-Without the reciprocal option you would have add only the first similarity\&. Usually using the reciprocal option is the desired behavior, at least what users have in mind when thinking of similarity relation between to artists but keep in mind that it may lead to have MPD_sima more sensible to loop over the same two artist (ASSERTION TO BE CONFIRMED)\&.