[hackers] [farbfeld] Add tool manpages and set up the Makefile to install the manuals || FRIGN

From: <git_AT_suckless.org>
Date: Tue, 5 Jan 2016 16:57:22 +0100 (CET)

commit 24c4b045fc495becc9ba4239ba3d2963851c7634
Author: FRIGN <dev_AT_frign.de>
AuthorDate: Tue Jan 5 16:38:12 2016 +0100
Commit: FRIGN <dev_AT_frign.de>
CommitDate: Tue Jan 5 16:38:12 2016 +0100

    Add tool manpages and set up the Makefile to install the manuals
    
    While at it, refactor the makefile a bit.

diff --git a/2ff.1 b/2ff.1
new file mode 100644
index 0000000..44eed4e
--- /dev/null
+++ b/2ff.1
_AT_@ -0,0 +1,51 @@
+.Dd 2016-01-05
+.Dt 2FF 1
+.Os suckless.org
+.Sh NAME
+.Nm 2ff
+.Nd convert image to farbfeld
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+reads an image from stdin, converts it to
+.Xr farbfeld 5
+and writes the result to stdout.
+.Pp
+.Nm
+is a wrapper script around the *2ff-tools
+with a soft fallback to obtaining a PNG from imagemagick's
+.Xr convert 1
+and passing it through
+.Xr png2ff 1 .
+.Pp
+In case of an error
+.Nm
+writes a diagnostic message to stderr.
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 0
+Image processed successfully.
+.It 1
+An error occurred or
+.Xr convert 1
+was not found in the fallback.
+.El
+.Sh EXAMPLES
+$
+.Nm
+< image.* > image.ff
+.Pp
+$
+.Nm
+< image.* | bzip2 > image.ff.bz2
+.Sh SEE ALSO
+.Xr bunzip2 1 ,
+.Xr bzip2 1 ,
+.Xr convert 1 ,
+.Xr ff2png 1 ,
+.Xr jpg2ff 1 ,
+.Xr png2ff 1 ,
+.Xr farbfeld 5
+.Sh AUTHORS
+.An Laslo Hunhold Aq Mt dev_AT_frign.de
diff --git a/Makefile b/Makefile
index f54f7b4..b93b472 100644
--- a/Makefile
+++ b/Makefile
_AT_@ -3,7 +3,10 @@
 
 include config.mk
 
-SRC = png2ff.c ff2png.c jpg2ff.c
+BIN = png2ff ff2png jpg2ff
+SRC = $(BIN:=.c)
+MAN1 = 2ff.1 $(BIN:=.1)
+MAN5 = farbfeld.5
 
 all: png2ff ff2png jpg2ff
 
_AT_@ -12,16 +15,28 @@ all: png2ff ff2png jpg2ff
         _AT_${CC} -o $@ ${CFLAGS} ${LIBS} ${LDFLAGS} $<
 
 clean:
- rm -f png2ff ff2png jpg2ff
+ rm -f ${BIN}
 
 install:
         _AT_echo installing into ${DESTDIR}${PREFIX}/bin
         _AT_mkdir -p ${DESTDIR}${PREFIX}/bin
- _AT_cp -f jpg2ff png2ff ff2png 2ff ${DESTDIR}${PREFIX}/bin
+ _AT_cp -f 2ff ${BIN} ${DESTDIR}${PREFIX}/bin
+ mkdir -p $(DESTDIR)$(MANPREFIX)/man1
+ _AT_cp -f $(MAN1) $(DESTDIR)$(MANPREFIX)/man1
+ cd $(DESTDIR)$(MANPREFIX)/man1 && chmod 644 $(MAN1)
+ mkdir -p $(DESTDIR)$(MANPREFIX)/man5
+ _AT_cp -f $(MAN5) $(DESTDIR)$(MANPREFIX)/man5
+ cd $(DESTDIR)$(MANPREFIX)/man5 && chmod 644 $(MAN5)
 
 uninstall:
         _AT_echo removing from ${DESTDIR}${PREFIX}/bin
