[Pkg-utopia-maintainers] Bug#604784: Bug#604784: /usr/bin/palimpsest: man page missing

[Michael Biebl]

On 24.11.2010 11:32, Vincent Cheng wrote:
> Package: gnome-disk-utility
> Version: 2.30.1-2
> Severity: normal
> File: /usr/bin/palimpsest
> 
> As a Debian Google Code-In student, I'd like to submit a missing manual page for palimpsest (attached with this bug report). Please let me know if you think anything needs to be changed.
> 

Hi Vincent,

thanks for your contribution.
Such patches should best be sent upstream directly, so I'm bringing David into
the loop here.

But tbh, I think integrating a proper help system (based on yelp) would be much
more valuable to our users as you can e.g. include graphics/screenshots and it
is directly accessible from within the gui.
See [1] for more details if you are interested in working on this.

The man page itself has a few formatting errors (e.g. ..TH, should be .TH) and
is very short. It doesn't really offer more information than the package
description and the output of palimpsest --help. To be really useful you should
explain e.g. the command line args in more detail, provide an EXAMPLE section etc.

Cheers,
Michael


[1] http://library.gnome.org/admin/system-admin-guide/stable/help-0.html.en

-- 
Why is it that all of the instruments seeking intelligent life in the
universe are pointed away from Earth?
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: palimpsest.1
URL: <http://lists.alioth.debian.org/pipermail/pkg-utopia-maintainers/attachments/20101124/029abff6/attachment.asc>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 900 bytes
Desc: OpenPGP digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-utopia-maintainers/attachments/20101124/029abff6/attachment.pgp>