From: Phillip Berndt <phillip.berndt@googlemail.com>
Date: Sun, 17 Feb 2019 11:50:55 +0000 (+0100)
Subject: Merge branch 'master' into manpage
X-Git-Tag: 1.8~4^2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a2e8abfc4f7294d792ecbba68b7f47954e6599ea;hp=9255c2f7050e3ab4d9f5e4e5665c4cc10255c4ad;p=deb_pkgs%2Fautorandr.git

Merge branch 'master' into manpage
---

diff --git a/Makefile b/Makefile
index cfac2e6..a36d2e0 100644
--- a/Makefile
+++ b/Makefile
@@ -126,6 +126,20 @@ uninstall_udev:
 	$(if $(UDEV_RULES_DIR),,$(error UDEV_RULES_DIR is not defined))
 	rm -f ${DESTDIR}/${UDEV_RULES_DIR}/40-monitor-hotplug.rules
 
+# Rules for manpage
+MANDIR:=${PREFIX}/share/man/man1
+DEFAULT_TARGETS+=manpage
+
+install_manpage:
+	mkdir -p ${DESTDIR}/${MANDIR}
+	cp autorandr.1 ${DESTDIR}/${MANDIR}
+	mandb -qp
+
+uninstall_manpage:
+	rm -f ${DESTDIR}/${MANDIR}/autorandr.1
+	mandb -q
+
+# Rules for launcher
 install_launcher:
 	gcc -Wall contrib/autorandr_launcher/autorandr_launcher.c -o contrib/autorandr_launcher/autorandr_launcher -lxcb -lxcb-randr
 	install -D -m 755 contrib/autorandr_launcher/autorandr_launcher ${DESTDIR}${PREFIX}/bin/autorandr_launcher
diff --git a/autorandr.1 b/autorandr.1
new file mode 100644
index 0000000..2b2206a
--- /dev/null
+++ b/autorandr.1
@@ -0,0 +1,70 @@
+.TH AUTORANDR 1
+.SH NAME
+autorandr \- automatically select a display configuration based on connected devices
+.SH SYNOPSIS
+.B autorandr
+[\fIOPTION\fR] [\fIPROFILE\fR] 
+.SH DESCRIPTION
+.PP
+This program automatically detects connected display hardware and then loads an appropriate X11 setup using xrandr. It also supports the use of display profiles for different hardware setups.
+.PP
+Autorandr also includes several virtual configurations including \fBoff\fR, \fBcommon\fR, \fBclone-largest\fR, \fBhorizontal\fR, and \fBvertical\fR. See the documentation for explanation of each.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help
+\fRDisplay help text and exit
+.TP
+\fB\-c\fR, \fB\-\-change
+\fRAutomatically load the first detected profile
+.TP
+\fB\-d\fR, \fB\-\-default \fIPROFILE
+\fRMake profile \fIPROFILE\fR the default profile. The default profile is used if no suitable profile can be identified. Else, the current configuration is kept.
+.TP
+\fB\-l\fR, \fB\-\-load \fIPROFILE
+\fRLoad profile \fIPROFILE
+.TP
+\fB\-s\fR, \fB\-\-save \fIPROFILE
+\fRSave the current setup to profile \fIPROFILE
+.TP
+\fB\-r\fR, \fB\-\-remove \fIPROFILE
+\fRRemove profile \fIPROFILE
+.TP
+.BR \-\-batch
+\fRRun autorandr for all users with active X11 sessions
+.TP
+.BR \-\-current
+List only the current (active) configuration(s)
+.TP
+.BR \-\-config
+Dump the variable values of your current xrandr setup
+.TP
+.BR \-\-debug
+Enable verbose output
+.TP
+.BR \-\-detected
+List only the detected (i.e. available) configuration(s)
+.TP
+.BR \-\-dry\-run
+Don't change anything, only print the xrandr commands
+.TP
+.BR \-\-fingerprint
+Fingerprint the current hardware setup
+.TP
+.BR \-\-force
+Force loading or reloading of a profile
+.TP
+\fB\-\-skip\-options [\fIOPTION\fR] ...
+\fRSet a comma\-separated list of xrandr arguments to skip both in change detection and profile application. See \fBxrandr(1)\fR for xrandr arguments.
+.TP
+.BR \-\-version
+Show version information and exit
+.SH AUTHOR
+\fRPhillip Berndt <phillip.berndt@googlemail.com>
+.br
+See https://github.com/phillipberndt/autorandr for a full list of contributors. 
+.SH REPORTING BUGS
+\fRReport issues upstream on GitHub:  https://githb.com/phillipberndt/autorandr/issues
+.br
+\fRPlease attach the output of \fBxrandr --verbose\fR to your bug report if appropriate.
+.SH SEE ALSO
+\fRFor examples, advanced usage (including predefined per-profile & global hooks and wildcard EDID matching), and full documentation, see https://github.com/phillipberndt/autorandr.