- _AT_rm -f ${DESTDIR}${PREFIX}/bin/png2ff
- _AT_rm -f ${DESTDIR}${PREFIX}/bin/ff2png
+ cd ${DESTDIR}${PREFIX}/bin
+ _AT_rm -f 2ff ${BIN}
+ _AT_echo removing from ${DESTDIR}${MANPREFIX}/man1
+ cd ${DESTDIR}${MANPREFIX}/man1
+ _AT_rm -f $(MAN1)
+ _AT_echo removing from ${DESTDIR}${MANPREFIX}/man5
+ cd ${DESTDIR}${MANPREFIX}/man5
+ _AT_rm -f $(MAN5)
 
 .PHONY: all clean install uninstall
diff --git a/ff2png.1 b/ff2png.1
new file mode 100644
index 0000000..3bf1d82
--- /dev/null
+++ b/ff2png.1
_AT_@ -0,0 +1,42 @@
+.Dd 2016-01-05
+.Dt FF2PNG 1
+.Os suckless.org
+.Sh NAME
+.Nm ff2png
+.Nd convert farbfeld to PNG
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+reads a
+.Xr farbfeld 5
+image from stdin, converts it to a 16-Bit RGBA PNG and writes the result
+to stdout.
+.Pp
+In case of an error
+.Nm
+writes a diagnostic message to stderr.
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 0
+Image processed successfully.
+.It 1
+An error occurred.
+.El
+.Sh EXAMPLES
+$
+.Nm
+< image.ff > image.png
+.Pp
+$ bunzip2 < image.ff.bz2 |
+.Nm
+> image.png
+.Sh SEE ALSO
+.Xr 2ff 1 ,
+.Xr bunzip2 1 ,
+.Xr bzip2 1 ,
+.Xr jpg2ff 1 ,
+.Xr png2ff 1 ,
+.Xr farbfeld 5
+.Sh AUTHORS
+.An Laslo Hunhold Aq Mt dev_AT_frign.de
diff --git a/jpg2ff.1 b/jpg2ff.1
new file mode 100644
index 0000000..0e99062
--- /dev/null
+++ b/jpg2ff.1
_AT_@ -0,0 +1,41 @@
+.Dd 2016-01-05
+.Dt JPG2FF 1
+.Os suckless.org
+.Sh NAME
+.Nm jpg2ff
+.Nd convert JPG to farbfeld
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+reads a JPG image from stdin, converts it to
+.Xr farbfeld 5
+and writes the result to stdout.
+.Pp
+In case of an error
+.Nm
+writes a diagnostic message to stderr.
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 0
+Image processed successfully.
+.It 1
+An error occurred.
+.El
+.Sh EXAMPLES
+$
+.Nm
+< image.jpg > image.ff
+.Pp
+$
+.Nm
+< image.jpg | bzip2 > image.ff.bz2
+.Sh SEE ALSO
+.Xr 2ff 1 ,
+.Xr bunzip2 1 ,
+.Xr bzip2 1 ,
+.Xr ff2png 1 ,
+.Xr png2ff 1 ,
+.Xr farbfeld 5
+.Sh AUTHORS
+.An Laslo Hunhold Aq Mt dev_AT_frign.de
diff --git a/png2ff.1 b/png2ff.1
new file mode 100644
index 0000000..f1c6083
--- /dev/null
+++ b/png2ff.1
_AT_@ -0,0 +1,41 @@
+.Dd 2016-01-05
+.Dt PNG2FF 1
+.Os suckless.org
+.Sh NAME
+.Nm png2ff
+.Nd convert PNG to farbfeld
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+reads a PNG image from stdin, converts it to
+.Xr farbfeld 5
+and writes the result to stdout.
+.Pp
+In case of an error
+.Nm
+writes a diagnostic message to stderr.
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 0
+Image processed successfully.
+.It 1
+An error occurred.
+.El
+.Sh EXAMPLES
+$
+.Nm
+< image.png > image.ff
+.Pp
+$
+.Nm
+< image.png | bzip2 > image.ff.bz2
+.Sh SEE ALSO
+.Xr 2ff 1 ,
+.Xr bunzip2 1 ,
+.Xr bzip2 1 ,
+.Xr ff2png 1 ,
+.Xr jpg2ff 1 ,
+.Xr farbfeld 5
+.Sh AUTHORS
+.An Laslo Hunhold Aq Mt dev_AT_frign.de
Received on Tue Jan 05 2016 - 16:57:22 CET