Directory dviware/dvisirule

Copyright 2012-2022 Jiro Senju

This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version.

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this package. If not, see http://www.gnu.org/licenses/.

---

# dvisirule

Superimpose the covered / hidden or covered `\hline` and `\vline` in a
LaTeX tabular / colortbl environment.

Here *hidden* or *covered* means the unintentionally overwritten
`\hline`s and `\vline`s in a tabular.
They are surely drawn but other things such as a row background color
painted after hide them unintentionally.
See the example in `dvisirule.pdf`.

This package provides `dvisirule.sty` and `dvisirule` command.
The command is a `sh` script, and it internally uses `dvisirule-bin`,
`dvisirule-pgnum.awk`, `dvisirule-expg.mk`, and `dvisirule-marker.awk`
files.


## Compile & Install

$ cd $thisdir/src $ configure -q $ cd .. $ make -s Dir=/tmp

Then you will get these files.

/tmp/dvisirule /tmp/dvisirule-bin /tmp/dvisirule-expg.mk /tmp/dvisirule-marker.awk /tmp/dvisirule-pgnum.awk /tmp/dvisirule.sty

Now you can install them by

$ make InstallBase=/tmp/texmf-dist

Here `${InstallBase}` is a make-variable which is referred by other make-variables.

InstallBin ?= ${InstallBase}/bin InstallLib ?= ${InstallBase}/lib InstallSty ?= ${InstallBase}/lib/texinputs

and the files will be installed to these dirs.

${InstallBin}/dvisirule

${InstallLib}/dvisirule-bin ${InstallLib}/dvisirule-expg.mk ${InstallLib}/dvisirule-marker.awk ${InstallLib}/dvisirule-pgnum.awk

${InstallSty}/dvisirule.sty

Please note that these installed dirs have to be recognized by
`Kpathsea` since the main `sh` script `dvisirule` searches these
sub-files by `kpsewhich(1)`.


## Usage

`sitabular` environment is a wrapper of `tabular`, and all the syntax
is kept. You can use it by simply replacing `tabular` by `sitabular`.

`a.tex`

> `\usepackage{dvisirule}`

> `\begin{sitabular} ... \end{sitabular}`

and then

$ latex a.tex $ cp -p a.dvi a.dvi.save $ dvisirule a.dvi a-si.dvi $ mv a-si.dvi a.dvi

For more details, refer to `dvisirule.pdf` and other source files.


## Supported TeX Distribution

Basically I am a Linux / TeXLive user, and `dvisirule` is developed
and tested on TeXLive 2019 (Don't blame me for my laziness. I know the
version is old), and on Debian.
So I guess `dvisirule` will work well on Linux / TeXLive.

I have tried Linux / MiKTeX 22.8.28 too and `dvisirule` succeded with
a simple installation test.
I used `make -s DVISELECT=/brabra/dviselect DVICONCAT=/.../dviconcat`.
But I am not sure MS-Windows users would success, particularly some
executables including some scripts and a binary.
Someone said that Perl script is the best solution to run on both of
linux and windows. But I am not a Perl user (Ok, you can blame me for
my laziness).

If anyone contributes some scripts which are Windows-capable, I would
gladly review and merge into this pkg.