summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-08-16 21:02:37 +0000
committerKarl Berry <karl@freefriends.org>2021-08-16 21:02:37 +0000
commitbd9cfec674815d09ac10cda49d49c2885cb23172 (patch)
treed1214272b63ebf4877252c38d895f69c87a1a7ce /Master/texmf-dist/doc
parent4f7047e6564e59b28109c6abfddd70158e07d7d9 (diff)
makelabels (16aug21)
git-svn-id: svn://tug.org/texlive/trunk@60255 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/LICENSE.md19
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/README.md123
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.pdfbin0 -> 45918 bytes
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.tex47
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/makelabels-example.pdfbin0 -> 34948 bytes
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/makelabels-example.tex41
-rw-r--r--Master/texmf-dist/doc/latex/makelabels/makelabels.pdfbin0 -> 686795 bytes
7 files changed, 230 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/makelabels/LICENSE.md b/Master/texmf-dist/doc/latex/makelabels/LICENSE.md
new file mode 100644
index 00000000000..99a6973749b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/LICENSE.md
@@ -0,0 +1,19 @@
+----------------------------------------------------------------------------
+
+This work may be distributed and/or modified under the conditions of the
+LaTeX Project Public License, version 1.3c of the license. The latest
+version of this license is in http://www.latex-project.org/lppl.txt and
+version 1.3c or later is part of all distributions of LaTeX 2005/12/01
+or later. This work has the LPPL maintenance status “maintained”.
+The current maintainer and author of this work is Markus Kohm.
+
+----------------------------------------------------------------------------
+
+Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz
+in der Version 1.3c, verteilt und/oder verändert werden. Die aktuelle
+Version dieser Lizenz ist http://www.latex-project.org/lppl.txt und
+Version 1.3c oder später ist Teil aller Verteilungen von LaTeX 2005/12/01
+oder später. Dieses Werk hat den LPPL-Verwaltungs-Status „maintained”
+Der aktuelle Verwalter und Autor dieses Werks ist Markus Kohm.
+
+----------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/makelabels/README.md b/Master/texmf-dist/doc/latex/makelabels/README.md
new file mode 100644
index 00000000000..988b116c4f7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/README.md
@@ -0,0 +1,123 @@
+# Letter Class Option `makelabels`
+
+----------------------------------------------------------------------------
+
+Copyright (c) Markus Kohm, 2009-2021
+Licence: LPPL 1.3c
+Release: 2021/08/14 v1.0
+
+----------------------------------------------------------------------------
+
+Requires: KOMA-Script
+
+----------------------------------------------------------------------------
+
+## Summary
+
+The standard letter class `letter` has a label feature. You can activate it
+using `\makelabels`. While in Germany window envelopes are common, printing
+labels is not common and `scrlttr2` never supported label printing. At the
+[German KOMA-Script book](https://komascript.de/komascriptbuch) I've shown
+how you can print labels simply by printing a letter with special pseudo
+value settings. Doing so you can use several configuration features. Using
+`makelabels.lco` in opposite does only implement a `\makelabels` feature
+similar to the standard letter classes. Currently there are no
+configuration features at `makelabels.lco`. But you may use package
+[`envlab`](https://www.ctan.org/pkg/envlab) from CTAN after loading
+`makelabels.lco` to get various configuration features.
+
+## Installation
+
+It is recommended to use the package manager of your TeX distribution to
+install `makelabels.lco`. But if this is not possible of if you are a
+distribution you can either use `l3build` and [sources from the git
+repository](https://github.com/komascript/makelabels) or a completely manual
+installation using a basic source file distribution.
+
+### Manual installation using `l3build` and the git sources
+
+First of all copy or clone the sources of the current release or the developer
+code from [github](https://github.com/komascript/makelabels) and use
+
+ l3build unpack
+
+to unpack the package. The unpacked files then can be found be in
+`build/unpacked`. You can use
+
+ l3build doc
+
+to generate the manual and the example PDFs.
+
+ l3build install
+
+to install the package locally. But this will neither install the manual nor
+nor the example files. Currently there are two example files, generated by
+`l3build`:
+
+ - `makelabels-example.tex` is the source of a very simple example using
+ `scrletter` class and `makelabels.lco` only. The result can be found in
+ `makelabels-example.pdf`
+ - `makelabels-envlab-example.tex` is the source of an example that shows
+ how to use package [`envlab`](https://www.ctan.org/pkg/envlab) in
+ combination with `scrletter` class and `makelabels.lco` to have more
+ versability.
+
+### Manual installation using a basic source distribution
+
+A basic source distribution consists of `makelabels.dtx` and `README.md`
+only. There may be additional manual and demo files like `makelabels.pdf`,
+`makelabels-example.pdf` or `makelabels-envlab-example.pdf`.
+
+If you have got such a basic source distribution, i.e., from CTAN,
+you first have to unpack the files using:
+
+ tex makelabels.dtx
+
+Don't use `latex`, `pdflatex`, `lualatex` or `xelatex` instead of `tex`!
+The unpacking will produce `makelabels.lco`, `makelabels-example.tex` and
+`makelabels-envlab-example.tex`.
+
+If your source distribution does not contain the manual `makelabels.pdf` and
+the example files `makelabals-example.pdf` and `makelabels-envlab-example.pdf`
+you can generate these (after the unpacking previously explained) using:
+
+ pdflatex makelabels-example.tex
+ pdflatex makelabels-example.tex
+ pdflatex makelabels-envlab-example.tex
+ pdflatex makelabale-envlab-example.tex
+ pdflatex makelabels.dtx
+ mkindex makelabels
+ pdflatex makelabels.dtx
+ mkindex makelabels
+ pdflatex makelabels.dtx
+
+To install all the runtime files, make a folder `tex/latex/makelabels` in you
+private or local TEXMF tree if this folder does not yet exists. Then copy
+`makelabels.lco` to this folder.
+
+To install the manual and the demo files, make a folder `doc/latex/makelabels`
+in the same TEXMF tree you've uses for the installation of
+`makelabels.lco`, if the folder does not yet exists. Then copy the demo files
+`makelabels-example.tex`, `makelabels-envlab-example.tex`,
+`makelabels-example.pdf`, `makelabels-envlab-example.pdf` and the manual
+`makelabels.pdf` to this folder.
+
+ MiKTeX users have to additionally update the *Filename Database*. See the
+ manual of the *MiKTeX console* for more information. TeX Live user usually do
+ not need to run `texhash`, because the private and the personal TEXMF tree is
+ usually searched completely.
+
+## Usage
+
+Like all other LCO files you can load `makelabels.lco` using
+`\LoadLetterOption{makelabels}`. For `scrlttr2` loading via optional
+argument of `\documentclass` also works, but is not recommended any longer.
+
+After loading the LCO file, you can add `\makelabels` into your document
+preamble to active the automatic generation of labels at the end of the
+document while reading the `*.aux`-file.
+
+Note: In oposite to other LCO files you must not load `mkalelabels.lco`
+after `\begin{document}`!
+
+See the manual for more information.
diff --git a/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.pdf b/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.pdf
new file mode 100644
index 00000000000..efe48824528
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.tex b/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.tex
new file mode 100644
index 00000000000..0f3e3f2578b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/makelabels-envlab-example.tex
@@ -0,0 +1,47 @@
+%%
+%% This is file `makelabels-envlab-example.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% makelabels.dtx (with options: `exmpl,envlab')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from makelabels-envlab-example.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file makelabels.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+\ProvidesFile{makelabels-envlab-example.tex}
+ [2021/08/14 v1.0 provide labels with scrlttr2 and scrletter]
+\documentclass[paper=letter]{scrletter}
+\LoadLetterOptions{UScommercial9,makelabels}
+\usepackage[english]{babel}
+\usepackage{blindtext}
+\setkomavar{fromname}{John Doe}
+\setkomavar{fromaddress}{1 Lambda Street\\Anyplace, NY 12345}
+
+\usepackage[centerenvelopes,businessenvelope]{envlab}
+\setlength{\FromAddressTopMargin}{0.25in}
+\setlength{\FromAddressLeftMargin}{0.25in}
+\makelabels
+
+\begin{document}
+
+\begin{letter}{Jane Doe\\2 Alpha Street\\Otherplace, NY 12346}
+\opening{Dear Jane,}
+\blindtext
+\closing{With love}
+\end{letter}
+\end{document}
+\endinput
+%%
+%% End of file `makelabels-envlab-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/makelabels/makelabels-example.pdf b/Master/texmf-dist/doc/latex/makelabels/makelabels-example.pdf
new file mode 100644
index 00000000000..0259dd794b6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/makelabels-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/makelabels/makelabels-example.tex b/Master/texmf-dist/doc/latex/makelabels/makelabels-example.tex
new file mode 100644
index 00000000000..c74f9ae9f9f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/makelabels-example.tex
@@ -0,0 +1,41 @@
+%%
+%% This is file `makelabels-example.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% makelabels.dtx (with options: `exmpl,simple')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from makelabels-example.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file makelabels.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+\ProvidesFile{makelabels-example.tex}
+ [2021/08/14 v1.0 provide labels with scrlttr2 and scrletter]
+\documentclass[paper=letter]{scrletter}
+\LoadLetterOptions{UScommercial9,makelabels}
+\usepackage[english]{babel}
+\usepackage{blindtext}
+\setkomavar{fromname}{John Doe}
+\setkomavar{fromaddress}{1 Lambda Street\\Anyplace, NY 12345}
+\makelabels
+\begin{document}
+\begin{letter}{Jane Doe\\2 Alpha Street\\Otherplace, NY 12346}
+\opening{Dear Jane,}
+\blindtext
+\closing{With love}
+\end{letter}
+\end{document}
+\endinput
+%%
+%% End of file `makelabels-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/makelabels/makelabels.pdf b/Master/texmf-dist/doc/latex/makelabels/makelabels.pdf
new file mode 100644
index 00000000000..1c5f282bf07
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/makelabels/makelabels.pdf
Binary files differ