aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJozanLeClerc <bousset.rudy@gmail.com>2022-04-04 22:55:08 +0200
committerJozanLeClerc <bousset.rudy@gmail.com>2022-04-04 22:55:08 +0200
commit7b9dbfdaa8aa2e79393d1884f931d915763db9f6 (patch)
treef0c3f9690d2f257c9437005071a0ea90c303465f
parentTime update (diff)
downloadgo2work-7b9dbfdaa8aa2e79393d1884f931d915763db9f6.tar.gz
go2work-7b9dbfdaa8aa2e79393d1884f931d915763db9f6.tar.bz2
go2work-7b9dbfdaa8aa2e79393d1884f931d915763db9f6.tar.xz
go2work-7b9dbfdaa8aa2e79393d1884f931d915763db9f6.tar.zst
go2work-7b9dbfdaa8aa2e79393d1884f931d915763db9f6.zip
Added man
Diffstat (limited to '')
-rw-r--r--Makefile8
-rw-r--r--man/go2work.1129
2 files changed, 134 insertions, 3 deletions
diff --git a/Makefile b/Makefile
index 95bcf15..04bae2e 100644
--- a/Makefile
+++ b/Makefile
@@ -11,7 +11,7 @@
# ========================
#
# go2work: Makefile
-# Mon Apr 4 19:33:39 CEST 2022
+# Mon Apr 4 22:51:40 CEST 2022
# Joe
#
# GNU Makefile
@@ -64,10 +64,11 @@ install-data:
${MKDIR} ${DESTDIR}share/${TARGET}
${INSTALL} -m0644 ${DATA_DIR}ring01.wav ${DESTDIR}share/${TARGET}
${INSTALL} -m0644 ${DATA_DIR}ring02.wav ${DESTDIR}share/${TARGET}
- ${INSTALL} -m0644 ${DATA_DIR}${TARGET}.toml ${DESTDIR}share/${TARGET}
${INSTALL} -m0644 LICENSE ${DESTDIR}share/${TARGET}
${INSTALL} -m0644 README ${DESTDIR}share/${TARGET}
${INSTALL} -m0644 README.org ${DESTDIR}share/${TARGET}
+ ${MKDIR} ${DESTDIR}etc/${TARGET}
+ ${INSTALL} -m0644 ${DATA_DIR}${TARGET}.toml ${DESTDIR}etc/${TARGET}
install-doc:
${MKDIR} ${DESTDIR}man/man1
@@ -81,11 +82,12 @@ uninstall:
${RM} ${DESTDIR}bin/${TARGET}
${RM} ${DESTDIR}share/${TARGET}/ring01.wav
${RM} ${DESTDIR}share/${TARGET}/ring02.wav
- ${RM} ${DESTDIR}share/${TARGET}/${TARGET}.toml
${RM} ${DESTDIR}share/${TARGET}/LICENSE
${RM} ${DESTDIR}share/${TARGET}/README
${RM} ${DESTDIR}share/${TARGET}/README.org
${RMDIR} ${DESTDIR}share/${TARGET}
+ ${RM} ${DESTDIR}etc/${TARGET}/${TARGET}.toml
+ ${RMDIR} ${DESTDIR}etc/${TARGET}
${RM} ${DESTDIR}man/man1/${MAN}.gz
clean:
diff --git a/man/go2work.1 b/man/go2work.1
index e69de29..036be35 100644
--- a/man/go2work.1
+++ b/man/go2work.1
@@ -0,0 +1,129 @@
+.\" ========================
+.\" ===== ===============
+.\" ====== ================
+.\" ====== ================
+.\" ====== ==== ==== ==
+.\" ====== === == = =
+.\" ====== === = == =
+.\" = === === = == ====
+.\" = === === = == = =
+.\" == ===== ==== ==
+.\" ========================
+.\"
+.\" SPDX-License-Identifier: BSD-3-Clause
+.\"
+.\" Copyright (c) 2022 Joe
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. Neither the name of the organization nor the
+.\" names of its contributors may be used to endorse or promote products
+.\" derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY JOE ''AS IS'' AND ANY
+.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+.\" DISCLAIMED. IN NO EVENT SHALL JOE BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" go2work: man/go2work.1
+.\" Mon Apr 4 22:54:59 CEST 2022
+.\" Joe
+.\"
+.\" Manpage for go2work
+.\" Contact bousset.rudy@gmail.com to correct errors and typos
+.\"
+.de Text
+.nop \)\\$*
+..
+.
+.
+.TH go2work 1 "04 April 2022" "go2work 1.0.0"
+.
+.
+.SH NAME
+.B go2work
+\- cli alarm clock
+.
+.
+.SH SYNOPSIS
+.SY go2work
+.RB [ \-hHtv ]
+.I time
+.YS
+.
+.
+.SH DESCRIPTION
+.PP
+The
+.B go2work
+program alows you to set an alarm clock in the next
+24 hours. The given
+.I time
+must be in 24 hours format. When the time has come, a configurable audio file
+will be played by a configurable program.
+.SH OPTIONS
+.TP
+.B \-h
+Print brief usage information to standard output and exit.
+.TP
+.B \-H
+Print the real usage information to standard output and exit.
+.TP
+.B \-t
+Run a test alarm in 3 seconds into the future. This option is recommanded to
+verify if the given configurations is correct.
+.TP
+.B \-v
+Print version information to the standard output and exit.
+.SH FILES
+These are the base directories
+.B go2work
+searches for configuration files in descending order of imortance:
+.PP
+.RS 4
+$XDG_CONFIG_HOME/go2work/go2work.toml
+.RE
+.PP
+.RS 4
+$HOME/.config/go2work/go2work.toml
+.RE
+.PP
+.RS 4
+/usr/local/etc/go2work/go2work.toml
+.RE
+.PP
+When none of these are found,
+.B go2work
+will fall back to default settings. Default ringtones, LICENSE and README files
+are located in this directory:
+.PP
+.RS 4
+/usr/local/share/go2work
+.RE
+.SH BUG REPORT
+Please note that
+.B go2work
+was tested only on FreeBSD and Linux at the moment. macOS is not supported
+but should work just fine. You can report any bug at
+.I bousset.rudy@gmail.com
+or on GitHub at
+.IR https://github.com/JozanLeClerc/go2work/issues .
+.
+.SH AUTHORS
+Joe <bousset.rudy@gmail.com>
+.SH SEE ALSO
+.IR mpv (1),
+.IR fortune (1)
+.\" vim: set filetype=groff: