[Stardata-common-devel] stardata-common uploaded to alioth

Kevin B. McCarty kmccarty@Princeton.EDU
Fri, 08 Apr 2005 16:38:53 -0400


This is a multi-part message in MIME format.
--------------040405030201090808010303
Content-Type: text/plain; charset=ISO-8859-15; format=flowed
Content-Transfer-Encoding: quoted-printable
X-MIME-Autoconverted: from 8bit to quoted-printable by Princeton.EDU id j38Kcsk2007479

Hi Francisco, Javi,

Francisco Garc=EDa wrote:

> Soon, I will prepare an Starplot and Gliese package according to
> stardata-common policy.

Cool!  May I suggest that you remove the starplot format conversion spec=20
files from the gliese and yale packages, and instead put them into the=20
starplot package somewhere?  (Maybe in /usr/share/starplot/specfiles/ or=20
somewhere like that.)  I guess the new starplot package will have to=20
Depend upon stardata-common, and Conflict against older versions of=20
gliese and yale, right?

> By now, I have made a stardata-common native Debian package too,
> and you can find in:
>=20
> http://usuarios.lycos.es/franciscogarciac/debian/stardata-common/

I just had a chance to look at it.  I am attaching a patch to try to=20
make some of the English flow a little more smoothly.

I'm wondering why you chose to write register-stardata in C.  It seems=20
to me that maybe it would be a little easier to maintain this sort of=20
program in shell or perl.  (Also it would allow stardata-common to be=20
Arch: all instead of Arch: any.)  Please do not take this as criticism,=20
I am sure you have good reasons for this choice - I just am curious to=20
know them :-)

By the way, I am intending to ITP a hipparcos-data package at some=20
point, just to let you know.  But it may not happen until my doctoral=20
thesis is finished, several months from now :-(  After it happens, we=20
may want to get into discussion with the stellarium maintainer.

best regards,

--=20
Kevin B. McCarty <kmccarty@princeton.edu>   Physics Department
WWW: http://www.princeton.edu/~kmccarty/    Princeton University
GPG: public key ID 4F83C751                 Princeton, NJ 08544

--------------040405030201090808010303
Content-Type: text/x-patch;
 name="stardata.diff"
Content-Disposition: inline;
 filename="stardata.diff"
Content-Transfer-Encoding: 7bit

diff -urN stardata-common-0.1.orig/debian/control stardata-common-0.1/debian/control
--- stardata-common-0.1.orig/debian/control	2005-01-23 18:12:07.000000000 -0500
+++ stardata-common-0.1/debian/control	2005-04-08 16:22:01.069791895 -0400
@@ -9,13 +9,13 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: common framework to manage astronomy packages
- This package allows installing and removing astronomy catalogues,
- converting those catalogues to astronomy programs data formats.
+ This package allows the installation and removal of astronomy catalogues,
+ converting those catalogues to astronomy programs' data formats.
  .
- All stardata catalogues according to stardata-common policy are installed
- and converted automatically to astronomy programs formats, which are according
- to stardata-common too, available in the system.
+ All stardata catalogues conforming to stardata-common policy are
+ converted automatically at installation time to the formats of
+ astronomy programs that support stardata-common.
  .
- register-stardata program is transparent for the user, this program is called
- automatically when any astronomy package according to stardata-common
- policy is installed, upgraded or removed.
\ No newline at end of file
+ The register-stardata program is transparent for the user; this program is
+ called automatically when any astronomy package conforming to stardata-common
+ policy is installed, upgraded or removed.
diff -urN stardata-common-0.1.orig/doc/register-stardata.1 stardata-common-0.1/doc/register-stardata.1
--- stardata-common-0.1.orig/doc/register-stardata.1	2005-01-23 12:51:37.000000000 -0500
+++ stardata-common-0.1/doc/register-stardata.1	2005-04-08 16:25:42.775539201 -0400
@@ -1,19 +1,19 @@
 .TH "register-stardata" "1" "0.1" "Francisco Garcia <franciscomanuel.garcia@hispalinux.es>" "stardata-common"
 .SH "NAME"
 .LP 
-register\-stardata \- Install or remove stardata catalogues and astronomy programs
+register\-stardata \- Install or remove star data catalogues and astronomy programs
 .SH "SYNTAX"
 .LP 
 register\-stardata [\fIoption\fP] {\fIinstall\fP|\fIremove\fP}	{\fIall\fP|\fIstardata\fP} {\fIall\fP|\fIprogram\fP}
 .SH "DESCRIPTION"
 .LP 
-register\-stardata is a program to install and remove stardata catalogues, according to
-the stardata\-common policy, to astronomy programs data formats.
+register\-stardata is a program to convert star data catalogues, that conform to
+the stardata\-common policy, to astronomy programs' data formats automatically on package install and removal.
 .br 
-stardata\-common is a common framework to manage the insertion and removal of stardata catalogues in a Debian system.
-This program liberates the user of the installation and conversion
-of stardata catalogues to the astronomy programs data formats,
-making it automatically during the installation. And removing them when uninstall.
+stardata\-common is a common framework to manage the insertion and removal of star data catalogues in a Debian system.
+This program liberates the user from managing the installation and conversion
+of star data catalogues to the astronomy programs' data formats,
+converting them automatically during the installation and removing them at uninstall.
 
 .SH "OPTIONS"
 .LP 
@@ -35,11 +35,11 @@
 
 .SH "EXAMPLES"
 .LP 
-To install yale stardata catalogue to all astronomy programas available in the system:
+To make the yale stardata catalogue available in formats understood by all astronomy programs available in the system:
 .LP 
 register\-stardata install yale all
 .LP 
-To remove all starplot data format catalogues installed:
+To remove the starplot format versions of all catalogues installed:
 .LP 
 register\-stardata remove all starplot
 .SH "AUTHORS"
diff -urN stardata-common-0.1.orig/src/register-stardata.c stardata-common-0.1/src/register-stardata.c
--- stardata-common-0.1.orig/src/register-stardata.c	2005-04-02 04:17:13.000000000 -0500
+++ stardata-common-0.1/src/register-stardata.c	2005-04-08 16:28:08.509597155 -0400
@@ -41,9 +41,12 @@
 	"register-stardata 0.1";
 
 static char doc[] =
-	"register-stardata -- Install or remove stardata catalogues to astronomy software data formats \013\
-'action' = {install|remove}, 'stardata' is the dataset to update, or 'all' for all available  stardata catalogues, \
-'program' is the software package data format to convert the datasets, or 'all' for all available astronomy packages.";
+	"register-stardata -- Install or remove stardata catalogues to the native\n\
+format of astronomy software data formats.\n\
+'action' = {install|remove},\n\
+'stardata' is the dataset to update, or 'all' for all available catalogues,\n\
+'program' is the software package data format to convert the datasets, or\n\
+          'all' for all available astronomy packages.";
 
 static char args_doc[] = 
 	"<action> <stardata> <program>";

--------------040405030201090808010303--