[Pkg-ime-devel] Package description alternative example

Osamu Aoki osamu@debian.org
Fri, 29 Oct 2004 01:21:49 +0200


* scim-gtk2-immodule
"Description:" is very cryptic for normal user. I thus propose:

Depends: ${shlibs:Depends}, scim-server-socket (>= 1.0.1)
Recommends: scim (>= 1.0.1)
Description: Input method (SCIM) support for the GTK2
 SCIM (Smart Common Input Method) is the complete keyboard input method
 (IM) platform. The IM allows user to enter non-Latin characters such as
 Greek, Chinese, Japanese, and Korean ones which are not readily
 available from the normal keyboard into the application.
 .  
 This package provides the IM support to all the GTK2 applications, such
 as Mozilla, Abiword, and OpenOffice.org, using GTK2 IMModule as its
 support mechanism and SCIM providing its back end IM. 
 .
 For details about SCIM, please see the description of package scim

If you like this "Description:" over the current one, I propose to do
the similar for other packages.  I also thought that the description on
dependency in "Description:" seemed redundant.

Maybe I should say 
 s/GTK2 applications/GTK2 applications in its native mode/

I am not quite sure what to say here.  Point is Package desription
should be understandable by the non-developer.