Re: Package descriptions to review
Could anybody help me?
Regards,
Daigo
Daigo Moriwaki wrote:
>Hi,
>
>I am in the process of Debian New Maintainer. The application manager
>has told me that the descriptions of my packages is broken English so
>that reviewing them here is required. Could you please give me any
>suggestions?
>
>* Background
>tDiary is a CGI application for Weblog. A sample (my blog) is here:
>http://www.sgtpepper.net/hyspro/diary/
>
>My packages are:
>- tdiary - New generation weblog, which has many features like TSUKKOMI
>- tdiary-theme - Themes of tDiary to change looks of Web pages
>- tdiary-plugin - Plugins of tDiary to add functionalities
>- tdiary-contrib - Plugins of tDiary to add functionalities
>- tdiary-mode - tDiary editing mode for Emacsen
>They all are archived in Debian.
>
>The descriptions I wrote are a summary of the upstream English README.
>Since the upstream authors (and I ) are Japanese, the README may be
>broken English.
>
>
>* Descriptions (the `control' file) to review
>I think that 'TSUKKOMI' should be translated to English and my format is
>not so good.
>
>
>Maintainer: Daigo Moriwaki <beatles@sgtpepper.net>
>Uploaders: Taku YASUI <tach@debian.or.jp>
>Build-Depends-Indep: debhelper (>> 3.0.0), docbook-to-man
>Standards-Version: 3.6.1
>
>Package: tdiary
>Architecture: all
>Depends: ruby (>= 1.8), libuconv-ruby1.8, rdtool, libdpkg-ruby1.8
>Suggests: tdiary-theme, tdiary-plugin
>Recommends: tdiary-mode
>Description: New generation weblog, which has many features like TSUKKOMI
>tDiary is so called Weblog, which accelerates communications and makes
>it more
>enjoyable to write messages every day. It has many features:
>* TSUKKOMI: means a short, sharp and heartfelt comment in Japanese.
>tDiary can also be used as a kind of BBS.
>* Today's Link: is analysis of coming URLs that tDiary catches in Referrer.
>* Theme: changes looks of pages by CSS. Many themes are included in
>tdiary-theme package.
>* Plugin: adds functionalities to tDiary in many aspects. A lot of plugins
>are included in tdiary-plugin package.
>* Small device browsing: is available because tDiary sends small pages for
>PDAs or mobile phones.
>* Style: is a grammar for writing text like Wiki. You can choose your
>favorite styles in misc/style.
>and so on.
>.
>Homepage: http://www.tdiary.org/
>
>Package: tdiary-theme
>Architecture: all
>Suggests: tdiary
>Description: Themes of tDiary to change looks of Web pages
>This package includes a lot of Cascading Style Sheets(CSSs), which change
>looks of pages of tDiary.
>
>Package: tdiary-plugin
>Architecture: all
>Depends: tdiary (>= 2.0), tdiary (<< 2.1), ruby (>= 1.8), ruby1.6,
>libnora-ruby1.8
>Description: Plugins of tDiary to add functionalities
>This package includes a lot of plugins that add functionalities to tDiary
>pages in many aspects.
>
>Package: tdiary-mode
>Architecture: all
>Depends: emacs21 | emacsen, apel, psgml
>Recommends: tdiary
>Description: tDiary editing mode for Emacsen
>This package includes an Emacs major mode for editing tDiary.
>
>Package: tdiary-contrib
>Architecture: all
>Depends: tdiary (>= 2.0), tdiary (<< 2.1), ruby (>= 1.8), curl
>Description: Plugins of tDiary to add functionalities
>This package includes optional utilities and plugins for tDiary,
>* that do not depend tDiary-core version,
>* that can not be internationalized,
>* that do not work with the latest tDiary-core version and so on.
>
>
>
>* Original README
>
>= tDiary -- a TSUKKOMI-able Web-log
>tDiary is so called Weblog. tDiary has these features.
>
>== features
>
>=== You can change your configuration with browser.
>You can not only read diary, but also write diary. Also, it is possible
>to change your configuration with browser. With tDiary, you can easily
>use and maintain Web-log system. So, you continue to write diary for a
>long time.
>
>=== TSUKKOMI
>'TSUKKOMI' means a short, smart and heartfelt comment in Japanese. It is
>possible for diary readers to add a TSUKKOMI to your diary. In other
>words, tDiary is equipped with BBS. With this BBS, you can communicate
>with your diary readers. tDiary can inform the author of a new TSUKKOMI
>by e-mail.
>
>=== Today's Link (Referer)
>When people links their diary to your diary, tDiary shows their URL by
>analysis of the referer header. This feature is supported in many
>Japanese web-log systems. In tDiary, this feature is more user-friendly.
>
>=== small devices -- PDA or mobile phone
>You can read your diary with PDA or mobile phone, for example, i-mode,
>Palm, Zaurus(SHARP's PDA) and so on. When you access the same URL as
>usual, tDiary creates a page for PDA or mobile phone. The page for small
>devices are small and suitable for reading with them.
>
>=== theme -- CSS
>You can change the look of the diary by CSS. In tDiary, this feature is
>called 'theme'. tDiary package has some themes. Of course, you can
>create a new theme. You can change your theme with browser.
>
>=== Plugin
>By plugins, you can add new features to tDiary, and change the existing
>feature of tDiary.
>
>=== Selectable Style and IO
>You can choice a grammar of writing your diary by 'Style' feature. Some
>style files are in misc/style. And you can choice data saving format
>(IO) also. Seee HOWTO-make-io.rd for more information about Style or IO.
>
>
>=== Written in Ruby
>Important :-). tDiary requires Ruby-1.6.3 or later.
>
>=== Others
>tDiary also supports these features.
>
>* Section anchor
>* Read past diaries
>
>
>Best regards,
>Daigo
>
>
>
--
Daigo Moriwaki
beatles_at_sgtpepper_dot_net
Reply to: