.\"t
.\" Automatically generated by Pandoc 2.5
.\"
.TH "dingonyms" "1" "" "for ding" "Version 0.5"
.hy
.SH NAME
.PP
dingonyms \[em] basic synonym/antonym lookup tool
.SH SYNOPSIS
.PP
\f[B]dingonyms\f[R] \[dq]word\[dq]
.PP
\f[B]dingonyms\f[R] [\f[I]\-\-thesaurus\f[R]]
[\f[I]\-\-merriamwebster\f[R]] [\f[I]\-\-wordhippo\f[R]] \[dq]find\[dq]
.PP
\f[B]dingonyms\f[R] [\f[I]\-\-openthesaurus\f[R] | \f[I]\-\-woxikon\f[R]
| \f[I]\-\-urban\f[R]] \[dq]Wort\[dq]
.PP
\f[B]dingonyms\f[R] [\f[I]\-\-reverso\f[R] | \f[I]\-\-fr\f[R] |
\f[I]\-\-es\f[R] | \f[I]\-\-it\f[R] | \f[I]\-\-jp\f[R]]
\[dq]bonjour\[dq]
.PP
\f[B]dingonyms\f[R] [\f[I]\-\-no\-antonyms\f[R]] [\f[I]\-\-async\f[R]]
\f[I]\-\-all\f[R] \[dq]word\[dq]
.PP
\f[B]dictcc\f[R] [\f[I]en\-es\f[R] | \f[I]en\-ru\f[R] | \f[I]de\-nl\f[R]
| \f[I]de\-it\f[R]] \[dq]translate\[dq]
.SH DESCRIPTION
.PP
To be used as lookup tool for \f[B]ding\f[R](1).
Scans the specified online service for synonyms.
.PD 0
.P
.PD
It\[cq]s not very useful as CLI tool by itself, because of the
particular dict formatting.
.SH PARAMS
.PP
Parameters can be introdoced with any combination of \f[I]\-\f[R] or
\f[I]\-\-\f[R] dashes or \f[I]+\f[R] signs.
.PD 0
.P
.PD
Most can also be abbreviated (should cover some typos).
.PP
.TS
tab(@);
l l l.
T{
Parameter
T}@T{
Aliases
T}@T{
Class
T}
_
T{
\-\-thesaurus
T}@T{
\-t \[en]thes
T}@T{
EN
T}
T{
\-\-merriamwebster
T}@T{
\-mw \[en]merr \-\-webster \-\-merweb
T}@T{
EN
T}
T{
\-\-synonym
T}@T{
\-s \[en]syn \-\-synonym.com
T}@T{
EN
T}
T{
\-\-reverso
T}@T{
\-\-rev // \-fr \-es \-it \-pt \-nl \-ru \-jp
T}@T{
EN/**
T}
T{
\-\-wordhippo
T}@T{
\-hippo \[en]wordhip
T}@T{
EN
T}
T{
\-\-mobythesaurus
T}@T{
\-mby \[en]moby
T}@T{
EN
T}
T{
\-\-urban
T}@T{
\-u \[en]urb \-\-ubn
T}@T{
LEXICON
T}
T{
\-\-dictcc
T}@T{
\[en]en\-es \[en]en\-it \[en]de\-fr \[en]en\-pt
T}@T{
DICT
T}
T{
\-\-openthesaurus
T}@T{
\-ot \-\-othes \[en]open
T}@T{
DE
T}
T{
\-\-woxikon
T}@T{
\-wx \-\-woxi
T}@T{
DE
T}
T{
\-\-synonyme_de
T}@T{
\-sd \[en]desyn
T}@T{
DE
T}
T{
\-\-all
T}@T{
(\-t +mw +syn +rev +ot +wx +urban)
T}@T{
MIXED
T}
T{
\-\-en
T}@T{
(\-t +mw +syn +rev)
T}@T{
MIXED
T}
T{
\-\-de
T}@T{
(\-ot \-wx \-sd)
T}@T{
MIXED
T}
T{
\-\-no\-antonyms
T}@T{
\-na
T}@T{
FLAG
T}
T{
\-\-no\-headers
T}@T{
\-nh
T}@T{
FLAG
T}
T{
\-\-async
T}@T{
\-\-parallel ++io
T}@T{
FLAG
T}
.TE
.PP
They can also be combined (\f[B]dingonyms\f[R] \f[I]\-t \-mw \-u\f[R]
\[dq]find\[dq]), so two or more services get queried at once.
.IP \[bu] 2
And obviously there\[cq]s also \f[I]\-\-all\f[R] to query most supported
sites.
.IP \[bu] 2
While \f[I]\-\-en\f[R] and \f[I]\-\-de\f[R] combine the other main
services.
.IP \[bu] 2
Reverso offers some alternative languages (\-fr, \-it, \-ru).
.IP \[bu] 2
And \-\-dictcc that allows for pair\-language specifiers (\-en\-tr,
\-de\-fr)
.PP
Execution flags should/must be noted before any translation service:
.IP \[bu] 2
The \f[I]\-\-no\-antonyms\f[R] flag isn\[cq]t consistently supported by
all backends.
(It\[cq]s actually more effort to skip around unwanted data, rather just
outputting it as it comes in.)
.IP \[bu] 2
\f[I]\-\-no\-headers\f[R] to omit the \[lq]\[u270E] {Sitename}\[rq]
titles before any output.
.IP \[bu] 2
And \f[I]\-\-asnyc\f[R] speeds up the processing of multiple sites, at
the cost of potentially intermingling their output.
It\[cq]s a rather crude threading scheme, and no care has been taken to
rewrite dingonyms to fully support that.
It\[cq]s primarily meant for \-\-all and \-\-de, \-\-en.
There\[cq]s preliminary support for asyncing selected sites as well
(e.g.\ \f[B]dingonyms \-\-async ++thes ++merr ++urb
\[dq]word\[dq]\f[R]), where it would be less likely mash up antonyms.
(The execution speed of the regex+print loops determines if there\[cq]s
any mashup whenever HTTP requests complete at the same time.)
.SH DICTCC
.PP
The dictcc mode is special, in that it provides an actual translation
dictionary between different languages.
The default mode is en\[->]de, but alternative \f[I]\-\-from\-to\f[R]
options can be specified.
Additionally there\[cq]s a commandline shortcut just for this backend:
.PP
\f[B]dictcc\f[R] \f[I]en\-it\f[R] \-\- \[dq]translate\[dq]
.PP
The \-\- is optional as is the \-\-lng\-lng dash prefix.
Otherwise it\[cq]s the same as invoking dingonyms.
.SH CONFIG
.PP
The search services can be configured through the GUI (somewhat fiddly
with Change+New).
Alternatively via \f[B]dingonyms\f[R] \f[I]\-\-setup\f[R] for a single
entry.
.PD 0
.P
.PD
Or by editing \f[I]\[ti]/.dingrc\f[R] directly.
To have all services present for example:
.IP
.nf
\f[C]
set searchmeth(3,name) {Synonyms}
set searchmeth(3,type) {3}
set searchmeth(3,dictfile) {}
set searchmeth(3,separator) { :: }
set searchmeth(3,language1) {Group}
set searchmeth(3,language2) {Synonyms}
set searchmeth(3,grepcmd) {dingonyms}
set searchmeth(3,grepopts) {\-\-thesaurus}
set searchmeth(3,maxlength) {30}
set searchmeth(3,maxresults) {200}
set searchmeth(3,minlength) {2}
set searchmeth(3,shapedresult) {1}
set searchmeth(3,foldedresult) {0}
set searchmeth(4,name) {Merriam\-Webster}
set searchmeth(4,type) {3}
set searchmeth(4,dictfile) {}
set searchmeth(4,separator) { :: }
set searchmeth(4,language1) {Group}
set searchmeth(4,language2) {Synonym}
set searchmeth(4,grepcmd) {dingonyms}
set searchmeth(4,grepopts) {\-\-merriamwebster}
set searchmeth(4,maxlength) {30}
set searchmeth(4,maxresults) {200}
set searchmeth(4,minlength) {2}
set searchmeth(4,shapedresult) {1}
set searchmeth(4,foldedresult) {0}
set searchmeth(5,name) {OpenThesaurus}
set searchmeth(5,type) {3}
set searchmeth(5,dictfile) {}
set searchmeth(5,separator) { :: }
set searchmeth(5,language1) {Group}
set searchmeth(5,language2) {Synonyms}
set searchmeth(5,grepcmd) {dingonyms}
set searchmeth(5,grepopts) {\-\-openthesaurus}
set searchmeth(5,maxlength) {30}
set searchmeth(5,maxresults) {200}
set searchmeth(5,minlength) {2}
set searchmeth(5,shapedresult) {1}
set searchmeth(5,foldedresult) {0}
set searchmeth(6,name) {Urban}
set searchmeth(6,type) {3}
set searchmeth(6,dictfile) {}
set searchmeth(6,separator) { :: }
set searchmeth(6,language1) {Word}
set searchmeth(6,language2) {Definition}
set searchmeth(6,grepcmd) {dingonyms}
set searchmeth(6,grepopts) {\-\-urban}
set searchmeth(6,maxlength) {30}
set searchmeth(6,maxresults) {200}
set searchmeth(6,minlength) {2}
set searchmeth(6,shapedresult) {1}
set searchmeth(6,foldedresult) {0}
\f[R]
.fi
.PP
\f[B]Beware not to overwrite existing/custom entries.\f[R]
.PD 0
.P
.PD
If the entries don\[cq]t show up, ding might not see dingonyms in the
PATH:
.SH SETUP
.PP
ding started from the Desktop environment might not find dingonyms, if
installed per pip.
You\[cq]ll have to symlink it:
.RS
.PP
\f[I]ln \-s \[ti]/.local/bin/dingonyms \[ti]/bin/\f[R]
.RE
.PP
Or reconfigure \f[I]\[ti]/.profile\f[R] to generally include
\[ti]/.local/bin (which doesn\[cq]t seem to be standard in most
distros).
.SH SEE ALSO
.PP
\f[B]ding\f[R](1), \f[B]python\f[R](1)