xaizek / zograscope (License: AGPLv3 only) (since 2018-12-07)
Mainly a syntax-aware diff that also provides a number of additional tools.
<root> / man / zs-hi.1 (22ee0ed1c75441902176821d4fd234919f88ed18) (1,339B) (mode 100644) [raw]
.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "zs-hi" "1" "July 19, 2022" "" ""
.hy
.SH NAME
.PP
\f[I]zs-hi\f[R] is a primitive code highlighter for terminal.
The main purpose is testing and debugging of code parsing, but it can
also be used on its own.
.PP
The only hard-coded color scheme at the moment is for xterm-256color
palette.
.SH INVOCATION
.PP
\f[V]zs-hi\f[R] \f[V][options...]\f[R] \f[I][{path|-}]\f[R]
.PP
Not providing \f[I]path\f[R] argument is equivalent to specifying
\f[V]-\f[R] and thus reading from standard input.
.SH EXAMPLES
.SS Highlighting standard input
.IP
.nf
\f[C]
pahole -C key_chunk_t vifm | zs-hi
\f[R]
.fi
.SS Highlighting a file
.IP
.nf
\f[C]
zs-hi utils.c
\f[R]
.fi
.SS Checking if code parses correctly
.PP
Whether the parser is able to handle given sources can be checked like
this:
.IP
.nf
\f[C]
find -name \[aq]*.[hc]\[aq] -exec zs-hi --dry {} \[rs];
\f[R]
.fi
.PP
It produces output for files with which it has issues.
.SH SEE ALSO
.PP
\f[B]zograscope\f[R](7) for common options and list of all tools there.
.SH AUTHORS
xaizek <xaizek@posteo.net>.
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/zograscope

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/zograscope

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master