CVS commit: pkgsrc/sysutils/hexyl

["pin" <pin%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   pin
Date:           Sun Sep 10 18:34:07 UTC 2023

Modified Files:
        pkgsrc/sysutils/hexyl: Makefile PLIST
Added Files:
        pkgsrc/sysutils/hexyl/files: hexyl.1

Log Message:
sysutils/hexyl: install man page


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 pkgsrc/sysutils/hexyl/Makefile
cvs rdiff -u -r1.1 -r1.2 pkgsrc/sysutils/hexyl/PLIST
cvs rdiff -u -r0 -r1.1 pkgsrc/sysutils/hexyl/files/hexyl.1

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/sysutils/hexyl/Makefile
diff -u pkgsrc/sysutils/hexyl/Makefile:1.7 pkgsrc/sysutils/hexyl/Makefile:1.8
--- pkgsrc/sysutils/hexyl/Makefile:1.7  Wed Jul 26 19:37:47 2023
+++ pkgsrc/sysutils/hexyl/Makefile      Sun Sep 10 18:34:07 2023
@@ -1,6 +1,7 @@
-# $NetBSD: Makefile,v 1.7 2023/07/26 19:37:47 pin Exp $
+# $NetBSD: Makefile,v 1.8 2023/09/10 18:34:07 pin Exp $
 
 DISTNAME=      hexyl-0.13.1
+PKGREVISION=   1
 CATEGORIES=    sysutils
 MASTER_SITES=  ${MASTER_SITE_GITHUB:=sharkdp/}
 GITHUB_TAG=    v${PKGVERSION_NOREV}
@@ -12,11 +13,13 @@ LICENSE=    apache-2.0
 
 .include "cargo-depends.mk"
 
-INSTALLATION_DIRS=     bin
+INSTALLATION_DIRS=     ${PKGMANDIR}/man1
 
-do-install:
-       ${INSTALL_PROGRAM} ${WRKSRC}/target/release/${PKGBASE} \
-               ${DESTDIR}${PREFIX}/bin
+post-build:
+       ${CP} ${FILESDIR}/hexyl.1 ${WRKDIR}/hexyl.1
+
+post-install:
+       ${INSTALL_MAN} ${WRKDIR}/hexyl.1 ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1
 
 .include "../../lang/rust/cargo.mk"
 .include "../../mk/bsd.pkg.mk"

Index: pkgsrc/sysutils/hexyl/PLIST
diff -u pkgsrc/sysutils/hexyl/PLIST:1.1 pkgsrc/sysutils/hexyl/PLIST:1.2
--- pkgsrc/sysutils/hexyl/PLIST:1.1     Thu Jan 13 14:13:59 2022
+++ pkgsrc/sysutils/hexyl/PLIST Sun Sep 10 18:34:07 2023
@@ -1,2 +1,3 @@
-@comment $NetBSD: PLIST,v 1.1 2022/01/13 14:13:59 schmonz Exp $
+@comment $NetBSD: PLIST,v 1.2 2023/09/10 18:34:07 pin Exp $
 bin/hexyl
+man/man1/hexyl.1

Added files:

Index: pkgsrc/sysutils/hexyl/files/hexyl.1
diff -u /dev/null pkgsrc/sysutils/hexyl/files/hexyl.1:1.1
--- /dev/null   Sun Sep 10 18:34:07 2023
+++ pkgsrc/sysutils/hexyl/files/hexyl.1 Sun Sep 10 18:34:07 2023
@@ -0,0 +1,186 @@
+.nh
+.TH HEXYL(1) hexyl 0.12.0 | General Commands Manual
+%
+2022-12-05
+
+.SH NAME
+.PP
+hexyl - a command-line hex viewer
+
+
+.SH SYNOPSIS
+.PP
+\fBhexyl\fP [\fIOPTIONS\fP] [\fIFILE\fP]
+
+
+.SH DESCRIPTION
+.PP
+\fBhexyl\fP is a simple hex viewer for the terminal.
+It uses a colored output to distinguish different categories of bytes (NULL
+bytes, printable ASCII characters, ASCII whitespace characters, other ASCII
+characters and non-ASCII).
+
+
+.SH POSITIONAL ARGUMENTS
+.TP
+\fIFILE\fP
+The file to display.
+If no \fIFILE\fP argument is given, read from STDIN.
+
+
+.SH OPTIONS
+.TP
+\fB-n\fP, \fB--length\fP \fIN\fP
+Only read \fIN\fP bytes from the input.
+The \fIN\fP argument can also include a unit with a decimal prefix (kB, MB, ..)
+or binary prefix (kiB, MiB, ..), or can be specified using a hex number.Examples:
+Read the first 64 bytes:
+$ \fBhexyl --length=64\fP
+
+.TP
+Read the first 4 kibibytes:
+$ \fBhexyl --length=4KiB\fP
+
+.TP
+Read the first 255 bytes (specified using a hex number):
+$ \fBhexyl --length=0xff\fP
+
+
+
+.TP
+\fB-c\fP, \fB--bytes\fP \fIN\fP
+An alias for \fB-n\fP/\fB--length\fP\&.
+
+.TP
+\fB-l\fP \fIN\fP
+Yet another alias for \fB-n\fP/\fB--length\fP\&.
+
+.TP
+\fB-s\fP, \fB--skip\fP \fIN\fP
+Skip the first \fIN\fP bytes of the input.
+The \fIN\fP argument can also include a unit (see \fB--length\fP for details).
+A negative value is valid and will seek from the end of the file.
+
+.TP
+\fB--block-size\fP \fISIZE\fP
+Sets the size of the block unit to \fISIZE\fP (default is 512).Examples:
+Sets the block size to 1024 bytes:
+$ \fBhexyl --block-size=1024 --length=5block\fP
+
+.TP
+Sets the block size to 4 kilobytes:
+$ \fBhexyl --block-size=4kB --length=2block\fP
+
+
+
+.TP
+\fB-v\fP, \fB--no-squeezing\fP
+Displays all input data.
+Otherwise any number of groups of output lines which would be identical to
+the preceding group of lines, are replaced with a line comprised of a
+single asterisk.
+
+.TP
+\fB--color\fP \fIWHEN\fP
+When to use colors.
+The auto-mode only displays colors if the output goes to an interactive
+terminal.Possible values:
+- \fBalways\fP (default)
+.RS
+.IP \(bu 2
+\fBauto\fP
+.IP \(bu 2
+\fBnever\fP
+
+.RE
+
+
+
+.TP
+\fB--border\fP \fISTYLE\fP
+Whether to draw a border with Unicode characters, ASCII characters, or none
+at all.Possible values:
+- \fBunicode\fP (default)
+.RS
+.IP \(bu 2
+\fBascii\fP
+.IP \(bu 2
+\fBnone\fP
+
+.RE
+
+
+
+.TP
+\fB-o\fP, \fB--display-offset\fP \fIN\fP
+Add \fIN\fP bytes to the displayed file position.
+The \fIN\fP argument can also include a unit (see \fB--length\fP for details).
+A negative value is valid and calculates an offset relative to the end of
+the file.
+
+.TP
+\fB-h\fP, \fB--help\fP
+Prints help information.
+
+.TP
+\fB-V\fP, \fB--version\fP
+Prints version information.
+
+
+.SH NOTES
+.TP
+Source repository:
+https://github.com/sharkdp/hexyl
+\[la]https://github.com/sharkdp/hexyl\[ra]
+
+
+.SH EXAMPLES
+.TP
+Print a given file:
+$ \fBhexyl small.png\fP
+
+.TP
+Print and view a given file in the terminal pager:
+$ \fBhexyl big.png | less -r\fP
+
+.TP
+Print the first 256 bytes of a given special file:
+$ \fBhexyl -n 256 /dev/urandom\fP
+
+
+.SH AUTHORS
+.PP
+\fBhexyl\fP was written by David Peter mail%david-peter.de@localhost
+\[la]mailto:mail%david-peter.de@localhost\[ra]\&;.
+
+
+.SH REPORTING BUGS
+.TP
+Bugs can be reported on GitHub at:
+https://github.com/sharkdp/hexyl/issues
+\[la]https://github.com/sharkdp/hexyl/issues\[ra]
+
+
+.SH COPYRIGHT
+.TP
+\fBhexyl\fP is dual-licensed under:
+
+.RS
+.IP \(bu 2
+Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0
+\[la]https://www.apache.org/licenses/LICENSE-2.0\[ra])
+
+.RE
+
+.RS
+.IP \(bu 2
+MIT License (https://opensource.org/licenses/MIT
+\[la]https://opensource.org/licenses/MIT\[ra])
+
+.RE
+
+
+
+.SH SEE ALSO
+.PP
+\fBhexdump\fP(1), \fBxxd\fP(1)