Debian Codegraph @

texmf-dist/doc/latex/curve2e/README.txt

raw
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'.