diff options
Diffstat (limited to '')
-rw-r--r-- | Makefile | 60 | ||||
-rw-r--r-- | doc/info/adjbacklight.texinfo (renamed from info/adjbacklight.texinfo) | 0 | ||||
-rw-r--r-- | doc/info/fdl.texinfo (renamed from info/fdl.texinfo) | 0 | ||||
-rw-r--r-- | doc/info/gpl.texinfo (renamed from info/gpl.texinfo) | 0 | ||||
-rw-r--r-- | doc/man/adjbacklight.1 | 104 |
5 files changed, 138 insertions, 26 deletions
@@ -7,15 +7,6 @@ # # [GNU All Permissive License] -OPTIMISATION = -Ofast -# -Os optimise for small size -# -Ofast optimise for performance -# -Og optimise for debugging -# -g include debugging data (use together with -Og or alone) - -PKGNAME = adjbacklight -COMMAND = adjbacklight - PREFIX = /usr BIN = /bin BINDIR = $(PREFIX)$(BIN) @@ -23,10 +14,20 @@ DATA = /share DATADIR = $(PREFIX)$(DATA) DOCDIR = $(DATADIR)/doc INFODIR = $(DATADIR)/info +MANDIR = $(DATADIR)/man +MAN1DIR = $(MANDIR)/man1 LICENSEDIR = $(DATADIR)/licenses -MANUAL = adjbacklight -MANUALDIR = info/ + +PKGNAME = adjbacklight +COMMAND = adjbacklight + + +OPTIMISATION = -Ofast +# -Os optimise for small size +# -Ofast optimise for performance +# -Og optimise for debugging +# -g include debugging data (use together with -Og or alone) WARN = -Wall -Wextra -Wdouble-promotion -Wformat=2 -Winit-self -Wmissing-include-dirs \ -Wtrampolines -Wfloat-equal -Wshadow -Wmissing-prototypes -Wmissing-declarations \ @@ -41,6 +42,7 @@ WARN = -Wall -Wextra -Wdouble-promotion -Wformat=2 -Winit-self -Wmissing-include # excluded: -pedantic + # compile the package .PHONY: default default: code info shell @@ -59,31 +61,31 @@ bin/adjbacklight: src/adjbacklight.c doc: info pdf dvi ps .PHONY: info -info: bin/$(MANUAL).info -bin/%.info: $(MANUALDIR)%.texinfo +info: bin/adjbacklight.info +bin/%.info: doc/info/%.texinfo @mkdir -p bin $(MAKEINFO) "$<" mv $*.info $@ .PHONY: pdf -pdf: bin/$(MANUAL).pdf -bin/%.pdf: $(MANUALDIR)%.texinfo +pdf: bin/adjbacklight.pdf +bin/%.pdf: doc/info/%.texinfo @! test -d obj/pdf || rm -rf obj/pdf @mkdir -p bin obj/pdf cd obj/pdf && texi2pdf ../../"$<" < /dev/null mv obj/pdf/$*.pdf $@ .PHONY: dvi -dvi: bin/$(MANUAL).dvi -bin/%.dvi: $(MANUALDIR)%.texinfo +dvi: bin/adjbacklight.dvi +bin/%.dvi: doc/info/%.texinfo @! test -d obj/dvi || rm -rf obj/dvi @mkdir -p bin obj/dvi cd obj/dvi && $(TEXI2DVI) ../../"$<" < /dev/null mv obj/dvi/$*.dvi $@ .PHONY: ps -ps: bin/$(MANUAL).ps -bin/%.ps: $(MANUALDIR)%.texinfo +ps: bin/adjbacklight.ps +bin/%.ps: doc/info/%.texinfo @! test -d obj/ps || rm -rf obj/ps @mkdir -p bin obj/ps cd obj/ps && texi2pdf --ps ../../"$<" < /dev/null @@ -113,7 +115,7 @@ bin/adjbacklight.%sh-completion: obj/adjbacklight.auto-completion # install to system .PHONY: install -install: install-base install-info install-shell +install: install-base install-info install-man install-shell .PHONY: install-all install-all: install-base install-doc install-shell @@ -140,28 +142,33 @@ install-license: install -m644 -- LICENSE "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)" .PHONY: install-doc -install-doc: install-info install-pdf install-dvi install-ps +install-doc: install-info install-pdf install-dvi install-ps install-man .PHONY: install-info -install-info: bin/$(MANUAL).info +install-info: bin/adjbacklight.info install -dm755 -- "$(DESTDIR)$(INFODIR)" install -m644 -- "$<" "$(DESTDIR)$(INFODIR)/$(PKGNAME).info" .PHONY: install-pdf -install-pdf: bin/$(MANUAL).pdf +install-pdf: bin/adjbacklight.pdf install -dm755 -- "$(DESTDIR)$(DOCDIR)" install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).pdf" .PHONY: install-dvi -install-dvi: bin/$(MANUAL).dvi +install-dvi: bin/adjbacklight.dvi install -dm755 -- "$(DESTDIR)$(DOCDIR)" install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).dvi" .PHONY: install-ps -install-ps: bin/$(MANUAL).ps +install-ps: bin/adjbacklight.ps install -dm755 -- "$(DESTDIR)$(DOCDIR)" install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).ps" +.PHONY: install-man +install-man: doc/man/adjbacklight.1 + install -dm755 -- "$(DESTDIR)$(MAN1DIR)" + install -m644 "$<" -- "$(DESTDIR)$(MAN1DIR)/$(COMMAND).1" + .PHONY: install-shell install-shell: install-bash install-fish install-zsh @@ -187,7 +194,7 @@ uninstall: -rm -- "$(DESTDIR)$(BINDIR)/$(COMMAND)" -rm -- "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)/COPYING" -rm -- "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)/LICENSE" - -rm -d -- "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)" + -rmdir -- "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)" -rm -- "$(DESTDIR)$(INFODIR)/$(PKGNAME).info" -rm -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).pdf" -rm -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).dvi" @@ -195,6 +202,7 @@ uninstall: -rm -- "$(DESTDIR)$(DATADIR)/bash-completion/completions/$(COMMAND)" -rm -- "$(DESTDIR)$(DATADIR)/fish/completions/$(COMMAND).fish" -rm -- "$(DESTDIR)$(DATADIR)/zsh/site-functions/_$(COMMAND)" + -rm -- "$(DESTDIR)$(MAN1)/$(COMMAND).1" # remove files created by `all` diff --git a/info/adjbacklight.texinfo b/doc/info/adjbacklight.texinfo index b4c6986..b4c6986 100644 --- a/info/adjbacklight.texinfo +++ b/doc/info/adjbacklight.texinfo diff --git a/info/fdl.texinfo b/doc/info/fdl.texinfo index cb71f05..cb71f05 100644 --- a/info/fdl.texinfo +++ b/doc/info/fdl.texinfo diff --git a/info/gpl.texinfo b/doc/info/gpl.texinfo index 97a17e1..97a17e1 100644 --- a/info/gpl.texinfo +++ b/doc/info/gpl.texinfo diff --git a/doc/man/adjbacklight.1 b/doc/man/adjbacklight.1 new file mode 100644 index 0000000..d946738 --- /dev/null +++ b/doc/man/adjbacklight.1 @@ -0,0 +1,104 @@ +.TH ADJBACKLIGHT 1 ADJBACKLIGHT +.SH NAME +adjbacklight - Convenient method for adjusting the backlight on your portable computer +.SH SYNOPSIS +.B adjbacklight +(-c | -w | [-g | -s +.IR LEVEL +| +.IR LEVEL ] +[-a | +.IR DEVICE ...]) +.SH DESCRIPTION +.B adjbacklight +can be used to fetch or set the backlight non-interactively. +If these feature is not used, it starts a interactive user +interface in the terminal. +.PP +.B adjbacklight +installs with the set-uid bit set, to enable any user to +change the backlight on the computer. +.PP +.B adjbacklight +was originally designed for small netbooks that are not running +.BR X . +However, it is still suitable for desktop computers and can +be used inside +.BR X . +In fact it seems to work for all machines with backlight, which +is not true for +.BR xbacklight (1). +.V adjbacklight +uses +.IR /sys/class/backlight . +.B adjbacklight +as been retrofitted to be convenient for use inside +.B X +on desktop computers, with commands that lets it be used +non-interactively with hotkeys set up in +.BR xbindkeys (1). +.SH OPTIONS +.TP +.BR \-c ,\ \-\-copyright ,\ \-\-copying +Display copyright information. +.TP +.BR \-w, \ \-\-warranty +Display warranty disclaimer. +.TP +.BR \-a, \ \-\-all +Run for all devices, including ACPI devices. +.TP +.BR \-g, \ \-\-get +Get average brightness on devices. +.TP +.BR \-s, \ \-\-set \ \fILEVEL\fP[%] +Set brightness on devices. +.PP +.TP +.BR \+ \fILEVEL\fP +Increase brightness on devices by actual value. +.TP +.BR \- \fILEVEL\fP +Decrease brightness on devices by actual value. +.TP +.BR \= \fILEVEL\fP +Set brightness on devices by actual value. +.br +.TP +.BR \+ \fILEVEL\fP% +Increase brightness on devices by percentage-points. +.TP +.BR \- \fILEVEL\fP% +Decrease brightness on devices by percentage-points. +.TP +.BR \= \fILEVEL\fP% +Set brightness on devices by percentage-points. +.br +.TP +.BR \+ \fILEVEL\fP%% +Increase brightness on devices by percentage. +.TP +.BR \- \fILEVEL\fP%% +Decrease brightness on devices by percentage. +.TP +.BR \= \fILEVEL\fP%% +Set brightness on devices by percentage. +.SH "SEE ALSO" +.BR xbindkeys (1), +.BR xbacklight (1) +.PP +Full documentation available locally via: info \(aq(adjbacklight)\(aq +.SH AUTHORS +Principal author, Mattias Andrée. See the COPYING file for the full +list of authors. +.SH LICENSE +Copyright \(co 2015 Mattias Andrée +.br +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +.br +There is NO WARRANTY, to the extent permitted by law. +.SH BUGS +Please report bugs to https://github.com/maandree/adjbacklight/issues or to +maandree@member.fsf.org |