1Astro-App-Satpass2 is Copyright (C) 2009-2021 by Thomas R. Wyant, III
2
3This package contains an application to predict satellite visibility,
4using the Astro::Coord::ECI classes. The following classes are included:
5
6Astro::App::Satpass2 - The application class;
7Astro::App::Satpass2::ParseTime - Base class for time parsing;
8Astro::App::Satpass2::ParseTime::ISO8601 - Standalone ISO-8601-ish time parser;
9Astro::App::Satpass2::ParseTime::Date::Manip - Date::Manip parser base;
10Astro::App::Satpass2::ParseTime::Date::Manip::v5 - Date::Manip v5 parser;
11Astro::App::Satpass2::ParseTime::Date::Manip::v6 - Date::Manip v6 parser;
12Astro::App::Satpass2::Copier - Base class for the helper classes;
13Astro::App::Satpass2::Format - Base class for the output formatters;
14Astro::App::Satpass2::Format::Dump - Output dumper (for debugging);
15Astro::App::Satpass2::FormatTime - Base class for formatting times;
16Astro::App::Satpass2::FormatTime::Cldr - Manifest constants for cldr formatting;
17Astro::App::Satpass2::FormatTime::DateTime - DateTime common code;
18Astro::App::Satpass2::FormatTime::DateTime::Cldr - DateTime cldr formatting;
19Astro::App::Satpass2::FormatTime::DateTime::Strftime - DateTime strftime fmtg;
20Astro::App::Satpass2::FormatTime::POSIX::Strftime - POSIX strftime fmtg;
21Astro::App::Satpass2::FormatTime::Strftime - Manifest const for strftime fmtg;
22Astro::App::Satpass2::Utils - Utility functions needed by other modules;
23Astro::App::Satpass2::Warner - Manage how warnings are formatted.
24
25In addition, a 'satpass2' script is included, which simply uses
26Astro::App::Satpass2 and passes @ARGV to its run() method.
27
28There is also an Astro::App::Satpass2::TUTORIAL to help get started.
29
30There were several motivations for this package:
31
32* There was no good way to test the 'satpass' script that was included
33  in the Astro-satpass package. Restructuring it as an object made
34  testing easier; in fact, several bugs were found in 'satpass' while
35  writing this module.
36
37* Making a break with the old 'satpass' script gave the opportunity to
38  rethink a couple implementation decisions in the light of experience,
39  and drop obsolete functionality such as the SIMBAD 3 interface and the
40  associated setting to determine which SIMBAD interface to use. This
41  means that 'satpass2' is not quite command-compatable with 'satpass'.
42  The Astro::App::Satpass2 documentation describes the differences.
43
44* The output formatting of the 'satpass' script is not very flexable.
45
46* The dependencies of the 'satpass' script are significantly different
47  than those of the Astro::Coord::ECI classes. Separating the two (with
48  eventual abandonment of the Astro-satpass package in favor of an
49  Astro-Coord-ECI package without the 'satpass' script) means that
50  people only interested in the Astro::Coord::ECI classes will not have
51  to drag along the dependencies of the script.
52
53INSTALLATION
54
55Most Perl users will want to install using their favorite of either
56'cpan' or 'cpanp'. For either of these, installing Astro::App::Satpass2
57gets you everything. ActivePerl users will want to use ActiveState's
58'ppi', and install Astro-App-Satpass2.
59
60If for some reason none of these works for you, you can download the
61distribution and expand it using something like
62
63    tar -xzf Astro-App-Satpass2-9.999.tar.gz
64
65Users of MSWin32 (and perhaps other operating systems) may need to
66convert the line endings in the expanded files from Unix to their native
67system before proceeding.
68
69Then, issue one of the following two incantations:
70
71    perl Makefile.PL
72    make
73    make test
74    sudo make install
75
76or
77
78    perl Build.PL
79    ./Build
80    ./Build test
81    sudo ./Build install
82
83You should substitute the appropriate program name for 'make', eg nmake
84(typically) under MSWin32, or mms or mmk under VMS. See
85ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe for a copy of
86nmake for MSWin32 if you need it.
87
88Unix users may want to use 'su' rather than 'sudo' for the install.
89Non-unix users may need to be logged in to an administrative or
90otherwise privileged accout, and turn on privileges (if applicable) for
91the install.
92
93Of course, since it's pure Perl, you can just expand the kit and drop
94the .pm files into the App directory (creating it if necessary) in the
95appropriate place in your @INC directories.
96
97LICENSING INFORMATION
98
99This package is free software; you can redistribute it and/or modify it
100under the same terms as Perl 5.10.0. For more details, see the full text
101of the licenses in the directory LICENSES.
102
103This program is distributed in the hope that it will be useful, but
104without any warranty; without even the implied warranty of
105merchantability or fitness for a particular purpose.
106