From 353be3a7a22ca9ea8e79613f0b35cde4499b9148 Mon Sep 17 00:00:00 2001 From: Ansa89 Date: Thu, 26 Jun 2014 14:06:22 +0200 Subject: [PATCH] Add manpage --- build/Makefile | 32 +++++++++++++++++++++++-------- doc/toxic.1 | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 76 insertions(+), 8 deletions(-) create mode 100644 doc/toxic.1 diff --git a/build/Makefile b/build/Makefile index b812f47..e86bf1a 100644 --- a/build/Makefile +++ b/build/Makefile @@ -5,21 +5,24 @@ VERSION = $(TOXIC_VERSION)_r$(REV) CFG_DIR = ../cfg SRC_DIR = ../src MISC_DIR = ../misc +DOC_DIR = ../doc PREFIX = /usr/local BINDIR = $(PREFIX)/bin DATADIR = $(PREFIX)/share/toxic -DATAFILES = $(MISC_DIR)/DHTnodes $(MISC_DIR)/toxic.conf +MANDIR = $(PREFIX)/man/man1 +DATAFILES = DHTnodes toxic.conf +MANFILES = toxic.1 LIBS = libtoxcore ncursesw CFLAGS = -std=gnu99 -pthread -Wimplicit-function-declaration -Wreturn-type -Werror CFLAGS += -DTOXICVER="\"$(VERSION)\"" -DHAVE_WIDECHAR -D_XOPEN_SOURCE_EXTENDED -CFLAGS += -DPACKAGE_DATADIR="\"$(DATADIR)\"" +CFLAGS += -DPACKAGE_DATADIR="\"$(abspath $(DATADIR))\"" CFLAGS += $(USER_CFLAGS) LDFLAGS = $(USER_LDFLAGS) -OBJ = chat.o chat_commands.o configdir.o dns.o execute.o -OBJ += file_senders.o friendlist.o global_commands.o groupchat.o line_info.o input.o +OBJ = chat.o chat_commands.o configdir.o dns.o execute.o file_senders.o +OBJ += friendlist.o global_commands.o groupchat.o line_info.o input.o OBJ += log.o misc_tools.o prompt.o settings.o toxic.o toxic_strings.o windows.o # Variables for audio support @@ -88,10 +91,23 @@ toxic: $(OBJ) $(CC) $(CFLAGS) -o toxic $(OBJ) $(LDFLAGS) install: toxic - @mkdir -p $(DESTDIR)/$(BINDIR) - @mkdir -p $(DESTDIR)/$(DATADIR) - install -m 0755 toxic $(DESTDIR)/$(BINDIR) - install -m 0644 $(DATAFILES) $(DESTDIR)/$(DATADIR) + mkdir -p $(abspath $(DESTDIR)/$(BINDIR)) + mkdir -p $(abspath $(DESTDIR)/$(DATADIR)) + mkdir -p $(abspath $(DESTDIR)/$(MANDIR)) + @echo "Installing toxic executable" + @install -m 0755 toxic $(abspath $(DESTDIR)/$(BINDIR)) + @echo "Installing data files" + @for f in $(DATAFILES) ; do \ + install -m 0644 $(MISC_DIR)/$$f $(abspath $(DESTDIR)/$(DATADIR)) ;\ + done + @echo "Installing man pages" + @for f in $(MANFILES) ; do \ + file=$(abspath $(DESTDIR)/$(MANDIR))/$$f ;\ + install -m 0644 $(DOC_DIR)/$$f $(abspath $(DESTDIR)/$(MANDIR)) ;\ + sed -i'' -e 's:__VERSION__:'$(VERSION)':' $$file ;\ + sed -i'' -e 's:__DATADIR__:'$(abspath $(DATADIR))':g' $$file ;\ + gzip -f -9 $$file ;\ + done %.o: $(SRC_DIR)/%.c $(CC) $(CFLAGS) -o $*.o -c $(SRC_DIR)/$*.c diff --git a/doc/toxic.1 b/doc/toxic.1 new file mode 100644 index 0000000..265a4d7 --- /dev/null +++ b/doc/toxic.1 @@ -0,0 +1,52 @@ +.TH TOXIC 1 "June 2014" "Toxic v__VERSION__" "User Manual" + +.SH NAME +Toxic \- CLI for Tox + +.SH SYNOPSYS +.B toxic [\-f +.I data\-file +.B ] [\-x] [\-4] [\-c +.I config\-file +.B ] [\-n +.I nodes\-file +.B ] [\-h] + +.SH DESCRIPTION +Toxic is an ncurses-based instant messaging client for Tox which formerly +resided in the Tox core repository, and is now available as a standalone +application. + +.SH OPTIONS +.IP "\-f, \-\-file data\-file" +Use specified +.I data\-file +instead of +.IR ~/.config/tox/data +.IP "\-x, \-\-nodata" +Ignore data file +.IP "\-4, \-\-ipv4" +Force IPv4 connection +.IP "\-c, \-\-config config\-file" +Use specified +.I config\-file +instead of +.IR __DATADIR__/toxic.conf +.IP "\-n, \-\-nodes nodes\-file" +Use specified +.I nodes\-file +for DHT bootstrap nodes, instead of +.IR __DATADIR__/DHTnodes +.IP "\-h, \-\-help" +Show help message + +.SH BUGS +Expect bugs and other bad things: this software is in pre\-alpha stage. + +.SH AUTHORS +JFreegman (JFreegman@gmail.com) + +.SH SEE ALSO +Project page on github: https://github.com/Tox/toxic +.br +IRC channel on Freenode: chat.freenode.net#tox