aboutsummaryrefslogtreecommitdiff
path: root/docs/sdtui.1.adoc
diff options
context:
space:
mode:
authorPřemysl Eric Janouch <p@janouch.name>2020-10-26 17:01:43 +0100
committerPřemysl Eric Janouch <p@janouch.name>2020-10-26 17:06:13 +0100
commitd2fa9f315132bdb3134323c7d453a62a2681b136 (patch)
treeb43f989cb5d0f4694a43eb6592c460db54032f39 /docs/sdtui.1.adoc
parentd7f502a7314544916ccf019dcaee590918922498 (diff)
downloadtdv-d2fa9f315132bdb3134323c7d453a62a2681b136.tar.gz
tdv-d2fa9f315132bdb3134323c7d453a62a2681b136.tar.xz
tdv-d2fa9f315132bdb3134323c7d453a62a2681b136.zip
Convert the manpage to AsciiDoc
Writing DocBook XML by hand is an awful experience and the tools aren't much better. Asciidoctor does it well. There's no need to worry about semantics, man(1) just needs to be able to show something at all. This project's manpage is sadly almost useless right now.
Diffstat (limited to 'docs/sdtui.1.adoc')
-rw-r--r--docs/sdtui.1.adoc45
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/sdtui.1.adoc b/docs/sdtui.1.adoc
new file mode 100644
index 0000000..af5e62d
--- /dev/null
+++ b/docs/sdtui.1.adoc
@@ -0,0 +1,45 @@
+sdtui(1)
+========
+:doctype: manpage
+:manmanual: sdtui Manual
+:mansource: sdtui {release-version}
+
+Name
+----
+sdtui - StarDict terminal UI
+
+Synopsis
+--------
+*sdtui* [_OPTION_]... [_DICTIONARY_.ifo]...
+
+Description
+-----------
+*sdtui* is a StarDict dictionary viewer custom tailored for viewing translation
+dictionaries, using a simple curses-based terminal UI.
+
+The program expects to find on its command line the path to a dictionary's
+_.ifo_ file, which contains further information required to load the dictionary.
+
+Some options as well as dictionaries to load on start-up by default can be
+specified in a configuration file. See the README for an example.
+
+// FIXME: the README isn't even installed, so this manual isn't very useful
+
+Options
+-------
+*-h*, *--help*::
+ Display a help message and exit.
+
+*-V*, *--version*::
+ Output version information and exit.
+
+Files
+-----
+_~/.config/sdtui/sdtui.conf_::
+ The configuration file, in which you can configure some settings, terminal
+ colours and the set of dictionaries to be loaded automatically on start-up.
+
+Reporting bugs
+--------------
+Use https://git.janouch.name/p/sdtui to report bugs, request features,
+or submit pull requests.