Bug 89955

Summary: kbuildsycoca undocumented no manpage
Product: [Websites] docs.kde.org Reporter: Gunnar <gunix>
Component: Missing ContentAssignee: T.C. Hollingsworth <tchollingsworth>
Status: RESOLVED FIXED    
Severity: wishlist CC: kde-doc-english, lueck, tchollingsworth
Priority: NOR    
Version: unspecified   
Target Milestone: ---   
Platform: Gentoo Packages   
OS: Linux   
Latest Commit: Version Fixed In:
Sentry Crash Report:

Description Gunnar 2004-09-21 14:59:35 UTC
Version:            (using KDE KDE 3.3.0)
Installed from:    Gentoo Packages

kbuildsycoca is not documented. It has no manpage. That's too bad, since I would like to know what a command does before I use it. It solved some problems though, so I'm happy it's there!
Comment 1 Lauri Watts 2005-03-21 13:36:24 UTC
I will be writing it a man page, it will probably initially only contain what 
Comment 2 Lauri Watts 2005-03-21 13:37:49 UTC
oops, hit enter too soon.

I was going to say, it will mostly have what you can already get from running 'kbuildsycoca --help' - all KDE apps should already answer to --help with some instructions for you.
Comment 3 Nicolas Goutte 2005-09-11 14:29:50 UTC
There are already DocBook files about kbuildsycoca in kdelibs/kdoctools:
kbuildsycoca.entry.desktop
kbuildsycoca.man.desktop

However the corresponding Makefile.am is not made for using themm and at least 
the file name of the man page is wrong for KDE's build system.

Have a nice day!

(PS.: sorry, if this entry is  double, but KDE Bugs' web inteface seems to be 
on strike again.)
Comment 4 Nicolas Goutte 2005-12-22 10:35:00 UTC
Does anybody see a reason *not* to move the man page of kbuildsycoca(8) from 
kdelibs/kdoctools/kbuildsycoca.man.docbook
to
kdelibs/docs/kdelibs/man-kbuildsycoca.8.docbook
(for KDE 3.5.1 and KDE4)

Of course, this would not solve bug #89955, but it would be a first step to 
solve it by at least having a man page.

As we are talking about kbuildsycoca's documenation, can somebody tell what
kdelibs/kdoctools/kbuildsycoca.refentry.docbook was meant for?

Have a nice day!
Comment 5 Nicolas Goutte 2005-12-23 04:50:59 UTC
On Thursday 22 December 2005 10:34, Nicolas Goutte wrote:
> Does anybody see a reason *not* to move the man page of kbuildsycoca(8)
> from kdelibs/kdoctools/kbuildsycoca.man.docbook
> to
> kdelibs/docs/kdelibs/man-kbuildsycoca.8.docbook
> (for KDE 3.5.1 and KDE4)
>
> Of course, this would not solve bug #89955, but it would be a first step to
> solve it by at least having a man page.
>
> As we are talking about kbuildsycoca's documenation, can somebody tell what
> kdelibs/kdoctools/kbuildsycoca.refentry.docbook was meant for?


I think that I have found the answer by myself.

In fact it is
kdelibs/kdoctools/kbuildsycoca.refentry.docbook
that needs to be moved to
kdelibs/docs/kdelibs/man-kbuildsycoca.8.docbook

>
> Have a nice day!

Comment 6 Nicolas Goutte 2005-12-24 14:16:18 UTC
SVN commit 491058 by goutte:

Move kbuildsycoca.refentry.docbook so that it can be build as man page
by the KDE build system.
(The DocBook seems to be a little outdated.)
CCBUG:89955
CCMAIL:kde-i18n-doc@kde.org


 A             doc/kdelibs/man-kbuildsycoca.8.docbook   kdoctools/kbuildsycoca.refentry.docbook#490525
 D             kdoctools/kbuildsycoca.refentry.docbook  
Comment 7 Nicolas Goutte 2005-12-24 15:33:52 UTC
SVN commit 491086 by goutte:

Remove kbuildsycoca.man.docbook, as it does not seem useful anymore.
(It is not the DocBook for the man page and it is an "article", so not suitable
for a KDE documentation. If somebody really wants to make a KDE documentation
only about kbuildsycoca, he/she should better try to start from the
kdelibs/doc/kdelibs/man-kbuildsycoca.8.docbook that will be uptodate
at that moment.)
CCBUG:89955


 D             kbuildsycoca.man.docbook  
Comment 8 T.C. Hollingsworth 2011-12-08 11:29:45 UTC
I'll submit this as a task for Google Code-In.
Comment 9 Burkhard Lück 2011-12-08 11:34:05 UTC
man:/kbuildsycoca4 show a man page here
Comment 10 T.C. Hollingsworth 2011-12-08 11:38:33 UTC
Here too.  I've never been able to spell this command right on the first try.  :-/
Comment 11 Albert Astals Cid 2011-12-08 11:56:28 UTC
T.C. it's easy if you know what it means ;-)

kbuildsycoca4 =
"k"de
"build"
"sy"stem
"co"nfiguration
"ca"che
"4"