[kde-doc-english] branches/work/doc/buildingblocks

[T.C. Hollingsworth]

Hi Burkhard!

On Sun, Jan 29, 2012 at 1:24 PM, Burkhard Lück <lueck at hube-lueck.de> wrote:
> SVN commit 1276633 by lueck:
>
> add some comments for further improvements
>
>  M  +5 -2      files.docbook
>
>
> --- branches/work/doc/buildingblocks/files.docbook #1276632:1276633
> @@ -23,6 +23,7 @@
>  <imageobject><imagedata fileref="files-open.png" format="PNG"/></imageobject>
>  <textobject><phrase>The File Open window.</phrase></textobject>
>  <caption><para>Opening a file in <ulink url="help:/konqueror">&konqueror;</ulink>.
> +  <!-- Does it really make sense to link to konqueror docs here? if not installed it is probably a dead link-->

Since this is serving as a sort of "intro to KDE" doc, I thought it
would be good to a.) show off several different basic KDE apps in the
screenshots and b.) link to their documentation so users can learn
more about these applications if interested.  We could instead link to
e.g. http://kde.org/applications/internet/konqueror/ if that would be
better.

Speaking of that, maybe an overview of applications ala
kde.org/applications would be good for buildingblocks?  Generating
docbook for it from the json files in
trunk/www/sites/www/applications/apps/ would be pretty easy.

>  </para></caption>
>  </mediaobject>
>  </screenshot>
> @@ -257,7 +258,9 @@
>  arrows to the left of a folder to select any folders beneath it.
>  <!--FIXME This is a dolphin specific behaviour and is different than described here:
>  If Places panel in Dolphin is hidden, an additional icon is displayed beside the
> -leftmost ">"icon.
> +leftmost ">"icon.  (This feature will probably be in File dialog in 4.9)
> +Gwenview shows the Places icon in the location bar as well
> +
>  You may also
>  select from your list of Places by clicking the leftmost icon in the breadcrumb
>   navigation, which displays an icon that represents your current Place.--></para>
> @@ -287,7 +290,7 @@
>  items in the current directory.  To select a file, you can double-click on it,
>  or choose one and hit <guibutton>Open</guibutton> or
>  <guibutton>Save</guibutton>.</para>
> -
> + <!-- Explain how to select several files: Ctrl/Shift+LMB etc ?)-->
>  <para>The Folder View supports a limited set of file operations, which can be
>  accessed by right-clicking on a file to access its context menu, or using
>  keyboard shortcuts.  The following items are available in the context menu:</para>

-T.C.