diff options
Diffstat (limited to 'macros/latex/contrib/papermas/README')
-rw-r--r-- | macros/latex/contrib/papermas/README | 123 |
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 |