File: INSTALL.txt

package info (click to toggle)
libdate-pcalc-perl 1.2-3
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 428 kB
  • ctags: 80
  • sloc: perl: 4,738; makefile: 42; sh: 18
file content (282 lines) | stat: -rw-r--r-- 9,182 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
                     =====================================
                       Package "Date::Pcalc" Version 1.2
                     =====================================

                  Copyright (c) 1999-2001 J. David Eisenberg,
                                 based on work
                   Copyright (c) 1993-2001 by Steffen Beyer.
                             All rights reserved.


Contents:
---------

    +   Prerequisites
    +   Preliminary steps for use with Perl prior to version 5.002
    +   Preliminary steps for use with ActivePerl
    +   Preliminary steps for console users
    +   How to install additional languages
    +   Installation


Prerequisites:
--------------

Perl version 5.000 or higher.

For Windows (95/98/NT/2000) it is recommended that you make sure
that the ".pl" extension is associated with Perl.


Preliminary steps for use with Perl prior to version 5.002:
-----------------------------------------------------------

Edit the file "Makefile.PL" and change the line

    'VERSION_FROM'      => 'Pcalc.pm',
to
    'VERSION'           => '1.2',

Also edit the file "t/f000.t" and change the line

    use Date::Pcalc 1.2;
to
    use Date::Pcalc;


Preliminary steps for use with ActivePerl:
------------------------------------------

(I.e., for the Win32 platform)

Edit the file "Makefile.PL" and remove all of the "#" characters
which currently comment out the attributes "ABSTRACT", "AUTHOR"
and "CAPI".


Preliminary steps for console users:
------------------------------------

In case you will be running this package in a MS-DOS command shell
environment *EXCLUSIVELY* (and never under Perl/Tk, for instance),
or if you will be running this package *EXCLUSIVELY* on the console
of a PC UNIX system (like FreeBSD or GNU/Linux, for example) and
never under X-windows, you might want to convert the special characters
embedded in this package from the "ISO-Latin-1" character set (this
is the same as "ISO-8859-1") to the character set used by the MS-DOS
command shell or the PC UNIX console.

To do so, simply change directory to the "tools" subdirectory and
issue the following command:

    > perl convert.pl

You can also use

    > ./convert.sh

under UNIX; you may have to edit the first line of the files "convert.sh"
and "iso2pc.pl" to make sure that they point to the correct location
of Perl on your system, though.

Under Windows, you can use

    > convert.bat

Then proceed with the installation of this package as described in
the section "Installation" further below.


How to install additional languages:
------------------------------------

Unfortunately, Unix and Windows lack a "Resource Fork" concept
as provided by the MacOS (Apple Macintosh Operating System).

Therefore, each time you want to add more languages, you will
have to either edit the installed module (the exact location
is sometimes a little hard to find, unless you use a file search
utility and look for "Pcalc.pm"), or this package, in which case
you'll need to re-build and re-install it using "make" (or "dmake"
or "nmake", under Windows), preferably, or by hand (if you know
what you're doing).

Fortunately, though, adding a new language is quite simple:

Edit the file "Pcalc.pm" and do the following:

1) Increment the number in the line

    $pcalc_Languages = 7;

   as necessary.

2) Add a new entry to the bottom of the array "@arr_Month_to_Text"
   of the following form:

    [
        "???", "January", "February", "March", "April", "May", "June",
        "July", "August", "September", "October", "November", "December"
    ]

   Don't forget to add a comma after the closing bracket of the immediately
   preceding entry above.

3) Add a new entry to the bottom of the array "@arr_Day_of_Week_to_Text"
   of the following form:

    [
        "???", "Monday", "Tuesday", "Wednesday",
        "Thursday", "Friday", "Saturday", "Sunday"
    ]

   Don't forget to add a comma after the closing bracket of the immediately
   preceding entry above.

4) Add a new entry to the bottom of the array
   "@arr_Day_of_Week_Abbreviation" of the following form:

    [
        "", "", "", "", "", "", "", ""    # 8
    ]

   Don't forget to add a comma after the closing bracket of the immediately
   preceding entry above.

   Fill this entry with values *ONLY* if you need special abbreviations
   for the names of the days of week (i.e., if you need abbreviations
   other than the first three letters of the entries in the array
   "@arr_Day_of_Week_to_Text_" immediately above)!

   If you do so, remember to fill the first (dummy) field in this entry
   with some non-empty string (such as "???", for example), since this
   field is used to flag the existence of special abbreviations in this
   package.

