Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
jlelong committed Nov 5, 2019
1 parent 9fe13f7 commit f56fe66
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 3 deletions.
11 changes: 9 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ Written by Jerome Lelong <[email protected]> and distributed under the ter
This package follows the TDS[1]

- put the TeX package `chklref.sty` into `$(texmf_prefix)/tex/latex/chklref`
- put the manual `chklref.pdf` into `$(texmf_prefix)/doc/latex/chklref`
- put the documentation `doc/chklref.pdf` into `$(texmf_prefix)/doc/latex/chklref`
- put the man page `doc/chklref.1` into `$(texmf_prefix)/doc/man/man1`
- put the Perl parser `chklref.pl` into `$(texmf_prefix)/scripts/chklref`

Note that you will also need to make a link or copy `chklref.pl` to a location in your `PATH`. On Unix systems, you may need to set the script as executable.
Expand Down Expand Up @@ -52,10 +53,16 @@ The full calling syntax is `perl chklref.pl [options] file.tex`, where `options`
- `--version`, `-v`: Print the version of this script.
- `--help,h`: Print this help.

[1] : TeX Directory Structure http://www.tug.org/twg/tds/
Alternatively, you can directly add `\usepackage{chklref}` to your main LaTeX file and compile it normally. This will create a file with extension `.chk`, which can then be parsed by the Perl script:

perl chklref.pl --parse-only file.tex

Note that you need to pass the \verb!.tex! file to the parser not the `.chk` file.

## Bugs

Report bugs to https://github.com/jlelong/chklref.

`chklref` is known not to work with `cleveref`. If you would like to contribute to `chklref`, feel free to open a PR on https://github.com/jlelong/chklref.

[1] : TeX Directory Structure http://www.tug.org/twg/tds/
3 changes: 2 additions & 1 deletion doc/chklref.tex
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,8 @@ \subsection{Installation into the \TeX\ structure}
\url{http://www.tug.org/twg/tds/}}:
\begin{itemize}
\item put the \TeX\ package \verb!chklref.sty! into \verb!$(texmf_prefix)/tex/latex/chklref!
\item put the manual \verb!chklref.pdf! into \verb!$(texmf_prefix)/doc/latex/chklref!
\item put the documentation \verb!doc/chklref.pdf! into \verb!$(texmf_prefix)/doc/latex/chklref!
\item put the man page \verb!doc/chklref.1! into \verb!$(texmf_prefix)/doc/man/man1!
\item put the Perl parser \verb!chklref.pl! into \verb!$(texmf_prefix)/scripts/chklref!
\end{itemize}
Note that you will also need to make a link or copy \verb!chklref.pl! to a location in your \texttt{PATH}. On Unix systems, you may need to set the script executable. \\
Expand Down

0 comments on commit f56fe66

Please sign in to comment.