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

[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.

> 
> [1]
> https://techbase.kde.org/Projects/Documentation/KDE_(health_table)#KDE_Frame
> works 

Ciao
-- 
Luigi