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

Re: Need help to review the omninotify control file.



PICCA Frédéric-Emmanuel wrote:
> Section: science         

What's sciency about it?  I thought the idea of this CORBA
middleware stuff was to be flavourless, equally suitable for
academic, corporate, and indeed military applications?  Most of the
packages I find when I search on "omniorb" or "corba" are in
"Section: devel", but for a package that's going to be installed on
production systems that doesn't seem right either.

Maybe it's "Section: admin"?

> Package: omninotify
> Architecture: any
> Depends: ${shlibs:Depends}, ${misc:Depends}
> Description: multi-threaded CORBA Notification Service

This implies that its competitors are single-threaded, which seems
unlikely.  If the "multi-threaded" part isn't a distinctive feature
of omninotify, it shouldn't be in the synopsis (it is after all in
the first line of the extended description); but is there anything
to replace it?

>  omniNotify is a multi-threaded implementation of the
>  CORBA Notification Service (CosNotification), a feature-enriched
>  version of the CORBA Event Service (CosEvents).

This isn't much of an explanation, given that it's defining
omniNotify in terms most of which are still too obscure to look up
in wikipedia - Google's first page of hits for "CosEvents" finds
plenty of cosplayers, but no CORBA programmers!  It might help to
include the "built on top of OmniORB" part from the homepage, since
explanations of what OmniORB is are already available via apt-cache.

>  omniNotify offers asynchronous, decoupled, event-based
>  communication between distributed and heterogeneous applications.

Now, this bit's pretty informative, though it could do without
upstream's insistent repetition of the product name.

>   * Scalable filter evaluation and event dispatching architecture.

Then suddenly we're in a features list.  The first bulletpoint is an
awkward one to start with (it features architecture?), and might
work better if it was broken out into the main text:

   omniNotify is a multi-threaded implementation of the CORBA Notification
   Service (CosNotification), a feature-enriched version of the CORBA Event
   Service (CosEvents) built on top of OmniORB. It offers asynchronous,
   decoupled, event-based communication between distributed and
   heterogeneous applications. omniNotify has a scalable filter
   evaluation and event dispatching architecture, which supports:

>   * Support for push-based and pull-based event suppliers and consumers.
>   * Support variants of suppliers/consumers that transmit (per push/pull):
>   * a CORBA::Any (a single arbitrary value);
>   * a CosNotification::StructuredEvent (a single structured event);
>   * a CosNotification::EventBatch (a sequence of structured events).
>   * Administrative and Notification QoS properties.
>   * Backward compatible with CosEvents.

That's bulletpoints A, B, C, C1, C2, C3.  Two-level lists are ugly,
but maybe I can flatten it if I cheat:

    * push-based and pull-based event suppliers and consumers;
    * variants of suppliers/consumers that transmit (per push/pull)
      a CosNotification::StructuredEvent (a single structured event),
      a CosNotification::EventBatch (a sequence of structured events),
      and a CORBA::Any (a single arbitrary value);
    * administrative and Notification QoS properties;
    * CosEvents backward compatibility.

(Or was the order of sub-bullets C1/C2/C3 significant?)

>  .
>  This package contains the notifd daemon.

It's called "notifd"?  Seems a bit of a namespace hog (the first
thing the package name made me think of was inotify, not
omniorb), but that's definitely getting outside d-l-e jurisdiction.

> Package: omninotify-dbg
> Section: debug
> Architecture: any
> Depends: ${shlibs:Depends}, ${misc:Depends}, omninotify (= ${binary:Version})
> Description: multi-threaded CORBA Notification Service

I must get around to submitting my wishlist bug for "lintian -s" to
include a check for "recycled package synopsis". 

  Description: CORBA Notification Service - debug symbols

Then ditto for all the boilerplate, and:

>  .
>  This package contains the debugging symbol for omninotify.
                                             ^s
Presumably...
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
--- control.old	2010-02-20 10:42:05.000000000 +0000
+++ control.new	2010-02-20 13:29:59.000000000 +0000
@@ -1,5 +1,5 @@
 Source: omninotify
-Section: science
+Section: admin
 Priority: extra
 Maintainer: Picca Frédéric-Emmanuel <picca@synchrotron-soleil.fr>
 Build-Depends: debhelper (>= 7.0.50), autotools-dev, omniidl, omniorb-idl
