summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/papermas/README
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/papermas/README')
-rw-r--r--macros/latex/contrib/papermas/README123
1 files changed, 65 insertions, 58 deletions
diff --git a/macros/latex/contrib/papermas/README b/macros/latex/contrib/papermas/README
index b82ecc3f07..be7d632115 100644
--- a/macros/latex/contrib/papermas/README
+++ b/macros/latex/contrib/papermas/README
@@ -1,4 +1,4 @@
-README for papermas package, 2011/08/22, v1.0h
+README for papermas package, 2023-04-12, v1.1a
TABLE OF CONTENTS
@@ -17,36 +17,38 @@ TABLE OF CONTENTS
1 INTRODUCTION
==============
-This package allows to compute the mass of a printed version of a
-document, useful e.g. when sending it by mail to determine the postage.
+This LaTeX package allows to compute the mass of a printed version of a
+document, useful e.g. to determine the postage when sending it by snail mail.
Warning/Disclaimer: The mass of (printer's) ink has to be added and that
of envelope, address sticker, stamps,... Thus this is only an estimation
without guarantee - do not sue me, if you have got to pay excess postage!
-This material is subject to the LaTeX Project Public License
-(LPPL). See http://www.ctan.org/tex-archive/help/Catalogue/
-licenses.lppl.html for the details of that license.
+
+This material is published under the LPPL 1.3c: This work may be
+distributed and/or modified under the conditions of the LaTeX Project
+Public License, either version 1.3c of this license or (at your option)
+any later version. This version of this license is in
+https://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+https://www.latex-project.org/lppl.txt
+and version 1.3c or later is part of all distributions of
+LaTeX version 2005-12-01 or later.
2 DOWNLOAD
==========
-`papermas' is available on CTAN:
- CTAN:macros/latex/contrib/papermas/
-
-Also a ZIP file is provided that contains the files, already
-sorted in a TDS tree:
- CTAN:install/macros/latex/contrib/papermas.tds.zip
-
-`CTAN:' means one of the `Comprehensive TeX Archive Network'
-nodes or one of its mirrors. This is explained in
- http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives
+"papermas" is available on CTAN:
+https://ctan.org/pkg/papermas
-The CTAN stuff will be mirrored automatically from the
-ftp server, so
- ftp://ftp.tug.org/pub/tex/papermas/
-corresponds to
- CTAN:macros/latex/contrib/papermas/
+Also a ZIP file is provided that contains the files:
+the manual (papermas.pdf), the example (papermas-example.tex),
+the compiled example (papermas-example.pdf),
+driver (papermas.drv), papermas.dtx,
+installation file (papermas.ins),
+the style file (papermas.sty),
+and this README, already sorted in a TDS tree:
+https://mirror.ctan.org/install/macros/latex/contrib/papermas.tds.zip
3 INSTALLATION
@@ -54,10 +56,11 @@ corresponds to
Installation with ZIP file in TDS format
----------------------------------------
-The ZIP file `papermas.tds.zip' contains the files sorted
-in a TDS tree. Thus you can directly unpack the ZIP file
-inside a TDS tree.
-(See CTAN:tds.zip for an explanation of TDS.)
+The ZIP file "papermas.tds.zip" contains the files
+sorted in a TDS tree. Thus you can directly unpack the
+ZIP file inside a TDS tree.
+See https://ctan.org/TDS-guidelines for an explanation
+of TDS.
Example:
cd /...somewhere.../texmf
unzip /...downloadpath.../papermas.tds.zip
@@ -68,33 +71,38 @@ Example:
Manual installation
-------------------
-a) Download the papermas files from CTAN or the TUG server.
+a) Download the papermas files from CTAN.
If necessary, unpack them.
b) Generate the package and driver files:
- tex papermas.ins
-c) Install the file `*.sty' in your TDS tree:
- cp *.sty TDS:tex/latex/papermas/
- Replace `TDS:' by the prefix of your TDS tree
+ tex papermas.dtx
+c) Install the file "papermas.sty" in your TDS tree:
+ cp papermas.sty TDS:tex/latex/papermas/
+ Replace "TDS:" by the prefix of your TDS tree
(texmf directory).
-d) Copy the documentation files to
+d) Create the documentation, if necessary, e.g.
+ pdflatex papermas.dtx
+ makeindex -s gind.ist papermas.idx
+ pdflatex papermas.dtx
+ makeindex -s gind.ist papermas.idx
+ pdflatex papermas.dtx
+e) Update the databases if necessary, e.g. for TeXLive
+ texhash or mktexlsr.
+f) Create the papermas-example.pdf, if necessary, e.g.
+ pdflatex papermas-example.tex
+ pdflatex papermas-example.tex
+ pdflatex papermas-example.tex
+g) Copy the documentation files to
"TDS:doc/latex/papermas/":
README, papermas.pdf, papermas-example.tex,
papermas-example.pdf.
-e) Update the databases if necessary, e.g. for teTeX:
- mktexlsr .../texmf
4 ADDITIONAL PACKAGES
=====================
-Depending on the driver and option settings, papermas loads
-other packages:
-* kvoptions.sty:
- CTAN:macros/latex/contrib/oberdiek/kvoptions.dtx
-* intcalc.sty:
- CTAN:macros/latex/contrib/oberdiek/intcalc.dtx
-* pageslts.sty:
- CTAN:macros/latex/contrib/pageslts/pageslts.dtx
+papermas loads other packages:
+- kvoptions
+- intcalc
which again load other packages
(see the result of the \listfiles command in the log-file
of the example).
@@ -103,30 +111,30 @@ which again load other packages
5 PACKAGE COMPATIBILITY
=======================
-papermas should be loaded AFTER package pageslts.
+papermas should be loaded quite late.
6 AUTHOR/MAINTAINER
-=====================
+===================
-* H.-Martin Münch
+H.-Martin Münch
7 BUG REPORTS
-==============
+=============
A bug report should contain:
* Comprehensive problem description. This includes error or
warning messages.
- * \errorcontextlines=\maxdimen can be added in the
- TeX code to get more information in TeX error messages.
-* Minimal test file that shows the problem, but does not
- contain any unnecessary packages and code.
+* \errorcontextlines=\maxdimen can be added in the
+ TeX code to get more information in TeX error messages.
+* Minimal test file that shows the problem,
+ but does not contain any unnecessary packages and code.
* Used drivers/programs.
* Version information about used packages and programs.
- * If you are using LaTeX, then add "\listfiles". Then
- a list of version information is printed at the end
- of the LaTeX run.
+* If you are using LaTeX, then add "\listfiles" to the document.
+ Then a list of version information is printed at the end
+ of the LaTeX run.
* Please no other files than the minimal test file.
The other files .log, .dvi, .ps, .pdf are seldom
necessary, so send them only on request.
@@ -135,14 +143,13 @@ A bug report should contain:
Bug address
-----------
Bug reports can be send to the maintainer:
- H.-Martin Münch
+ H.-Martin Münch
<Martin [dot] Muench [at] Uni-Bonn [dot] de>
8 KNOWN PROBLEMS
-=================
+================
-TeX 2011/06/27 has changed \enddocument and
-thus broken the \AtVeryVeryEnd command/hooking
-of atveryend package as of 2011/04/23, v1.7.
-Until it is fixed, \AtEndAfterFileList is used.
+Needs TeX-Format LaTeX2e 2022-11-01 or newer;
+for older formats an older papermas package version is available at
+https://web.archive.org/web/20190417084752/https://mirror.ctan.org/install/macros/latex/contrib/papermas.tds.zip \ No newline at end of file