Author: sin <firstname.lastname@example.org>
Date: Wed, 8 Oct 2014 11:43:58 +0100
|M||Makefile|| | ||9||+++++++--|
|A||ratox.1|| | ||79||+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++|
2 files changed, 86 insertions(+), 2 deletions(-)
diff --git a/Makefile b/Makefile
@@ -44,11 +44,16 @@ install: all
@echo installing executable to $(DESTDIR)$(PREFIX)/bin
@mkdir -p $(DESTDIR)$(PREFIX)/bin
@cp -f $(BIN) $(DESTDIR)$(PREFIX)/bin
- @cd $(DESTDIR)$(PREFIX)/bin && chmod 755 $(BIN)
+ @chmod 755 $(DESTDIR)$(PREFIX)/bin/$(BIN)
+ @echo installing manual page to $(DESTDIR)$(MANPREFIX)/man1
+ @mkdir -p $(DESTDIR)$(MANPREFIX)/man1
+ @cp -f ratox.1 $(DESTDIR)$(MANPREFIX)/man1
@echo removing executable from $(DESTDIR)$(PREFIX)/bin
- @cd $(DESTDIR)$(PREFIX)/bin && rm -f $(BIN)
+ @rm -f $(DESTDIR)$(PREFIX)/bin/$(BIN)
+ @echo removing manual page from $(DESTDIR)$(MANPREFIX)/man1
+ @rm $(DESTDIR)$(MANPREFIX)/man1/ratox.1
diff --git a/ratox.1 b/ratox.1
@@ -0,0 +1,79 @@
+.TH RATOX "1" "October 2014"
+ratox - FIFO based tox client
+ratox is a client implementation of the rather popular tox protocol.
+Unlike other clients relying on GUIs as an interface to the user, ratox is
+developed with the UNIX-philosophy in mind and allows complete
+interaction through named pipes.
+Switch to IPv4-only mode
+Switch to IPv6-only mode
+Enable TCP mode. By default, Tox operates with UDP and is recommended, as TCP mode implies certain security considerations.
+Enable TCP SOCKS5 proxy as specified in config.def.h when the package was built.
+When this option is enabled, ratox will use a proxy on \fI127.0.0.1\fR and port
+\fI9050\fR (note that this is a divergence from upstream). \fBChanging the host
+and port requires rebuilding the package!\fR
+.SH File structure
+In the following, \fI/\fR refers to the directory ratox has been started in.
+.SH Global slots (\fIname/\fR, \fIstatus/\fR, \fIrequest/\fR)
+Global slots allow you to change your name and status message and send and
+accept friend requests. Each slot contains an \fBin\fR, \fBout\fR and
+\fBerr\fR file or directory respectively.
+The \fBin\fR-file is a pipe waiting for user-input. If you want to change your
+name or status, just pipe it to it. To send a friend request, pipe the Tox-ID
+The \fBout\fR-file contains the current state of a given parameter. In
+\fIrequest/\fR, out is a directory containing named pipes for each pending
+request. To accept or reject a friend request, pipe a \fI1\fR or \fI0\fR to a
+.SH Friend slots
+For each friend added, ratox will create a folder in \fI/\fR named after the
+friend's ID. It contains files and FIFOs to interact with your friends.
+\fBtext_in\fR and \fBfile_in\fR allow you to send messages and files just by piping them to them.
+\fBtext_out\fR and \fBfile_out\fR allow you to read your friend's messages and accept file-transmissions.
+Accepting a file transmission is as easy as just piping the \fBfile_out\fR to a
+file or other stream.
+\fBonline\fR, \fBname\fR, \fBstatus\fR and \fBfile_pending\fR are state-files
+giving you information on the friend's status.
+If you pipe a \fI1\fR to \fBremove\fR, the friend will be removed.
+.SH id file
+\fB/id\fR contains your own Tox-ID to pass on to your friends if you want them to add you.
+.SH "SEE ALSO"
+This manual page was written by kytv <email@example.com> for the Debian system (but may be used by others).
+Permission is granted to copy, distribute and/or modify this document under the terms of the ISC License.