           LaTeX Package ascii-emoticon 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 "ascii-emoticon," released August 2026.
The package provides predefined ASCII emoticons and macros
to create more. See the user guide for more information.
See below for license and installation instructions.

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

                    * Installation *

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

To install ascii-emoticon manually requires two steps as follows.

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

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

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

Step 2: Once you have created ascii-emoticon.sty, 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) ascii-emoticon-code.dtx: the main file. See above
      for instructions to generate emoticon.sty from this
      file and complete the installation.

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

  (3) ascii-emoticon-user-guide.pdf: a user guide.

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

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

                      * 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:
        ascii-emoticon-code.dtx

  (2) the package file:
        ascii-emoticon.sty

  (3) the derived files:
        ascii-emoticon-doc-patch.tex
        ascii-emoticon-heading.tex
        ascii-emoticon-user-guide.tex

  (4) the pdf documentation files:
        ascii-emoticon-code.pdf
        ascii-emoticon-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 ascii-emoticon-code.dtx. Happy TeXing!