@@ -9,20 +9,20 @@
 Package: omninotify
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: multi-threaded CORBA Notification Service
- omniNotify is a multi-threaded implementation of the
- CORBA Notification Service (CosNotification), a feature-enriched
- version of the CORBA Event Service (CosEvents).
- omniNotify offers asynchronous, decoupled, event-based
- communication between distributed and heterogeneous applications.
-  * Scalable filter evaluation and event dispatching architecture.
-  * Support for push-based and pull-based event suppliers and consumers.
-  * Support variants of suppliers/consumers that transmit (per push/pull):
-  * a CORBA::Any (a single arbitrary value);
-  * a CosNotification::StructuredEvent (a single structured event);
-  * a CosNotification::EventBatch (a sequence of structured events).
-  * Administrative and Notification QoS properties.
-  * Backward compatible with CosEvents.
+Description: CORBA Notification Service
+ omniNotify is a multi-threaded implementation of the CORBA Notification
+ Service (CosNotification), a feature-enriched version of the CORBA Event
+ Service (CosEvents) built on top of OmniORB. It offers asynchronous,
+ decoupled, event-based communication between distributed and
+ heterogeneous applications. omniNotify has a scalable filter evaluation
+ and event dispatching architecture, which supports:
+  * push-based and pull-based event suppliers and consumers;
+  * variants of suppliers/consumers that transmit (per push/pull)
+    a CosNotification::StructuredEvent (a single structured event),
+    a CosNotification::EventBatch (a sequence of structured events),
+    and a CORBA::Any (a single arbitrary value);
+  * administrative and Notification QoS properties;
+  * CosEvents backward compatibility.
  .
  This package contains the notifd daemon.
 
@@ -30,19 +30,19 @@
 Section: debug
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, omninotify (= ${binary:Version})
-Description: multi-threaded CORBA Notification Service
- omniNotify is a multi-threaded implementation of the
- CORBA Notification Service (CosNotification), a feature-enriched
- version of the CORBA Event Service (CosEvents).
- omniNotify offers asynchronous, decoupled, event-based
- communication between distributed and heterogeneous applications.
-  * Scalable filter evaluation and event dispatching architecture.
-  * Support for push-based and pull-based event suppliers and consumers.
-  * Support variants of suppliers/consumers that transmit (per push/pull):
-  * a CORBA::Any (a single arbitrary value);
-  * a CosNotification::StructuredEvent (a single structured event);
-  * a CosNotification::EventBatch (a sequence of structured events).
-  * Administrative and Notification QoS properties.
-  * Backward compatible with CosEvents.
+Description: CORBA Notification Service - debug symbols
+ omniNotify is a multi-threaded implementation of the CORBA Notification
+ Service (CosNotification), a feature-enriched version of the CORBA Event
+ Service (CosEvents) built on top of OmniORB. It offers asynchronous,
+ decoupled, event-based communication between distributed and
+ heterogeneous applications. omniNotify has a scalable filter evaluation
+ and event dispatching architecture, which supports:
+  * push-based and pull-based event suppliers and consumers;
+  * variants of suppliers/consumers that transmit (per push/pull)
+    a CosNotification::StructuredEvent (a single structured event),
+    a CosNotification::EventBatch (a sequence of structured events),
+    and a CORBA::Any (a single arbitrary value);
+  * administrative and Notification QoS properties;
+  * CosEvents backward compatibility.
  .
- This package contains the debugging symbol for omninotify.
+ This package contains the debugging symbols for omninotify.
Source: omninotify
Section: admin
Priority: extra
Maintainer: Picca Frédéric-Emmanuel <picca@synchrotron-soleil.fr>
Build-Depends: debhelper (>= 7.0.50), autotools-dev, omniidl, omniorb-idl
Standards-Version: 3.8.4
Homepage: http://omninotify.sourceforge.net/

Package: omninotify
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: CORBA Notification Service
 omniNotify is a multi-threaded implementation of the CORBA Notification
 Service (CosNotification), a feature-enriched version of the CORBA Event
 Service (CosEvents) built on top of OmniORB. It offers asynchronous,
 decoupled, event-based communication between distributed and
 heterogeneous applications. omniNotify has a scalable filter evaluation
 and event dispatching architecture, which supports:
  * push-based and pull-based event suppliers and consumers;
  * variants of suppliers/consumers that transmit (per push/pull)
    a CosNotification::StructuredEvent (a single structured event),
    a CosNotification::EventBatch (a sequence of structured events),
    and a CORBA::Any (a single arbitrary value);
  * administrative and Notification QoS properties;
  * CosEvents backward compatibility.
 .
 This package contains the notifd daemon.

Package: omninotify-dbg
Section: debug
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, omninotify (= ${binary:Version})
Description: CORBA Notification Service - debug symbols
 omniNotify is a multi-threaded implementation of the CORBA Notification
 Service (CosNotification), a feature-enriched version of the CORBA Event
 Service (CosEvents) built on top of OmniORB. It offers asynchronous,
 decoupled, event-based communication between distributed and
 heterogeneous applications. omniNotify has a scalable filter evaluation
 and event dispatching architecture, which supports:
  * push-based and pull-based event suppliers and consumers;
  * variants of suppliers/consumers that transmit (per push/pull)
    a CosNotification::StructuredEvent (a single structured event),
    a CosNotification::EventBatch (a sequence of structured events),
    and a CORBA::Any (a single arbitrary value);
  * administrative and Notification QoS properties;
  * CosEvents backward compatibility.
 .
 This package contains the debugging symbols for omninotify.

Reply to: