[kde-doc-english] The new data dirs and kf5 docs

[Burkhard Lück]

Am Donnerstag, 20. August 2015, 13:57:19 schrieb Luigi Toscano:
> On Thursday 20 of August 2015 14:46:45 Yuri Chornoivan wrote:
> > Hi,
> 
> Hi,
> CC: kde-core-devel@ for some help (see below).
> 
> > As it was pointed by Burkhard [1], the paths in kf5 docs should be
> > updated/fixed to the new configuration.
> > 
> > The list is rather big now:
> > 
> > fundamentals/config.docbook
> > korganizer
> > knotes
> > kalarm
> > kmail
> > konversation
> > kate/plugins.docbook
> > kgeography
> > kwordquiz
> > kstars/faq.docbook
> > kstars/config.docbook
> > kstars/install.docbook
> > khangman
> > killbots
> > ktuberling/technical-reference.docbook
> > okteta
> > tellico/faqs.docbook
> > tellico/fundamentals.docbook
> > tellico/configuration.docbook
> > kile/inedx.docbook
> > kile/usermenu.docbook
> > kile/scripting.docbook
> > 
> > However, it is not clear what environment variables can (or should) be
> > used to help user in finding the proper files. In my KDE 4 environment
> > some variables are undefined:
> > 
> > [yurchor at localhost uk]$ printenv|grep XDG
> > XDG_VTNR=1
> > XDG_SESSION_ID=c1
> > XDG_MENU_PREFIX=kde-
> > XDG_CONFIG_DIRS=/etc/xdg:/etc/xdg/kde4
> > XDG_SEAT=seat0
> > XDG_DATA_DIRS=/usr/share:/usr/share:/usr/local/share
> > XDG_RUNTIME_DIR=/run/user/500
> > XDG_CURRENT_DESKTOP=KDE
> > 
> > As you can see, there are no XDG_DATA_HOME (default $HOME/.local),
> > XDG_CONFIG_HOME (default $HOME/.config) and XDG_CACHE_HOME.
> > 
> > So,
> > 
> > 1. Can anybody confirm that all these variables are defined in Plasma 5
> > and other modern DEs?
> > 
> > 2. Are there any objections about usage something like `echo
> > ${XDG_DATA_DIRS%%:*}` instead of `kde4-config --install data`? What are
> > the possible shortcomings? Does it work for shells other than BASH?
> 
> I don't think it's the proper way. I think the solution is to use qtpaths. I
> would ask on the kde-core-devel@ list for more details.
> 
Using qtpaths on kubuntu + fedora kde spin in VMs I have:

qtpaths --paths ConfigLocation
first item is XDG_CONFIG_HOME (default $HOME/.config), other items are different 
in both VMs

qtpaths --paths GenericConfigLocation
same as ConfigLocation

qtpaths --paths GenericDataLocation
first item is XDG_DATA_HOME  (default $HOME/.local), other items are different 
in both VMs

qtpaths --paths GenericCacheLocation
only one item XDG_CACHE_HOME (default $HOME/.cache)

-- 
Burkhard Lück