| 1 |
%% |
| 2 |
%% This is file `README.txt', |
| 3 |
%% generated with the docstrip utility. |
| 4 |
%% |
| 5 |
%% The original source files were: |
| 6 |
%% |
| 7 |
%% curve2e.dtx (with options: `readme') |
| 8 |
%% |
| 9 |
%% Copyright (C) 2005--2024 Claudio Beccari all |
| 10 |
%% rights reserved. |
| 11 |
%% License information appended |
| 12 |
%% |
| 13 |
File README.txt for package curve2e |
| 14 |
[2024-11-13 v.2.6.0 Extension package for pict2e] |
| 15 |
|
| 16 |
The package bundle curve2e is composed of the following files |
| 17 |
|
| 18 |
curve2e.dtx |
| 19 |
curve2e-manual.tex |
| 20 |
|
| 21 |
The derived files are |
| 22 |
|
| 23 |
curve2e.sty |
| 24 |
curve2e-v161.sty |
| 25 |
curve2e.pdf |
| 26 |
curve2e-manual.pdf |
| 27 |
README.txt |
| 28 |
|
| 29 |
If you install curve2e without using your TeX system package handler, |
| 30 |
Compile curve2e.dtx and curve2e-manual.tex two or three times until |
| 31 |
all labels and citation keys are completely resolved. Then move the |
| 32 |
primary and derived files as follows: |
| 33 |
|
| 34 |
Move curve2e.dtx and curve2e-manual.tex to ROOT/source/latex/curve2e/ |
| 35 |
Move curve2e.pdf and curve2e-manual.pdf to ROOT/doc/latex/curve2e/ |
| 36 |
Move curve2e.sty and curve2e-v161.sty to ROOT/tex/latex/curve2e/ |
| 37 |
Move README.txt to ROOT/doc/latex/curve2e/ |
| 38 |
|
| 39 |
curve2e.dtx is the documented TeX source file of the derived files |
| 40 |
curve2e.sty, curve2e.pdf, curve2e-v161.sty and README.txt. |
| 41 |
|
| 42 |
You get curve2e.sty, curve2e.pdf, curve2e-v161.sty, and README.txt |
| 43 |
by running pdflatex on curve2e.dtx. |
| 44 |
|
| 45 |
The curve2e-manual files contains the user manual; in |
| 46 |
this way the long preliminary descriptive part of the previous versions |
| 47 |
curve2e.pdf file has been transferred to a shorter dedicated file, and the |
| 48 |
"normal" user should have enough information to use the package. The |
| 49 |
curve2e.pdf file, extracted from the .dtx one, contains the code |
| 50 |
documentation and is intended for the developers, or for the curious |
| 51 |
advanced users. For what concerns curve2e-v161.sty, it is a previous |
| 52 |
version of this package; see below why the older version might become |
| 53 |
necessary to the end user. |
| 54 |
|
| 55 |
README.txt, this file, contains general information. |
| 56 |
|
| 57 |
This bundle contains also package curve2e-v161.sty, a roll-back |
| 58 |
version needed in certain rare cases. |
| 59 |
|
| 60 |
Curve2e.sty is an extension of the package pict2e.sty which extends the |
| 61 |
standard picture LaTeX environment according to what Leslie Lamport |
| 62 |
specified in the second edition of his LaTeX manual (1994). |
| 63 |
|
| 64 |
This further extension curve2e.sty to pict2e.sty allows to draw lines |
| 65 |
and vectors with any non integer slope parameters, to draw dashed and |
| 66 |
dotted lines of any slope, to draw arcs and curved vectors, to draw |
| 67 |
curves where just the interpolating nodes are specified together with |
| 68 |
the tangent directions at such nodes; closed paths of any shape can be |
| 69 |
filled with color; all coordinates are treated as ordered pairs, i.e. "complex |
| 70 |
numbers"; coordinates may be expressed also in polar form. Coordinates |
| 71 |
may be specified with macros, so that editing any drawing is rendered |
| 72 |
much simpler: any point specified with a macro is modified only once |
| 73 |
in its macro definition. |
| 74 |
Some of these features have been incorporated in the 2009 version of |
| 75 |
pict2e; therefore this package avoids any modification to the original |
| 76 |
pict2e commands. In any case the version of curve2e is compatible with |
| 77 |
later versions of pict2e; see below. |
| 78 |
|
| 79 |
Curve2e now accepts polar coordinates in addition to the usual cartesian |
| 80 |
ones; several macros have been upgraded; a new macro for tracing cubic |
| 81 |
Bezier splines with their control nodes specified in polar form is |
| 82 |
available. The same applies to quadratic Bezier splines. The multiput |
| 83 |
command has been completely modified in a backwards compatible way; the |
| 84 |
new version allows to manipulate the increment components in a configurable |
| 85 |
way. A new xmultiput command has been defined that is more configurable |
| 86 |
than the original one; both commands multiput and xmultiput are backwards |
| 87 |
compatible with the original picture environment definition. |
| 88 |
|
| 89 |
Curve2e solves a conflict with package eso-pic. |
| 90 |
|
| 91 |
This version of curve2e is almost fully compatible with pict2e version 0.4z and later. |
| 92 |
|
| 93 |
If you specify |
| 94 |
|
| 95 |
\usepackage[<pict2e options>]{curve2e} |
| 96 |
|
| 97 |
the package pict2e is automatically invoked with the specified options. |
| 98 |
|
| 99 |
The -almost fully compatible- phrase is necessary to explain that this |
| 100 |
version of curve2e uses some "functions" of the LaTeX3 language that were |
| 101 |
made available to the LaTeX developers by mid October 2018. Should the user |
| 102 |
have an older or a basic/incomplete installation of the TeX system, |
| 103 |
such L3 functions might not be available. This is why this |
| 104 |
package checks the presence of the developer interface; in case |
| 105 |
such interface is not available it rolls back to the previous version |
| 106 |
renamed curve2e-v161.sty, which is part of this bundle; this roll-back |
| 107 |
file name must not be modified in any way. The compatibility mentioned |
| 108 |
above implies that the user macros remain the same, but their |
| 109 |
implementation requires the L3 interface. Some macros and environments |
| 110 |
rely totally on the xfp package functionalities, but legacy documents |
| 111 |
source files should compile correctly. |
| 112 |
|
| 113 |
The package has the LPPL status of maintained. |
| 114 |
|
| 115 |
According to the LPPL licence, you are entitled to modify this package, |
| 116 |
as long as you fulfil the few conditions set forth by the Licence. |
| 117 |
|
| 118 |
Nevertheless this package is an extension to the standard LaTeX |
| 119 |
pict2e (2014) package. Therefore any change must be controlled on the |
| 120 |
parent package pict2e, so as to avoid redefining or interfering with |
| 121 |
what is already contained in that package. |
| 122 |
|
| 123 |
If you prefer sending me your modifications, as long as I will maintain |
| 124 |
this package, I will possibly include every (documented) suggestion or |
| 125 |
modification into this package and, of course, I will acknowledge your |
| 126 |
contribution. |
| 127 |
|
| 128 |
Claudio Beccari |
| 129 |
|
| 130 |
claudio dot beccari at gmail dot com |
| 131 |
|
| 132 |
%% |
| 133 |
%% Distributable under the LaTeX Project Public |
| 134 |
%% License, version 1.3c or higher (your choice). |
| 135 |
%% The latest version of this license is at: |
| 136 |
%% http://www.latex-project.org/lppl.txt |
| 137 |
%% |
| 138 |
%% This work is "maintained" |
| 139 |
%% |
| 140 |
%% This work consists of file curve2e.dtx, and the |
| 141 |
%% derived files curve2e.sty and curve2e.pdf, plus |
| 142 |
%% the auxiliary derived files README.txt and |
| 143 |
%% curve2e-v161.sty. |
| 144 |
%% |
| 145 |
%% |
| 146 |
%% End of file `README.txt'. |