Directory macros/latex/contrib/unhook

               LaTeX Package unhook v. 1.0
                Installation Guide/README
                     Conrad Kosowsky




This file is README.txt from version 1.0 of the free and
open-source LaTeX package "unhook," released September 2026.
The package disables a number of LaTeX3 features to make it
easier to debug LaTeX2e code with tracing. See the user
guide for more information. See below for license, loading,
and installation instructions.

*********************************************************

                      * Loading *

Using unhook for anything other than tracing/debugging is
not recommended.

The package file is called unhook.tex, so you cannot load
unhook in your document with \usepackage. Instead, you
have to input the package file directly. You also have to
set the catcode of @ to 11 yourself, or the package will
stop loading and issue an error. If you don't know what
this means, then you very likely do not need this package.

*********************************************************

                    * Installation *

To install unhook automatically, update your TeX
distribution or use a package manager such as tlmgr.

To install unhook manually requires two steps as follows.

Step 1: You need to generate the package file unhook.tex
from unhook-code.dtx. You can do this in two ways:

  (1) Running Plain TeX on unhook-code.dtx will create
      unhook.tex as well as several other tex files
      that can be used for typesetting documentation.

  (2) Running LaTeX on unhook-code.dtx will produce the
      files listed in point (1) including unhook.tex as 
      well as unhook-code.pdf.

Step 2: Once you have created unhook.tex, you should
move it into a directory searchable by TeX to complete the
installation. If you are unsure how to do this, consult
your TeX distribution.

*********************************************************

                      * Contents *

Besides this README, the installation contains the following
items:

  (1) unhook-code.dtx: the main file. See above for
      instructions to generate unhook.tex from this
      file and complete the installation.

  (2) unhook-code.pdf: documentation of the package
      code.

  (3) unhook-user-guide.pdf: a user guide.

Typesetting unhook-code.dtx will generate the tex file
used to create unhook-user-guide.pdf.

*********************************************************

                      * License *

Copyright 2026 Conrad Kosowsky

This Work may be used, distributed, and modified under the
terms of the LaTeX Public Project License, version 1.3c or
any later version. The most recent version of this license
is available online at

          https://www.latex-project.org/lppl/.

This Work has the LPPL status "maintained," and the current
maintainer is the package author, Conrad Kosowsky. He can
be reached at kosowsky.latex@gmail.com. The Work consists
of the following items:

  (1) the base file:
        unhook-code.dtx

  (2) the package file:
        unhook.tex

  (3) the derived files:
        unhook-heading.tex
        unhook-user-guide.tex

  (4) the pdf documentation files:
        unhook-code.pdf
        unhook-user-guide.pdf

  (5) all other files created through the configuration
      process

    and

  (6) this README.txt file

*********************************************************

                    * No Warranty *

PLEASE KNOW THAT THIS FREE SOFTWARE IS PROVIDED WITHOUT
ANY WARRANTY. SPECIFICALLY, THE "NO WARRANTY" SECTION OF
THE LATEX PROJECT PUBLIC LICENSE STATES THE FOLLOWING:

THERE IS NO WARRANTY FOR THE WORK. EXCEPT WHEN OTHERWISE
STATED IN WRITING, THE COPYRIGHT HOLDER PROVIDES THE WORK
`AS IS’, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE
OF THE WORK IS WITH YOU. SHOULD THE WORK PROVE DEFECTIVE,
YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR
CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED
TO IN WRITING WILL THE COPYRIGHT HOLDER, OR ANY AUTHOR
NAMED IN THE COMPONENTS OF THE WORK, OR ANY OTHER PARTY
WHO MAY DISTRIBUTE AND/OR MODIFY THE WORK AS PERMITTED
ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
OF ANY USE OF THE WORK OR OUT OF INABILITY TO USE THE WORK
(INCLUDING, BUT NOT LIMITED TO, LOSS OF DATA, DATA BEING
RENDERED INACCURATE, OR LOSSES SUSTAINED BY ANYONE AS A
RESULT OF ANY FAILURE OF THE WORK TO OPERATE WITH ANY
OTHER PROGRAMS), EVEN IF THE COPYRIGHT HOLDER OR SAID
AUTHOR OR SAID OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

For more information, see the LaTeX Project Public License.
Derivative works based on this package may come with their
own license or terms of use, and the package author is not
responsible for any third-party software.

*********************************************************

For more information, see unhook-code.dtx. Happy TeXing!