Bug#269787: marked as done (manpage improvements ?)

Debian Bug Tracking System owner@bugs.debian.org
Thu, 12 May 2005 11:33:15 -0700


Your message dated Thu, 12 May 2005 14:17:18 -0400
with message-id <E1DWIFK-0006Pt-00@newraff.debian.org>
and subject line Bug#269787: fixed in balsa 2.3.0-2sarge1
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--------------------------------------
Received: (at submit) by bugs.debian.org; 3 Sep 2004 13:41:03 +0000
>From siward@wanadoo.nl Fri Sep 03 06:41:03 2004
Return-path: <siward@wanadoo.nl>
Received: from master.debian.org [146.82.138.7] 
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1C3EJK-0004dt-00; Fri, 03 Sep 2004 06:41:02 -0700
Received: from smtp08.wanadoo.nl [194.134.35.149] 
	by master.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1C3EJJ-0004Le-00; Fri, 03 Sep 2004 08:41:01 -0500
Received: from Si (c529da352.cable.wanadoo.nl [82.157.163.82])
	by smtp8.wanadoo.nl (Postfix) with ESMTP id 6C3605C812
	for <bugs@debian.org>; Fri,  3 Sep 2004 15:41:05 +0200 (CEST)
Received: from si ([127.0.0.1] ident=root)
	by Si with esmtp (Exim 3.36 #1 (Debian))
	id 1C3EJH-0002uV-00
	for <bugs@debian.org>; Fri, 03 Sep 2004 15:40:59 +0200
Date: Fri, 3 Sep 2004 15:40:58 +0200
From: Siward de Groot <siward@wanadoo.nl>
To: "B. Bunny" <bugs@debian.org>
Subject: manpage improvements ?
Message-ID: <20040903134058.GA11055@Si.wanadoo.nl>
Mime-Version: 1.0
Content-Type: text/plain; Format=Flowed; DelSp=Yes; charset=ISO-8859-1
Content-Disposition: inline
X-Mailer: Balsa 2.0.17
Lines: 102
Content-Transfer-Encoding: quoted-printable
Delivered-To: bugs@debian.org
Delivered-To: submit@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-7.0 required=4.0 tests=BAYES_01,HAS_PACKAGE 
	autolearn=no version=2.60-bugs.debian.org_2004_03_25
X-Spam-Level: 

Package: balsa
Version: 2.0.17-2
Severity: minor

Title  : manpage improvements ?

balsa::help::about :
	 The Balsa email client is part of the GNOME desktop =20
environment.
* i am not using gnome desktop, but i am using balsa,
    so maybe word 'suite' should be in here somewhere ?

	 If you need to report bugs, please do so at: =20
http://bugzilla.gnome.org/
* not use debian's bts ?

balsa::help::contents :
* clicking it does nothing, statusbar says nothing about it,
  pressing F1 gives same result

----------------------------------------------------------------------
man balsa :

 SYNOPSIS :
* this is not a synopsis (see dict synopsis).
  although word 'synopsis' is used in many manpages,
  it is a bit too much to expect of newbie users to be able to
    use a syntax-description as a synopsis.
  maybe s/synopsis/syntax/i ?

* format is not easy to read,
  in my local form, it currently looks like :
	 balsa							  \
	   [       --help					] \
	   [       --version					] \
	   [  -c | --checkmail					] \
	   [ (-m | --compose=3D)(<user>@<host>.<tld>|<url>)	] \
	   [ (-a | --attach=3D)<filename>				] \
	   [ (-o | --open-mailbox=3D)<mailbox>[:<mailbox>]...	] \
	   [  -u | --open-unread-mailbox			] \
	   [  -d | --debug-pop					]
  maybe you like this format too ?

 DESCRIPTION
	 Balsa is an e-mail reader.
* it is also a writer.
  (if 'e-mail reader' is a generic term for a mua,
   then please disregard this remark)

	 This client is part of GNOME desktop environment.
* same as in helptext
* inexperienced newbies might not understand short word 'client' here.
  is it really necessary or otherwise desirable ?

	 For help on using Balsa,
	   see program documentation in help menu.
* not available, as noted above

* in my local copy, i have added packagedescription from
    http://packages.debian.org/testing/gnome/balsa

 OPTIONS
 -m --compose=3DUSER@HOST.TLD
	 When invoked with this option, balsa
	   open a new message with specified address in To: field.
	 Parameter can be specified also in URL format,
	   it makes it possible to use balsa as mailto protocol handler
	   by setting mailto protocol command to balsa -m "%s"
	     in URL handlers section of GNOME control center.
* what is tld ?
* url form of command is not shown in syntaxdescription

 -o --open-mailbox=3DMAILBOX
	 Makes Balsa open specified mailbox(es) at startup.
	 Multiple mailboxes are delimited by semicolons.
* possibility of multiple arguments is not shown in syntaxdescription

 SUGGESTIONS AND BUG REPORTS
 Any bugs found should be reported to Balsa Developer mailing list
* (again) not use bts ?

 Before reporting bugs,
   please check if bug is mentioned in FAQ's or mailing list archive.
* not check bugs in debian's bts? not use reportbug?

 See section on Other Info for locations of these.
* where can i find that section ?

 AUTHORS
 See AUTHORS file included with Balsa,
   probably at /usr/share/doc/balsa-2.0.17/AUTHORS
* actually at /usr/share/doc/balsa/AUTHORS

 COPYRIGHT
 Permission to use, copy, modify, and distribute
   this software and its documentation
   for any purpose and without fee
   is hereby granted,
* 'without fee' restriction looks technically nonfree to me,
   as it seems to forbid redistribution-for-a-fee ;
   maybe ask upstream to be clearer about it ?


---------------------------------------
Received: (at 269787-close) by bugs.debian.org; 12 May 2005 18:28:33 +0000
>From katie@ftp-master.debian.org Thu May 12 11:28:33 2005
Return-path: <katie@ftp-master.debian.org>
Received: from newraff.debian.org [208.185.25.31] (mail)
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1DWIQD-0005HQ-00; Thu, 12 May 2005 11:28:33 -0700
Received: from katie by newraff.debian.org with local (Exim 3.35 1 (Debian))
	id 1DWIFK-0006Pt-00; Thu, 12 May 2005 14:17:18 -0400
From: Andrew Lau <netsnipe@users.sourceforge.net>
To: 269787-close@bugs.debian.org
X-Katie: $Revision: 1.55 $
Subject: Bug#269787: fixed in balsa 2.3.0-2sarge1
Message-Id: <E1DWIFK-0006Pt-00@newraff.debian.org>
Sender: Archive Administrator <katie@ftp-master.debian.org>
Date: Thu, 12 May 2005 14:17:18 -0400
Delivered-To: 269787-close@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-6.0 required=4.0 tests=BAYES_00,HAS_BUG_NUMBER 
	autolearn=no version=2.60-bugs.debian.org_2005_01_02
X-Spam-Level: 
X-CrossAssassin-Score: 4

Source: balsa
Source-Version: 2.3.0-2sarge1

We believe that the bug you reported is fixed in the latest version of
balsa, which is due to be installed in the Debian FTP archive:

balsa_2.3.0-2sarge1.diff.gz
  to pool/main/b/balsa/balsa_2.3.0-2sarge1.diff.gz
balsa_2.3.0-2sarge1.dsc
  to pool/main/b/balsa/balsa_2.3.0-2sarge1.dsc
balsa_2.3.0-2sarge1_i386.deb
  to pool/main/b/balsa/balsa_2.3.0-2sarge1_i386.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 269787@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Andrew Lau <netsnipe@users.sourceforge.net> (supplier of updated balsa package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Thu, 12 May 2005 23:41:01 +1000
Source: balsa
Binary: balsa
Architecture: source i386
Version: 2.3.0-2sarge1
Distribution: testing
Urgency: medium
Maintainer: Andrew Lau <netsnipe@users.sourceforge.net>
Changed-By: Andrew Lau <netsnipe@users.sourceforge.net>
Description: 
 balsa      - An e-mail client for GNOME
Closes: 269787 298579 306553 306556
Changes: 
 balsa (2.3.0-2sarge1) testing; urgency=medium
 .
   * Backport fixes from Balsa 2.3.1 and 2.3.2 for Debian "Sarge"
     + [debian/patches/01_extern_addrbook.patch]:
       - Re-enables external address books in the UI.
         (closes: #306553)
       - Fixes segfaults caused by accessing them.
         (closes: #306556)
     + [debian/patches/02_improved_manpage.patch]
       - Backported updated manpage from 2.3.2.
         Thanks: Siward de Groot <siward@wanadoo.nl>
         (closes: #269787)
     + [debian/patches/03_restored_icon.patch]
       - One line fix to restore window manager icon.
         (closes: #298579)
Files: 
 7f1f67a5a33bb7ccf3a4779495f5648b 1768 gnome optional balsa_2.3.0-2sarge1.dsc
 ef46bd973292fc346f844c9a88eef5f1 44111 gnome optional balsa_2.3.0-2sarge1.diff.gz
 e42c603f6077f6813e701627f2f92f18 2112844 gnome optional balsa_2.3.0-2sarge1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)
Comment: Signed by Jeroen van Wolffelaar <jeroen@wolffelaar.nl>

iD8DBQFCg5k7l2uISwgTVp8RAhOzAJwOcSgPgc28ElViErYqfuTVb0wKMQCgxBNO
xWs+LciNJ/1A0rLpYlzIEzM=
=o165
-----END PGP SIGNATURE-----