~amavect/pal

c8bae863fe6ae429a4a4c78a64dc5e79818140ad — amavect 4 years ago 3ec2112
add man page
2 files changed, 87 insertions(+), 1 deletions(-)

M mkfile
A pal.man
M mkfile => mkfile +6 -1
@@ 14,7 14,12 @@ $O.$TARG: $OFILES
/$objtype/bin/$TARG: $O.$TARG
	cp $prereq $target

install:V: /$objtype/bin/$TARG
/sys/man/1/$TARG: $TARG.man
	cp $prereq $target

install:V: /$objtype/bin/$TARG man

man:V: /sys/man/1/$TARG

clean:V:
	rm -f [$OS].* *.[$OS]

A pal.man => pal.man +81 -0
@@ 0,0 1,81 @@
.TH PAL 1
.SH NAME
pal \- color palette
.SH SYNOPSIS
.PP
.B pal
[
.B -cip
] [
.I file
]
.SH DESCRIPTION
.I Pal
is a tool for holding colors. It consists of many selectable colors. Selecting a color with mouse 1, and then using the mouse 3 menu to
.B Send
the color will output the hex color on stdout.
.PP
By default, the colors are the C64 color palette, as in 
.IR paint (1).
Passing a file with a hex color on each line will initialize
.I Pal
with those colors, instead.
.PP
Hex colors from stdin are currently ignored.
.PP
Mouse 2 will open up a menu, which has a few entries:
.TF Delete
.TP
.B Add
Add a new blank color after the one underneath the mouse pointer.
.TP
.B Delete
Delete the color underneath the mouse pointer.
.PD
.PP
Mouse 3 will open up a menu, which has a few entries:
.TF Send
.TP
.B Send
Output the hex color in the form 0xRRGGBBAA and exit.
.TP
.B Exit
Exit and output nothing.
.PD
.PP
.I Pal
has a few options:
.TF -c
.TP
.B -c
Color picker. An instance of
.IR makeu (1)
with flags
.B -ip
will fork to a new window. Sending colors from
.I makeu
will replace the currently selected color.
If
.B -i
is also given, then the new color will also be sent to stdout.
.TP
.B -i
Immediate.
.I Pal
will output the color every time the color changes due to a mouse input.
.TP
.B -p
Persistent. 
.I Pal
will not exit when 
.B Send
is chosen.
.PD
.SH SOURCE
.B https://git.sr.ht/~amavect/pal
.br
.SH SEE ALSO
.IR colors (1), 
.IR paint (1), 
.IR allocimage (2),
.IR color (6)