Add man page
authorJack Allnutt <jack@allnutt.eu>
Sat, 1 Nov 2014 02:00:01 +0000 (02:00 +0000)
committerJack Allnutt <jack@allnutt.eu>
Sat, 1 Nov 2014 02:01:44 +0000 (02:01 +0000)
man/kiwiirc.1 [new file with mode: 0644]
package.json

diff --git a/man/kiwiirc.1 b/man/kiwiirc.1
new file mode 100644 (file)
index 0000000..a8d17e2
--- /dev/null
@@ -0,0 +1,47 @@
+.TH KIWIIRC 1
+.SH NAME
+kiwiirc \- the Kiwi IRC web client
+.SH SYNOPSIS
+.B kiwiirc
+[\fB\-f\fR | \fBstart\fR | \fBstop\fR | \fBrestart\fR | \fBstatus\fR | \fBreconfig\fR | \fBbuild\fR] [\fB\-c\fR\ \fIconfig_file\fR] [\fB\-p\fR\ \fIpid_file\fR]
+.SH DESCRIPTION
+Kiwi IRC is a web-based IRC client built using Node.js.
+.SH OPTIONS
+.TP
+.BR \-f\fR
+Run the kiwi server in the foreground. When run in the foreground kiwi will print all logs to stdout.
+.TP
+.BR start\fR
+Start the kiwi server and fork in to the background. 
+.TP
+.BR stop\fR
+Stop the kiwi server if it is running.
+.TP
+.BR restart\fR
+Restart the kiwi server. If it is not running, it will be started.
+.TP
+.BR status\fR
+Output to stdout whether the kiwi server is running or not. If it is running it will also display the server's PID.
+.TP
+.BR reconfig\fR
+Forces the kiwi server to re-load its configuration file by sending the process \fBSIGUSR1\fR.
+.TP
+.BR build\fR
+Builds the necessary client files. This will process translation files, build the HTML file and bundle and minify the client-side JavaScript code.
+.TP
+.BR \-c\fR\ \fIconfig_file\fR
+Use the specified \fIconfig_file\fR instead of searching the pre-defined locations. By default the kiwi server will look in \fI/etc/kiwiirc\fR and the installation directory for a configuration file named \fIconfig.js\fR.
+.TP
+.BR \-p\fR\ \fIpid_file\fR
+Write the kiwi server's PID to this file. By default, kiwi will write the PID to a file called \fIkiwiirc.pid\fR in the installation directory unless it is started with the \fB\-f\fR flag.
+.SH FILES
+.TP
+.IR /etc/kiwiirc/config.js
+If this file exists, and the \fB\-c\fR option has not been specified, kiwi will use this file as its configuration file. If it does not exist, kiwi will try to locate \fIconfig.js\fR in its installation directory.
+.SH BUGS
+Please report bugs on the GitHub issues page at
+.UR https://github.com/prawnsalad/KiwiIRC/issues 
+.UE
+or on the mailing list at
+.MT kiwiirc@googlegroups.com
+.ME .
\ No newline at end of file
index d79ec21ac650819b13ec4c3f899a4f75e625b83a..d86496d7aee69e2f8634e7e312e578dbbdfddef5 100644 (file)
@@ -7,6 +7,7 @@
   "bin": {
     "kiwiirc": "./kiwi"
   },
+  "man": "./man/kiwiirc.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/prawnsalad/KiwiIRC.git"