Bug#548229: ksnapshot has no man page

classic Classic list List threaded Threaded
10 messages Options
Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

danielbarrettbolton (Bugzilla)
Package: ksnapshot
Version: 4:4.3.1-1
Severity: normal


This is a binary without a manpage.

-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.30-dbb-deb (SMP w/2 CPU cores; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages ksnapshot depends on:
ii  kdebase-runtime               4:4.3.1-1  runtime components from the offici
ii  kdelibs5                      4:4.3.1-1  core libraries for all KDE 4 appli
ii  libc6                         2.9-25     GNU C Library: Shared libraries
ii  libqt4-dbus                   4:4.5.2-2  Qt 4 D-Bus module
ii  libqtcore4                    4:4.5.2-2  Qt 4 core module
ii  libqtgui4                     4:4.5.2-2  Qt 4 GUI module
ii  libstdc++6                    4.4.1-1    The GNU Standard C++ Library v3
ii  libx11-6                      2:1.2.2-1  X11 client-side library

ksnapshot recommends no packages.

ksnapshot suggests no packages.

-- no debconf information



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

armin (Bugzilla)-3
tags 548229 help
kthxbye

Hi Daniel!

On Thu, 24 Sep 09 14:04, Daniel Bolton wrote:
> Package: ksnapshot

> This is a binary without a manpage.

Thanks for your bugreport. Sadly KDE upstream does not ship manpages for
nearly all executables and the Debian KDE team has no time to write the
missing manpages.
If you would provide us a manpage we can add it to the package.

Greetings,
Armin



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Processed: Re: Bug#548229: ksnapshot has no man page

Debian Bug Tracking System
Processing commands for [hidden email]:

> tags 548229 help
Bug #548229 [ksnapshot] ksnapshot has no man page
Added tag(s) help.
> kthxbye
Stopping processing here.

Please contact me if you need assistance.

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


--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

danielbarrettbolton (Bugzilla)
In reply to this post by armin (Bugzilla)-3
Armin,

I have attached a man page.

Thanks,
Daniel

On Thu, Sep 24, 2009 at 4:54 PM, Armin Berres <[hidden email]> wrote:

> tags 548229 help
> kthxbye
>
> Hi Daniel!
>
> On Thu, 24 Sep 09 14:04, Daniel Bolton wrote:
>> Package: ksnapshot
>
>> This is a binary without a manpage.
>
> Thanks for your bugreport. Sadly KDE upstream does not ship manpages for
> nearly all executables and the Debian KDE team has no time to write the
> missing manpages.
> If you would provide us a manpage we can add it to the package.
>
> Greetings,
> Armin
>


--
Daniel

kdesnapshot.1 (1K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

danielbarrettbolton (Bugzilla)
Armin,

I have attached a man page.

Thanks,
Daniel

On Thu, Sep 24, 2009 at 4:54 PM, Armin Berres <[hidden email]> wrote:

> tags 548229 help
> kthxbye
>
> Hi Daniel!
>
> On Thu, 24 Sep 09 14:04, Daniel Bolton wrote:
>> Package: ksnapshot
>
>> This is a binary without a manpage.
>
> Thanks for your bugreport. Sadly KDE upstream does not ship manpages for
> nearly all executables and the Debian KDE team has no time to write the
> missing manpages.
> If you would provide us a manpage we can add it to the package.
>
> Greetings,
> Armin
>
--
Daniel

kdesnapshot.1 (1K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

Ana Guerrero Lopez
On Thu, Sep 24, 2009 at 05:50:04PM -0400, Daniel Bolton wrote:
> Armin,
>
> I have attached a man page.
>

Thanks, but could you provide an *useful* manpage? The manpage you have
attached just shows the output of "ksnapshot --help", if we thought this is
useful we already would have added this automatically long time ago...


Ana




--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

Frederik Schwarzer-3
[Ana Guerrero | Friday 25 September 2009]
> On Thu, Sep 24, 2009 at 05:50:04PM -0400, Daniel Bolton wrote:
> > Armin,
> >
> > I have attached a man page.
>
> Thanks, but could you provide an *useful* manpage? The manpage you have
> attached just shows the output of "ksnapshot --help", if we thought this
>  is useful we already would have added this automatically long time
>  ago...

Could you define "useful"? I saw some manpages that basically state the
--help output with one or two sentences above to explain what the tool is
for.

Regards



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

Ana Guerrero Lopez
On Fri, Sep 25, 2009 at 06:01:18PM +0200, Frederik Schwarzer wrote:

> [Ana Guerrero | Friday 25 September 2009]
> > On Thu, Sep 24, 2009 at 05:50:04PM -0400, Daniel Bolton wrote:
> > > Armin,
> > >
> > > I have attached a man page.
> >
> > Thanks, but could you provide an *useful* manpage? The manpage you have
> > attached just shows the output of "ksnapshot --help", if we thought this
> >  is useful we already would have added this automatically long time
> >  ago...
>
> Could you define "useful"? I saw some manpages that basically state the
> --help output with one or two sentences above to explain what the tool is
> for.

Yes, there is plenty of no useful manpages. That is not excuse to add more.

About what is useful from my POV, if after reading a manpage you know something
else about what you can do with the app.
For example, look at "ark" manpage (sadly, outdated) it not only includes the
relevant output of --help (it skip the generic options), it also includes
examples of how to use the app, what to read to know more ("see also" paragprah),
ark's maintainer, where to find more information about ark, a long description about
ark...
And it could include more stuff like where to report bugs...


Ana



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

danielbarrettbolton (Bugzilla)
In reply to this post by Ana Guerrero Lopez
Sorry for wasting your time. I think a simple man page should have
been added a long time ago. Then I wouldn't have filed this report and
wasted my time. The handbook entry (
http://docs.kde.org/development/en/kdegraphics/ksnapshot/index.html )
pretty much gives the same info about invoking the program and then
says to click the buttons.

On Fri, Sep 25, 2009 at 10:03 AM, Ana Guerrero <[hidden email]> wrote:

> On Thu, Sep 24, 2009 at 05:50:04PM -0400, Daniel Bolton wrote:
>> Armin,
>>
>> I have attached a man page.
>>
>
> Thanks, but could you provide an *useful* manpage? The manpage you have
> attached just shows the output of "ksnapshot --help", if we thought this is
> useful we already would have added this automatically long time ago...
>
>
> Ana
>
>



--
Daniel



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#548229: ksnapshot has no man page

Ana Guerrero Lopez

Hi Daniel,

On Fri, Sep 25, 2009 at 01:59:03PM -0400, Daniel Bolton wrote:
> Sorry for wasting your time. I think a simple man page should have
> been added a long time ago. Then I wouldn't have filed this report and
> wasted my time. The handbook entry (
> http://docs.kde.org/development/en/kdegraphics/ksnapshot/index.html )
> pretty much gives the same info about invoking the program and then
> says to click the buttons.
>

Nobody is wasting their time here. I do not know if you are subscribed to the
bug, but I should have send you this more useful answer [1] firstly to you, sorry.

[1] http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=548229#37


> On Fri, Sep 25, 2009 at 10:03 AM, Ana Guerrero <[hidden email]> wrote:
> > On Thu, Sep 24, 2009 at 05:50:04PM -0400, Daniel Bolton wrote:
> >> Armin,
> >>
> >> I have attached a man page.
> >>
> >
> > Thanks, but could you provide an *useful* manpage? The manpage you have
> > attached just shows the output of "ksnapshot --help", if we thought this is
> > useful we already would have added this automatically long time ago...
> >
> >
> > Ana
> >
> >
>
>
>
> --
> Daniel



--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]