5) Finally, append the name of the language you have just added
   *WRITTEN IN THAT VERY LANGUAGE*, to the end of the array
   "@arr_Language_to_Text".

   The name of the language should be written in that very language
   itself because the name for any given language usually varies
   considerably from language to language. The only way to uniquely
   identify any language is to use the way it is written by native
   writers of that language itself.

   The abbreviations for names of languages as defined by ISO 639 cannot
   take account of all languages (there are only 26 * 26 = 676 possible
   abbreviations as designated by this standard, as opposed to the many
   thousand different languages in this world), which is the reason why
   they are not used here.

6) If you have never built this version of this package on the current
   machine before, just proceed with the instructions in the section
   "Installation" following immediately below.

   Otherwise, rebuild the package with "make" (as described in the
   section below) and re-install it with "make install".

   If you want to start over from scratch instead, enter the command
   "make realclean" and proceed as described in the section below,
   from the beginning.


Installation:
-------------

=============================================================================
ALWAYS unpack and build Perl modules OUTSIDE the Perl source and installation
tree! (You might otherwise inadvertently corrupt your Perl installation!)
=============================================================================

Note that installation under Windows is easiest with ActivePerl, available
from http://www.ActiveState.com/.

Quick installation guide for experienced users:
-----------------------------------------------

    UNIX:                 Win32/Borland C++:      Win32/MS Visual C++:
    =====                 ==================      ====================

    > perl Makefile.PL    > perl Makefile.PL      > perl Makefile.PL
    > make                > dmake                 > nmake
    > make test           > dmake test            > nmake test
    > make install        > dmake install         > nmake install

Detailed installation guide:
----------------------------

 1) Change directory to the directory that has been created by unpacking this
    package ("cd Date-Pcalc-1.2").

 2) Type "perl Makefile.PL" (or whatever the name and path of your Perl 5
    binary is).

    This will create a "Makefile" with the appropriate parameters for your
    system (for instance, where the install directories are, and so on).

 3) Type "make".

    (For installation under Windows, use "dmake" (Borland C++) or
    "nmake" (MS Visual C++) instead!)

 4) Now issue "make test" (or "dmake test" or "nmake test", respectively).

    The output should look somewhat like this:

    PERL_DL_NONLAZY=1 /usr/sw/bin/perl
    -I./blib/arch
    -I./blib/lib
    -I/usr/sw/pkg/perl/lib/5.00503/i386-freebsd
    -I/usr/sw/pkg/perl/lib/5.00503
    -e 'use Test::Harness qw(&runtests $verbose); $verbose=0;
    runtests @ARGV;' t/*.t
    t/f000..............ok
    t/f001..............ok
    t/f002..............ok
    t/f003..............ok
    t/f004..............ok
    t/f005..............ok
    t/f006..............ok
    t/f007..............ok
    t/f008..............ok
    t/f009..............ok
    t/f010..............ok
    t/f011..............ok
    t/f012..............ok
    t/f013..............ok
    t/f014..............ok
    t/f015..............ok
    t/f016..............ok
    t/f017..............ok
    t/f018..............ok
    t/f019..............ok
    t/f020..............ok
    t/f021..............ok
    t/f022..............ok
    t/f023..............ok
    t/f024..............ok
    t/f025..............ok
    t/f026..............ok
    t/f027..............ok
    t/f028..............ok
    t/f029..............ok
    t/f030..............ok
    t/f031..............ok
    t/f032..............ok
    t/f033..............ok
    All tests successful.
    Files=34,  Tests=1836, 12 wallclock secs
    ( 8.82 cusr +  1.23 csys = 10.05 CPU)

 5) At last, type "make install" (or "dmake install", "nmake install").

 6) Now you can run the example applications from the "examples"
    subdirectory in this distribution.

    Please refer to the file "EXAMPLES.txt" in this distribution for
    more details!

 7) Share and enjoy!