[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Alexander Potashev]

https://bugs.kde.org/show_bug.cgi?id=351642

--- Comment #10 from Alexander Potashev  ---
(In reply to Nate Graham from comment #4)
> Just running `balooctl` shows the options and what they will do. It's not a
> full manpage, but it's good enough IMO.

This only works if you have `balooctl` installed. If we had a real manpage, you
could also find it online, e.g. http://manpages.org/meinproc5/8 for meinproc5.

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Christoph Feck]

https://bugs.kde.org/show_bug.cgi?id=351642

--- Comment #9 from Christoph Feck  ---
--help and --version are indeed not a Unix standard, but a GNU standard. Many
KDE tools follow GNU conventions, despite not being GNU projects. We actually
try to support both standards for these two important options: -h and -v also
work on most KDE programs.

https://www.gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Nate Graham]

https://bugs.kde.org/show_bug.cgi?id=351642

Nate Graham  changed:

   What|Removed |Added

 Resolution|WAITINGFORINFO  |INTENTIONAL
 Status|NEEDSINFO   |RESOLVED

--- Comment #8 from Nate Graham  ---
I disagree. It's extremely common and I've encountered it over and over again
throughout my career using UNIX-like operating systems. And KDE's command-line
programs universally use this style instead of manpages.

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[bugzilla_noreply]

https://bugs.kde.org/show_bug.cgi?id=351642

--- Comment #7 from moon...@posteo.org ---
> Can you articulate what exactly is the problem is
> with running `balooctl --help`?

It is not usual in unixoid environments.

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Nate Graham]

https://bugs.kde.org/show_bug.cgi?id=351642

Nate Graham  changed:

   What|Removed |Added

 Resolution|--- |WAITINGFORINFO
 Status|REOPENED|NEEDSINFO

--- Comment #6 from Nate Graham  ---
(In reply to moonkid from comment #5)
> The decission if this is a bug or not should not depend on YOUR opinion but
> on rules and regularities; e.g. goals of KDE to make the Linux Desktop
> usable for everyone (also granny).
Well, I'm one of the Baloo developers, so in fact it does depend on my opinion.
:) However even if that was not true, KDE does not have a global policy that
all command line tools much have manpages.

Also, most grannies I know don't read manpages. They use GUI software.

Can you articulate what exactly is the problem is with running `balooctl
--help`?

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[bugzilla_noreply]

https://bugs.kde.org/show_bug.cgi?id=351642

moon...@posteo.org changed:

   What|Removed |Added

 Resolution|WORKSFORME  |---
 Status|RESOLVED|REOPENED
 Ever confirmed|0   |1

--- Comment #5 from moon...@posteo.org ---
The decission if this is a bug or not should not depend on YOUR opinion but on
rules and regularities; e.g. goals of KDE to make the Linux Desktop usable for
everyone (also granny).

KDE is not a Hacker/Nerd graphical desktop environment on top of GNU Linux!

A manpage should be the minimum for each application.

btw: Just running `balooctl` is buggy, too because there is no version
information given. Using explicite `-v` for is is unusal, too and an unneeded
obstacle to the user.

btw: I am not a usual KDE user. I am just a member of the FOSS community and
try to improve a "product" having the FOSS movement and the users in my mind. I
am not the user here.

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Nate Graham]

https://bugs.kde.org/show_bug.cgi?id=351642

Nate Graham  changed:

   What|Removed |Added

 Status|REPORTED|RESOLVED
 Resolution|--- |WORKSFORME

--- Comment #4 from Nate Graham  ---
Just running `balooctl` shows the options and what they will do. It's not a
full manpage, but it's good enough IMO.

-- 
You are receiving this mail because:
You are watching all bug changes.

[frameworks-baloo] [Bug 351642] Manpage for balooctl

[Nate Graham]

https://bugs.kde.org/show_bug.cgi?id=351642

Nate Graham  changed:

   What|Removed |Added

  Component|general |balooctl
Summary|create a manpage|Manpage for balooctl

-- 
You are receiving this mail because:
You are watching all bug changes.