diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/cdpbundl')
-rw-r--r-- | Master/texmf-dist/doc/latex/cdpbundl/00readme.txt | 194 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/cdpbundl/manifest.txt | 36 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/cdpbundl/overview.pdf | bin | 678930 -> 679245 bytes |
3 files changed, 114 insertions, 116 deletions
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt b/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt index 0ee85668d63..a6e828117d0 100644 --- a/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt +++ b/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt @@ -4,7 +4,7 @@ This is file `00readme.txt'. This file is part of a work named "C.D.P. Bundle". -Copyright (C) 1999-2005 by Gustavo MEZZETTI <mezzetti@math.unipd.it>. +Copyright (C) 1999-2006 by Gustavo MEZZETTI <mezzetti@math.unipd.it>. The C.D.P. Bundle may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 @@ -26,7 +26,7 @@ This file, after giving a brief description of the C.D.P. Bundle, explains how to install it and how to generate its--alas, still incomplete!--documentation. -January 1, 2005 +January 1, 2006 (vers. 0.34) @@ -45,19 +45,18 @@ CONTENTS A DOZEN LINES DESCRIPTION OF THE SOFTWARE ========================================= -The C.D.P. Bundle was originally developed for a free association -named "C.D.P." (more on it in the documentation), to typeset its -official letters with the appropriate letterhead; but more generally, -it can be used to typeset high-quality business letters formatted -according to Italian style conventions. It is highly configurable, -and its modular structure provides you with building blocks of -increasing level, by means of which you can compose practically every -kind of business letter you could need (including anglo-saxon ones!). -It is also possible to write letters divided into sections and -paragraphs, to include floating figures and tables, and to use the -commands "\tableofcontents", "\listoffigures", and "\listoftables" to -compile the relevant indexes. A single input file can contain several -letters, and each letter will have its own table of contents, etc., +The C.D.P. Bundle was originally developed for a free association named +"C.D.P." (more on it in the documentation), to typeset its official letters +with the appropriate letterhead; but more generally, it can be used to +typeset high-quality business letters formatted according to Italian style +conventions. It is highly configurable, and its modular structure provides +you with building blocks of increasing level, by means of which you can +compose practically every kind of business letter you could need (including +anglo-saxon ones!). It is also possible to write letters divided into +sections and paragraphs, to include floating figures and tables, and to use +the commands "\tableofcontents", "\listoffigures", and "\listoftables" to +compile the relevant indexes. A single input file can contain several +letters, and each letter will have its own table of contents, etc., independent from the other ones. @@ -65,24 +64,24 @@ independent from the other ones. DRAWBACKS ========= -The documentation included in this distribution is absolutely minimal. -For meaningful instructions on how to use the macros, the reader is -referred to other documents available at the web site of the author's -department, which, however, are written in Italian. Since the main -purpose of these macros is to typeset letters according to Italian -conventions, this should not be a problem. I shall consider translating -the documentation in English only if at least 5 persons ask me to. +The documentation included in this distribution is absolutely minimal. For +meaningful instructions on how to use the macros, the reader is referred to +other documents available at the web site of the author's department, +which, however, are written in Italian. Since the main purpose of these +macros is to typeset letters according to Italian conventions, this should +not be a problem. I will consider translating the documentation in English +only if at least 5 persons ask me to. INSTALLATION IN A SNAPSHOT ========================== -The C.D.P. Bundle is distributed in the usual .dtx + .ins format. The -main file is `cdpbundl.dtx', with installation script `cdpbundl.ins'. -Do the usual things to install it and to generate the documentation. -If you don't know what the usual things are, read below. Note that to -generate the documentation you should do the following: +The C.D.P. Bundle is distributed in the usual .dtx + .ins format. The main +file is `cdpbundl.dtx', with installation script `cdpbundl.ins'. Do the +usual things to install it and to generate the documentation. If you don't +know what the usual things are, read below. Note that in order to generate +the documentation you should do the following: latex; latex; makeindex (.idx); makeindex (.glo); latex; latex. @@ -91,17 +90,17 @@ latex; latex; makeindex (.idx); makeindex (.glo); latex; latex. CHECKING THE CONTENTS OF THE DISTRIBUTION ========================================= -Before installing the C.D.P. Bundle and generating its documentation, it -is a good idea to read the file `manifest.txt', which lists all the -files that make up the distribution, to check that you don't lack any of -them (in particular, that you have the file `manifest.txt' itself!). If -you do find that some files are missing, don't hesitate to complain to -the distributor from whom you obtained the others: this person, company, -or institution is infringing the copyright (actually, the copyleft) of -the C.D.P. Bundle. Please remember, however, that in order to comply -with the copyright a distributor is only requested to supply the files -listed in `manifest.txt' under the title "MEANING OF THE TERM `Work'", -and not those listed under "MEANING OF THE TERM `Compiled Work'". +Before installing the C.D.P. Bundle and generating its documentation, it is +a good idea to read the file `manifest.txt', which lists all the files that +make up the distribution, to check that you don't lack any of them (in +particular, that you have the file `manifest.txt' itself!). If you do find +that some files are missing, don't hesitate to complain to the distributor +from whom you obtained the others: this person, company, or institution is +infringing the copyright (actually, the copyleft) of the C.D.P. Bundle. +Please remember, however, that in order to comply with the copyright a +distributor is only requested to supply the files listed in `manifest.txt' +under the title "MEANING OF THE TERM `Work'", but not those listed under +"MEANING OF THE TERM `Compiled Work'". @@ -110,13 +109,12 @@ HOW TO INSTALL THE C.D.P. BUNDLE To install the C.D.P. Bundle, follow these steps: -1) Make sure that the files `cdpbundl.dtx' and `cdpbundl.ins' are placed -in the same directory; below, we shall indicate this directory as "the -current directory". +1) Make sure that the files `cdpbundl.dtx' and `cdpbundl.ins' are placed in +the same directory; below, we shall indicate this directory as "the current +directory". -2) Run LaTeX (or Plain TeX) once on the file `cdpbundl.ins'. This -will generate, in the current directory, the following LaTeX input -files: +2) Run LaTeX (or Plain TeX) once on the file `cdpbundl.ins'. This will +generate, in the current directory, the following LaTeX input files: adiseal.sty articoletteracdp.cls @@ -128,39 +126,38 @@ files: lettcdpadi.cls letteracdp.cls -3) Move all the files listed in 2) from the current directory to a -LaTeX input directory--see b) and c) below. +3) Move all the files listed in 2) from the current directory to a LaTeX +input directory--see b) and c) below. 4) If you wish, delete the file `cdpbundl.log' to save disk space. Installation is now finished! The following comments may be useful: -a) The above listing of all the files you need to move is also -displayed on the terminal at the end of the run of the file -`cdpbundl.ins'. - -b) The documentation of your TeX installation should tell you how to -find the LaTeX input directory/ies, and probably also how to create -new LaTeX input directories reserved to hold your private classes and -packages. If your TeX installation offers you the chance of defining -your private LaTeX input directories, I recommend you exploit this -possibility and place the generated files into such a directory. - -c) If you are not able to find the LaTeX input directories, or you are -not allowed to modify them and cannot create your personal LaTeX input -directories, do this: place all the files listed under 2) above in any -directory of your choice (a newly created, empty directory would be -the best choice, however); then put all the LaTeX source files that -you want to typeset using the C.D.P. Bundle in that same directory. -Of course, this solution becomes impractical if the number of such -source files exceeds a dozen or so; but for a few files you can do -this way, at least until you decide to finally learn how to create -your private LaTeX input directories! :-) - -d) You may also choose to install the C.D.P. Bundle inside the main -texmf tree of your TeX installation (as opposed to installing it inside -a directory devoted to private classes and packages). In this case, -note that the TDS-compliant location for the C.D.P. Bundle, that is, the +a) The above listing of all the files you need to move is also displayed on +the terminal at the end of the run of the file `cdpbundl.ins'. + +b) The documentation of your TeX installation should tell you how to find +the LaTeX input directory/ies, and probably also how to create new LaTeX +input directories reserved to hold your private classes and packages. If +your TeX installation offers you the chance of defining your private LaTeX +input directories, I recommend you exploit this possibility and place the +generated files into such a directory. + +c) If you are not able to find the LaTeX input directories, or you are not +allowed to modify them and cannot create your personal LaTeX input +directories, do this: place all the files listed under 2) above in any +directory of your choice (a newly created, empty directory would be the +best choice, however); then put all the LaTeX source files that you want to +typeset using the C.D.P. Bundle in that same directory. Of course, this +solution becomes impractical if the number of such source files exceeds a +dozen or so; but for a few files you can do this way, at least until you +decide to finally learn how to create your private LaTeX input directories! +:-) + +d) You may also choose to install the C.D.P. Bundle inside the main texmf +tree of your TeX installation (as opposed to installing it inside a +directory devoted to private classes and packages). In this case, note +that the TDS-compliant location for the C.D.P. Bundle, that is, the directory inside which you should put all the files listed in 2), is $TEXMF/tex/latex/cdpbundl/ @@ -169,44 +166,39 @@ The documentation, on the other hand, should be stored inside $TEXMF/doc/latex/cdpbundl/ -Of course, in order to do so you must have appropriate access -priviledges to the texmf tree of your site. +Of course, in order to do so you must have appropriate access priviledges +to the texmf tree of your site. HOW TO GENERATE THE DOCUMENTATION ================================= -A shortened form of the documentation, already typeset and packaged in -PDF format, is given in the file `overview.pdf' that you might have -found on some sites (e.g., the CTAN sites). This file, however, is -not part of the C.D.P. Bundle and distributors are not requested to -include it among the distributed files. Moreover, it does not contain -any implementation notes (in which most users are not at all -interested). +A shortened form of the documentation, already typeset and packaged in PDF +format, is given in the file `overview.pdf' that you might have found on +some sites (e.g., the CTAN sites). This file, however, is not part of the +C.D.P. Bundle and distributors are not requested to include it among the +distributed files. Moreover, it does not contain any implementation notes +(in which most users are not at all interested). -If the distributor from whom you obtained the C.D.P. Bundle did not -provide the file `overview.pdf', or if you want the full -documentation, complete with all the available implementation notes -(but, alas, still incomplete for many respects), you can generate it -by following these steps: +If the distributor from whom you obtained the C.D.P. Bundle did not provide +the file `overview.pdf', or if you want the full documentation, complete +with all the available implementation notes (but, alas, still incomplete +for many respects), you can generate it by following these steps: 1) Run LaTeX (_not_ Plain TeX) _twice_ on the file `cdpbundl.dtx'. This, among other things, will generate the files `cdpbundl.idx' and `cdpbundl.glo' in the same directory as the file `cdpbundl.dtx'. -2) Run MakeIndex on the file `cdpbundl.idx' obtained in 1), using the -style file `gind.sty', which is part of the standard LaTeX -distribution. +2) Run MakeIndex on the file `cdpbundl.idx' obtained in 1), using the style +file `gind.sty', which is part of the standard LaTeX distribution. -3) Run MakeIndex on the file `cdpbundl.glo' obtained in 1), using the -style file `gglo.sty', which is part of the standard LaTeX -distribution. +3) Run MakeIndex on the file `cdpbundl.glo' obtained in 1), using the style +file `gglo.sty', which is part of the standard LaTeX distribution. 4) Run LaTeX _two_ more times on the file `cdpbundl.dtx'. -5) If you wish, you can now delete the following files, to save disk -space: +5) If you wish, you can now delete the following files, to save disk space: cdpbundl.aux cdpbundl.glo @@ -218,12 +210,16 @@ space: cdpbundl.log cdpbundl.toc -After step 4), you should get the documentation in DVI format in the -file `cdpbundl.dvi', located in the same directory as `cdpbundl.dtx', -with all indexes, table of contents, etc. correctly set. +After step 4), you should get the documentation in DVI format in the file +`cdpbundl.dvi', located in the same directory as `cdpbundl.dtx', with all +indexes, table of contents, etc. correctly set. -However, if you are neurotic (as I am) and have a fast computer, you -could run LaTeX three or four times, instead of two, in step 1)... :-) +However, if you are neurotic (as I am) and have a fast computer, you could +run LaTeX three or four times, instead of two, in step 1)... :-) + +Other LaTeX typesetting engines should work in the same way, perhaps +producing the output in a different format; for example, you may use +pdflatex in place of LaTeX to obtain the documentation in PDF format. diff --git a/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt b/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt index 9edb5780a4e..4c63e5af5c7 100644 --- a/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt +++ b/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt @@ -3,7 +3,7 @@ This is file `manifest.txt'. This file is part of a work named "C.D.P. Bundle". -Copyright (C) 1999-2005 by Gustavo MEZZETTI <mezzetti@math.unipd.it>. +Copyright (C) 1999-2006 by Gustavo MEZZETTI <mezzetti@math.unipd.it>. The C.D.P. Bundle may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 @@ -21,23 +21,23 @@ precisely, it explains how the locutions "Work" and "Compiled Work", used in the LaTeX Project Public License, are to be interpreted in the case of this work. -January 1, 2005 +January 1, 2006 (vers. 0.34) MEANING OF THE TERM "Work" ========================== -In the case of the C.D.P. Bundle, the "Work" is the collection of -the following 4 files: +In the case of the C.D.P. Bundle, the "Work" is the collection of the +following 4 files: 00readme.txt -- start by reading this file -manifest.txt -- this file +manifest.txt -- the file you are reading now cdpbundl.dtx -- main source file cdpbundl.ins -- installation script -If you have received the 4 files listed above, you posses an integral -copy of the C.D.P. Bundle. +If you have received the 4 files listed above, you possess an integral copy +of the C.D.P. Bundle. @@ -70,30 +70,32 @@ following one: cdpbundl.pdf -- documentation in PDF format -but at least one among the files `cdpbundl.dvi' and `cdpbundl.pdf' must -be included in a "Compiled Work" that you want to distribute. The file -`cdpbundl.pdf' is obtained by submitting to the program pdfTeX the file -`cdpbundl.dtx'. +but at least one among the files `cdpbundl.dvi' and `cdpbundl.pdf' must be +included in a "Compiled Work" that you want to distribute. The file +`cdpbundl.pdf' is obtained by submitting to the program pdflatex the file +`cdpbundl.dtx', following the same steps as those explained in +`00readme.txt' under the title "How to generate the documentation". ANCILLARY FILES =============== -The package of files distributed through the Comprehensive TeX Archive +The package of files distributed through the Comprehensive TeX Archive Network (CTAN) includes also the following two files: README -- guide to directory contents overview.pdf -- general information on the C.D.P. Bundle (PDF) -This two files are included only for informative purposes and are _not_ -part of the C.D.P. Bundle. +These two files are included only for informative purposes and are _not_ a +required part of the C.D.P. Bundle (of course you may, if you wish, include +them in your distribution too). COMMENT ======= -Please remember that, in order to distribute a functionally integral -copy of the C.D.P. Bundle, it suffices to distribute only the 4 files -that constitute the "Work". +Please remember that, in order to distribute a LPPL-compliant copy of the +C.D.P. Bundle, it suffices to distribute only the 4 files that constitute +the "Work". diff --git a/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf b/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf Binary files differindex 86da1fb9a59..2d93205b58f 100644 --- a/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf +++ b/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf |