From 7aa520dc2d41409f3b559fad648d7283d15bde49 Mon Sep 17 00:00:00 2001 From: June McEnroe Date: Tue, 11 Sep 2018 22:11:17 -0400 Subject: Move gfx man pages to gfx/man --- gfx/Makefile | 14 +++--- gfx/brot.1 | 63 -------------------------- gfx/gfx.7 | 30 ------------- gfx/gfxx.1 | 138 --------------------------------------------------------- gfx/man/brot.1 | 63 ++++++++++++++++++++++++++ gfx/man/gfx.7 | 30 +++++++++++++ gfx/man/gfxx.1 | 138 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 7 files changed, 238 insertions(+), 238 deletions(-) delete mode 100644 gfx/brot.1 delete mode 100644 gfx/gfx.7 delete mode 100644 gfx/gfxx.1 create mode 100644 gfx/man/brot.1 create mode 100644 gfx/man/gfx.7 create mode 100644 gfx/man/gfxx.1 diff --git a/gfx/Makefile b/gfx/Makefile index 93f04ec0..192800c5 100644 --- a/gfx/Makefile +++ b/gfx/Makefile @@ -2,7 +2,7 @@ GFX ?= cocoa PREFIX = ~/.local BINS = brot gfxx -MAN1 = $(BINS:%=%.1) +MAN1 = $(BINS:%=man/%.1) CFLAGS += -Wall -Wextra -Wpedantic LDLIBS = -lm -lz @@ -11,9 +11,6 @@ LDLIBS_x11 = -lX11 all: .gitignore tags $(BINS) -.gitignore: Makefile - echo '*.o' tags $(BINS) | tr ' ' '\n' > .gitignore - tags: *.h *.c ctags -w *.h *.c @@ -27,12 +24,15 @@ brot: brot.o $(GFX).o gfxx: gfxx.o $(GFX).o $(CC) $(LDFLAGS) gfxx.o $(GFX).o $(LDLIBS) $(LDLIBS_$(GFX)) -o $@ -README: gfx.7 - mandoc gfx.7 | sed $$'s/.\b//g' > README - clean: rm -f tags *.o $(BINS) +README: man/gfx.7 + mandoc man/gfx.7 | sed $$'s/.\b//g' > README + +.gitignore: Makefile + echo '*.o' tags $(BINS) | tr ' ' '\n' > .gitignore + link: mkdir -p $(PREFIX)/bin $(PREFIX)/share/man/man1 ln -s -f $(BINS:%=$(PWD)/%) $(PREFIX)/bin diff --git a/gfx/brot.1 b/gfx/brot.1 deleted file mode 100644 index 71a0da01..00000000 --- a/gfx/brot.1 +++ /dev/null @@ -1,63 +0,0 @@ -.Dd September 8, 2018 -.Dt BROT 1 -.Os "Causal Agency" -. -.Sh NAME -.Nm brot -.Nd Mandelbrot renderer -. -.Sh SYNOPSIS -.Nm -.Op Fl i Ar depth -.Op Fl s Ar samples -.Op Fl t Ar a+bi -.Op Fl f Ar a+bi -. -.Sh DESCRIPTION -.Nm -renders the Mandelbrot set -in grayscale. -. -.Pp -The arguments are as follows: -.Bl -tag -width Ds -.It Fl f Ar a+bi -Set complex transform factor. -. -.It Fl i Ar depth -Set number of iterations. -. -.It Fl s Ar samples -Set number of samples per pixel. -. -.It Fl t Ar a+bi -Set complex translation term. -.El -. -.Pp -The interactive keys are as follows: -.Bl -tag -width Ds -.It Ic q -Quit. -. -.It Ic ,. -Adjust depth. -. -.It Ic [] -Adjust samples. -. -.It Ic hl -Adjust real component of translation. -. -.It Ic kj -Adjust imaginary componenent of translation. -. -.It Ic ui -Adjust rotation. -. -.It Ic -+ -Adjust scale. -. -.It Ic 0 -Reset translation and transform. -.El diff --git a/gfx/gfx.7 b/gfx/gfx.7 deleted file mode 100644 index 6a7097f1..00000000 --- a/gfx/gfx.7 +++ /dev/null @@ -1,30 +0,0 @@ -.Dd September 11, 2018 -.Dt gfx 7 -.Os "Causal Agency" -. -.Sh NAME -.Nm gfx -.Nd graphical utilities -. -.Sh DESCRIPTION -Graphial tools targeting -Cocoa, -X11 -and Linux framebuffer. -. -.Pp -.Bl -tag -width "gfxx(1)" -compact -.It Xr brot 1 -Mandelbrot renderer -. -.It Xr gfxx 1 -graphics data explorer -.El -. -.Pp -To build, -run one of: -.Pp -.Dl make GFX=cocoa -.Dl make GFX=x11 -.Dl make GFX=fb diff --git a/gfx/gfxx.1 b/gfx/gfxx.1 deleted file mode 100644 index 19a25c10..00000000 --- a/gfx/gfxx.1 +++ /dev/null @@ -1,138 +0,0 @@ -.Dd September 8, 2018 -.Dt GFXX 1 -.Os "Causal Agency" -. -.Sh NAME -.Nm gfxx -.Nd graphics data explorer -. -.Sh SYNOPSIS -.Nm -.Op Fl fm -.Op Fl c Ar space -.Op Fl p Ar file -.Op Fl e Ar lb -.Op Fl E Ar lb -.Op Fl b Ar bits -.Op Fl n Ar offset -.Op Fl w Ar width -.Op Fl z Ar scale -.Op Fl o Ar prefix -. -.Sh DESCRIPTION -.Nm -is an interactive graphics data explorer -capable of dumping PNGs. -. -.Pp -The arguments are as follows: -.Bl -tag -width Ds -.It Fl E Ar lb -Set bit order to little or big endian. -. -.It Fl b Ar bits -Set number of bits of padding, -red, -green -and blue -components. -Four digits are required. -. -.It Fl c Ar space -Set color space to one of -.Cm indexed , -.Cm grayscale , -.Cm rgb . -. -.It Fl e Ar lb -Set byte order to little or big endian. -. -.It Fl f -Flip display vertically. -. -.It Fl m -Mirror display horizontally. -. -.It Fl n Ar offset -Set byte offset into data. -. -.It Fl o Ar prefix -Set PNG output filename prefix. -. -.It Fl p Ar file -Load indexed color palette from -.Ar file . -. -.It Fl w Ar width -Set display column width. -. -.It Fl z Ar scale -Set display scale. -.El -. -.Pp -The interactive keys are as follows: -.Bl -tag -width Ds -.It Ic q -Quit. -. -.It Ic x -Export one frame as PNG. -. -.It Ic X -Export each frame as PNG. -. -.It Ic o -Print interactive options. -. -.It Ic [] -Select color space. -. -.It Ic p -Sample indexed palette from top-left corner. -. -.It Ic P -Export indexed palette as RGB data. -. -.It Ic {} -Select bits preset. -. -.It Ic e -Toggle byte order. -. -.It Ic E -Toggle bit order. -. -.It Ic hl -Adjust offset by byte. -. -.It Ic jk -Adjust offset by pixel. -. -.It Ic HL -Adjust offset by pixel row. -. -.It Ic JK -Adjust offset by pixel row square. -. -.It Ic ,. -Adjust display column width. -. -.It Ic <> -Adjust display column width by half or double. -. -.It Ic f -Toggle vertically flipped display. -. -.It Ic m -Toggle horizontally mirrored display. -. -.It Ic -+ -Adjust display scale. -. -.It Ic 0-9 -Set bits. -.El -. -.Sh SEE ALSO -.Xr pngo 1 diff --git a/gfx/man/brot.1 b/gfx/man/brot.1 new file mode 100644 index 00000000..71a0da01 --- /dev/null +++ b/gfx/man/brot.1 @@ -0,0 +1,63 @@ +.Dd September 8, 2018 +.Dt BROT 1 +.Os "Causal Agency" +. +.Sh NAME +.Nm brot +.Nd Mandelbrot renderer +. +.Sh SYNOPSIS +.Nm +.Op Fl i Ar depth +.Op Fl s Ar samples +.Op Fl t Ar a+bi +.Op Fl f Ar a+bi +. +.Sh DESCRIPTION +.Nm +renders the Mandelbrot set +in grayscale. +. +.Pp +The arguments are as follows: +.Bl -tag -width Ds +.It Fl f Ar a+bi +Set complex transform factor. +. +.It Fl i Ar depth +Set number of iterations. +. +.It Fl s Ar samples +Set number of samples per pixel. +. +.It Fl t Ar a+bi +Set complex translation term. +.El +. +.Pp +The interactive keys are as follows: +.Bl -tag -width Ds +.It Ic q +Quit. +. +.It Ic ,. +Adjust depth. +. +.It Ic [] +Adjust samples. +. +.It Ic hl +Adjust real component of translation. +. +.It Ic kj +Adjust imaginary componenent of translation. +. +.It Ic ui +Adjust rotation. +. +.It Ic -+ +Adjust scale. +. +.It Ic 0 +Reset translation and transform. +.El diff --git a/gfx/man/gfx.7 b/gfx/man/gfx.7 new file mode 100644 index 00000000..6a7097f1 --- /dev/null +++ b/gfx/man/gfx.7 @@ -0,0 +1,30 @@ +.Dd September 11, 2018 +.Dt gfx 7 +.Os "Causal Agency" +. +.Sh NAME +.Nm gfx +.Nd graphical utilities +. +.Sh DESCRIPTION +Graphial tools targeting +Cocoa, +X11 +and Linux framebuffer. +. +.Pp +.Bl -tag -width "gfxx(1)" -compact +.It Xr brot 1 +Mandelbrot renderer +. +.It Xr gfxx 1 +graphics data explorer +.El +. +.Pp +To build, +run one of: +.Pp +.Dl make GFX=cocoa +.Dl make GFX=x11 +.Dl make GFX=fb diff --git a/gfx/man/gfxx.1 b/gfx/man/gfxx.1 new file mode 100644 index 00000000..19a25c10 --- /dev/null +++ b/gfx/man/gfxx.1 @@ -0,0 +1,138 @@ +.Dd September 8, 2018 +.Dt GFXX 1 +.Os "Causal Agency" +. +.Sh NAME +.Nm gfxx +.Nd graphics data explorer +. +.Sh SYNOPSIS +.Nm +.Op Fl fm +.Op Fl c Ar space +.Op Fl p Ar file +.Op Fl e Ar lb +.Op Fl E Ar lb +.Op Fl b Ar bits +.Op Fl n Ar offset +.Op Fl w Ar width +.Op Fl z Ar scale +.Op Fl o Ar prefix +. +.Sh DESCRIPTION +.Nm +is an interactive graphics data explorer +capable of dumping PNGs. +. +.Pp +The arguments are as follows: +.Bl -tag -width Ds +.It Fl E Ar lb +Set bit order to little or big endian. +. +.It Fl b Ar bits +Set number of bits of padding, +red, +green +and blue +components. +Four digits are required. +. +.It Fl c Ar space +Set color space to one of +.Cm indexed , +.Cm grayscale , +.Cm rgb . +. +.It Fl e Ar lb +Set byte order to little or big endian. +. +.It Fl f +Flip display vertically. +. +.It Fl m +Mirror display horizontally. +. +.It Fl n Ar offset +Set byte offset into data. +. +.It Fl o Ar prefix +Set PNG output filename prefix. +. +.It Fl p Ar file +Load indexed color palette from +.Ar file . +. +.It Fl w Ar width +Set display column width. +. +.It Fl z Ar scale +Set display scale. +.El +. +.Pp +The interactive keys are as follows: +.Bl -tag -width Ds +.It Ic q +Quit. +. +.It Ic x +Export one frame as PNG. +. +.It Ic X +Export each frame as PNG. +. +.It Ic o +Print interactive options. +. +.It Ic [] +Select color space. +. +.It Ic p +Sample indexed palette from top-left corner. +. +.It Ic P +Export indexed palette as RGB data. +. +.It Ic {} +Select bits preset. +. +.It Ic e +Toggle byte order. +. +.It Ic E +Toggle bit order. +. +.It Ic hl +Adjust offset by byte. +. +.It Ic jk +Adjust offset by pixel. +. +.It Ic HL +Adjust offset by pixel row. +. +.It Ic JK +Adjust offset by pixel row square. +. +.It Ic ,. +Adjust display column width. +. +.It Ic <> +Adjust display column width by half or double. +. +.It Ic f +Toggle vertically flipped display. +. +.It Ic m +Toggle horizontally mirrored display. +. +.It Ic -+ +Adjust display scale. +. +.It Ic 0-9 +Set bits. +.El +. +.Sh SEE ALSO +.Xr pngo 1 -- cgit 1.4.1