[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: RE : help needed to improve the libhkl package control file



PICCA Frédéric-Emmanuel wrote:
>> + The hkl library is a framework for diffraction computation and
>> + diffractometer control, heavily used at the SOLEIL synchrotron. It
>> + supports various types of diffractometer geometry: Eulerian 4-circle,
>> + Eulerian 6-circle, kappa 4-circle, kappa 6-circle, and z-axis
>> + geometry. For each of these it provides multiple modes, including
>> + bisector and constant omega.
[...]
> 
> For the mode part I am wondering if I need to speak about them. bissector + constant omega
> is too restrictiv for me. Maybe addind something like:
> 
> For each of these, plenty of numerical computed mode are provided (bissector,  constant psi, etc...)

I assume the point here is that "constant omega" is too similar to
"bisector", or something like that, so "bisector and constant psi"
makes a better description of the range of options?

I'd better explicitly point out one of the things I silently fixed
above: the English spelling is "bisect(-ion,-or)" with only one S.
I also deliberately promoted the examples list out of the
parentheses.

> In fact the plus-value of this library is that all modes compuation is done using a numerical resolution.
> so it is really powerfull compare to the the one only done by invertimg mathematical system by hand.

If you say so!  Okay, how about this:

               For each of these it provides several numerically computed
     modes, such as bisector and constant psi.

> 
>>>  Package: libhkl-dev
> [...]
>>> -Description: libhkl development package
>>> +Description: diffractometer control library - development files
> 
> what about
> 
> diffractometer computation control library.

That is, a standard synopsis of
 Description: diffractometer computation control library [...]
...?

Fair enough.  Revised patch attached.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
--- control.orig	2010-02-09 16:40:19.000000000 +0000
+++ control	2010-02-09 19:04:25.000000000 +0000
@@ -13,39 +13,55 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends} 
 Suggests: libhkl-doc
-Description: library for diffraction calculation and diffractometer control.
- The hkl library is dedicate to diffractometer control. It deals with different
- kind of diffractometer geometries: eulerian 4 circles, eulerian 6 circles,
- kappa 4 circles, kappa 6 circles and z-axis geometry. For each of thoses
- geometry it provides different kind of modes (bissector, constant omega, ...).
- It is heavily used at the SOLEIL synchrotron. 
+Description: diffractometer computation control library
+ The hkl library is a framework for diffraction computation and
+ diffractometer control, heavily used at the SOLEIL synchrotron. It
+ supports various types of diffractometer geometry: Eulerian 4-circle,
+ Eulerian 6-circle, kappa 4-circle, kappa 6-circle, and z-axis
+ geometry. For each of these it provides several numerically computed
+ modes, such as bisector and constant psi.
  .
- This package contain the runtime hkl library.
+ This package provides the runtime hkl library.
 
 Package: libhkl-dev
 Section: libdevel
 Architecture: any
 Depends: ${misc:Depends}, libhkl4 (= ${binary:Version}), libgsl0-dev, dpkg (>= 1.15.4) | install-info
-Description: libhkl development package
- libhkl is a framework for diffraction computation and diffractometer control
+Description: diffractometer computation control library - development files
+ The hkl library is a framework for diffraction computation and
+ diffractometer control, heavily used at the SOLEIL synchrotron. It
+ supports various types of diffractometer geometry: Eulerian 4-circle,
+ Eulerian 6-circle, kappa 4-circle, kappa 6-circle, and z-axis
+ geometry. For each of these it provides several numerically computed
+ modes, such as bisector and constant psi.
  .
- This package contains everything which is needed to link against libhkl4.
+ This package provides everything needed to link against hkl.
 
 Package: libhkl-dbg
 Section: debug
 Priority: extra
 Architecture: any
 Depends: ${misc:Depends}, libhkl4 (= ${binary:Version})
-Description: libhkl debug symbols package
- libhkl is a framework for diffraction computation and diffractometer control
+Description: diffractometer computation control library - debug symbols
+ The hkl library is a framework for diffraction computation and
+ diffractometer control, heavily used at the SOLEIL synchrotron. It
+ supports various types of diffractometer geometry: Eulerian 4-circle,
+ Eulerian 6-circle, kappa 4-circle, kappa 6-circle, and z-axis
+ geometry. For each of these it provides several numerically computed
+ modes, such as bisector and constant psi.
  .
- This package contains the debug files.
+ This package provides the debug files for hkl.
 
 Package: libhkl-doc
 Section: doc
 Architecture: all
 Depends: ${misc:Depends}
-Description: libhkl documentation
- libhkl is a framework for diffraction computation and diffractometer control
+Description: diffractometer computation control library - documentation
+ The hkl library is a framework for diffraction computation and
+ diffractometer control, heavily used at the SOLEIL synchrotron. It
+ supports various types of diffractometer geometry: Eulerian 4-circle,
+ Eulerian 6-circle, kappa 4-circle, kappa 6-circle, and z-axis
+ geometry. For each of these it provides several numerically computed
+ modes, such as bisector and constant psi.
  .
- This package contains the documentation of the libhkl library.
+ This package provides the documentation for hkl.

Reply to: