From 1f2855b00ed53226ad9141e4d313f42af42b83a7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 11 Jun 2010 00:43:33 +0000 Subject: papermas 1.0b (10jun10) git-svn-id: svn://tug.org/texlive/trunk@18884 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/papermas/README | 147 ++++++++++++++++++++ Master/texmf-dist/doc/latex/papermas/ltxdoc.cfg | 103 ++++++++++++++ .../doc/latex/papermas/papermas-example.pdf | Bin 0 -> 103773 bytes .../doc/latex/papermas/papermas-example.tex | 153 +++++++++++++++++++++ Master/texmf-dist/doc/latex/papermas/papermas.pdf | Bin 0 -> 449754 bytes 5 files changed, 403 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/papermas/README create mode 100644 Master/texmf-dist/doc/latex/papermas/ltxdoc.cfg create mode 100644 Master/texmf-dist/doc/latex/papermas/papermas-example.pdf create mode 100644 Master/texmf-dist/doc/latex/papermas/papermas-example.tex create mode 100644 Master/texmf-dist/doc/latex/papermas/papermas.pdf (limited to 'Master/texmf-dist/doc/latex/papermas') diff --git a/Master/texmf-dist/doc/latex/papermas/README b/Master/texmf-dist/doc/latex/papermas/README new file mode 100644 index 00000000000..ec3b8e97bbc --- /dev/null +++ b/Master/texmf-dist/doc/latex/papermas/README @@ -0,0 +1,147 @@ +README for papermas package, 2010/06/03, v1.0b + + +TABLE OF CONTENTS +================= + +1 Introduction +2 Download +3 Installation +4 Additional Packages +5 New Features +6 Package Compatibility +7 Authors/Maintainers +8 Bug Reports +9 Known Problems + + +1 INTRODUCTION +============== + +This package allows to compute the mass of a printed version of a +document, usefull e. g. when sending it by mail to determine the postage. + +Warning/Disclaimer: The mass of (printer's) ink has to be added (and that +of envelope, address sticker, stamps,...). So, this is only an estimation without +guarantee - do not sue me, if you have got to pay excess postage! + +Further it allows to compute "base to the power of exponent" inside LaTeX. + + +2 DOWNLOAD +========== + +`papermas' should become available on CTAN soon: + CTAN:macros/latex/contrib/muench/papermas/ + +Also a ZIP file is provided that contains the files, already +sorted in a TDS tree (should become available on CTAN soon): + CTAN:install/macros/latex/contrib/muench/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 + +The CTAN stuff will be mirrored automatically from the +ftp server, so + ftp://ftp.tug.org/pub/tex/muench/pagesLTS/ +corresponds to + CTAN:macros/latex/contrib/muench/pagesLTS/ + + +3 INSTALLATION +============== + +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.) +Example: + cd /...somewhere.../texmf + unzip /...downloadpath.../papermas.tds.zip +Do not forget to refresh the file name database of this +TDS tree. +Example: + texhash /...somewhere.../texmf + +Manual installation +------------------- +a) Download the papermas files from CTAN or the TUG server. + If necessary, unpack them. +b) If directory `beta' exists, replace the files by the + counterparts in this directory, if you want to use the + latest versions. +c) Generate the package and driver files: + tex papermas.ins +d) Install the files `*.sty', and `*.cfg' in your TDS tree: + cp *.sty *.cfg TDS:tex/latex/muench/papermas/ + Replace `TDS:' by the prefix of your TDS tree + (texmf directory). +e) Copy the documentation files to + "TDS:doc/latex/muench/papermas/": + README, papermas.pdf, papermas-example.tex, + papermas-example.pdf. +f) 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.pdf +* pagesLTS.sty: + CTAN:macros/latex/contrib/muench/pagesLTS.dtx + (submitted, should become available on CTAN soon) +which again load other packages +(see the result of the \listfiles comman in the log-file + of the example). + + +5 PACKAGE COMPATIBILITY +======================= + +papermas should be loaded AFTER package pagesLTS. + + +6 AUTHOR/MAINTAINER +===================== + +* Hans-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 informations 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 informations 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. +* Please .zip or .tar.gz your file(s) before sending them! + +Bug address +----------- +Bug reports can be send to the maintainer: + Hans-Martin Münch + + + +8 KNOWN PROBLEMS +================= + +* as yet: none... \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/papermas/ltxdoc.cfg b/Master/texmf-dist/doc/latex/papermas/ltxdoc.cfg new file mode 100644 index 00000000000..cd1b1462b9f --- /dev/null +++ b/Master/texmf-dist/doc/latex/papermas/ltxdoc.cfg @@ -0,0 +1,103 @@ +%% +%% This is file `ltxdoc.cfg', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% papermas.dtx (with options: `ltxdoc') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% 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 +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and 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 version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file papermas.dtx +%% and the derived files +%% papermas.sty, papermas.pdf, papermas.ins, papermas.drv, +%% papermas-example.tex. +%% +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesFile{ltxdoc.cfg}[2010/05/15 v1.0 configuration file for papermas (HMM)] + %% Code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)], %% + % copyrighted 2006, 2007 Heiko Oberdiek, part of project `latex-tds'. + % That file may be distributed and/or modified under the + % conditions of the LaTeX Project Public License, either version 1.3 + % of this license or (at your option) any later version. + % 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 + % version 2005/12/01 or later. + % That work has the LPPL maintenance status `maintained'. + % The Current Maintainer of that work is Heiko Oberdiek. + % + \PassOptionsToClass{a4paper}{article} + \AtEndOfClass{% + \RequirePackage[numbered]{hypdoc}[2010/03/26]% v1.9 + \pdfstringdefDisableCommands{% + \let\env\relax % longtable.dtx + \let\mytt\relax % tabularx.dtx + }% + \addtolength{\topmargin}{-10mm}% + \addtolength{\textheight}{20mm}% + % Depending on the page style, the head or foot area + % are put into the text area. + % Usually the page style is the default "plain". + % tools/verbatim.dtx uses "myheadings". + \def\string@plain{plain}% + \def\string@myheadings{myheadings}% + \def\current@pagestyle{plain}% + \let\ltxdoc@cfg@pagestyle\pagestyle + \def\pagestyle#1{% + \def\current@pagestyle{#1}% + \ltxdoc@cfg@pagestyle{#1}% + }% + \edef\ltxdoc@cfg@jobname{\jobname}% + \def\ltxdoc@cfg@longtable{longtable}% + \@onelevel@sanitize\ltxdoc@cfg@longtable + \ifx\ltxdoc@cfg@jobname\ltxdoc@cfg@longtable + \def\current@pagestyle{both}% + \fi + \let\ltxdoc@cfg@document\document + \def\document{% + \ifx\current@pagestyle\string@plain + \addtolength{\textheight}{\headheight}% + \addtolength{\textheight}{\headsep}% + \setlength{\headheight}{0pt}% + \setlength{\headsep}{0pt}% + \global\textheight\textheight + \global\headheight\headheight + \global\headsep\headsep + \fi + \ifx\current@pagestyle\string@myheadings + \addtolength{\textheight}{\footskip}% + \global\textheight\textheight + \fi + \ltxdoc@cfg@document + }% + %% End of code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)] %% + %% Place additional code here. %% + } + +\endinput +%% +%% End of file `ltxdoc.cfg'. diff --git a/Master/texmf-dist/doc/latex/papermas/papermas-example.pdf b/Master/texmf-dist/doc/latex/papermas/papermas-example.pdf new file mode 100644 index 00000000000..ef7e1901dfe Binary files /dev/null and b/Master/texmf-dist/doc/latex/papermas/papermas-example.pdf differ diff --git a/Master/texmf-dist/doc/latex/papermas/papermas-example.tex b/Master/texmf-dist/doc/latex/papermas/papermas-example.tex new file mode 100644 index 00000000000..89a6a2a192b --- /dev/null +++ b/Master/texmf-dist/doc/latex/papermas/papermas-example.tex @@ -0,0 +1,153 @@ +%% +%% This is file `papermas-example.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% papermas.dtx (with options: `example') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% 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 +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and 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 version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file papermas.dtx +%% and the derived files +%% papermas.sty, papermas.pdf, papermas.ins, papermas.drv, +%% papermas-example.tex. +%% +\documentclass[british,a4paper]{article} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\usepackage{hyperref}[2010/05/13]% v6.81e +\hypersetup{% + extension=pdf,% + plainpages=false,% + pdfpagelabels=true,% + hyperindex=false,% + pdflang={en},% + pdftitle={papermas package example},% + pdfauthor={Hans-Martin Muench},% + pdfsubject={Example for the papermas package},% + pdfkeywords={LaTeX, papermas, Hans-Martin Muench},% + pdfview=Fit,% + pdfstartview=Fit,% + pdfpagelayout=SinglePage,% + bookmarksopen=false% +} +\usepackage{alphalph}[2010/04/18]% v2.3 +\usepackage[pagecontinue=true,alphMult=ab,AlphMulti=AB,fnsymbolmult=true,romanMult=true,RomanMulti=true]{pagesLTS}[2010/06/03]% v1.1b +%% These are the default options. %% +\usepackage[format=4,masss=80,pagespersheet=2]{papermas} +%% These are the default options. %% +\listfiles +\begin{document} +\pagenumbering{arabic} + +\section*{Example for papermas} +\markboth{Example for papermas}{Example for papermas} + +This example demonstrates the use of package\newline +\textsf{papermas}, v1.0b as of 2010/06/03 (HMM).\newline +The used options were \texttt{format=4} (ISO~A4), +\texttt{masss=80} ($\unit{g}\unit{m}^{-2}$), and\newline +\texttt{pagespersheet=2} (pages per sheet of paper, +i.\,e. either duplex printing or\newline +printing two pages on one side of a sheet of paper with blank back side).\newline +(These are the default options.)\newline +For more details please see the documentation!\newline + +\bigskip + +This document consists of +\lastpageref{LastPages}~(\arabic{pagesLTS.pagenr})~pages. +When printing $\papermaspagespersheet$~pages on one sheet of +paper, $\papermassheets$~sheets will be needed. For +ISO~A~\papermasformat\ paper of $\papermasmasss \unit{g}\unit{m}^{-2}$ +specific mass, the printout will have a mass of about +$\papermasstotal \unit{g}$. + +\bigskip + +Save per page about $200\unit{ml}$~water, $2\unit{g}$~CO$_{2}$ +and $2\unit{g}$~wood:\newline +Therefore please print only if this is really necessary.\newline +I do NOT think, that it is necessary to print THIS file, really\newline +(at least not after this page)! + + +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Page \thepage +\newpage Last page \thepage. +\end{document} +\endinput +%% +%% End of file `papermas-example.tex'. diff --git a/Master/texmf-dist/doc/latex/papermas/papermas.pdf b/Master/texmf-dist/doc/latex/papermas/papermas.pdf new file mode 100644 index 00000000000..d8c55f1b6b3 Binary files /dev/null and b/Master/texmf-dist/doc/latex/papermas/papermas.pdf differ -- cgit v1.2.3