[smb4k] doc: Fixed several format issues in the handbook.
Alexander Reinholdt
null at kde.org
Sun Jan 8 11:50:09 UTC 2017
Git commit b52247fd9772f63ac66eb07b3dcd709e0db1ba3e by Alexander Reinholdt.
Committed on 08/01/2017 at 11:35.
Pushed by areinholdt into branch 'master'.
Fixed several format issues in the handbook.
M +42 -38 doc/index.docbook
https://commits.kde.org/smb4k/b52247fd9772f63ac66eb07b3dcd709e0db1ba3e
diff --git a/doc/index.docbook b/doc/index.docbook
index 95e763f..4d0a705 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1474,14 +1474,18 @@ client ipc max protocol = NT1
<itemizedlist>
<listitem><para>Configure, compile and install &smb4k; according to the directions given in the <link linkend="appendix_compilation">Configuration, Compilation and Installation</link> section of the appendix.</para></listitem>
<listitem><para>After installation, link (or copy) the file <filename>net.sourceforge.smb4k.mounthelper.conf</filename> from the <filename class="directory">examples</filename> directory to the right location:</para>
- <para><screen><userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/pkg/etc/dbus-1/system.d/</filename></userinput>
- <userinput><prompt>$</prompt> <command>sudo ln</command> -s \
- <filename>/usr/pkg/share/examples/kde4-dbus/net.sourceforge.smb4k.mounthelper.conf</filename> .</userinput></screen></para></listitem>
+
+<screen>
+<userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/pkg/etc/dbus-1/system.d/</filename></userinput>
+<userinput><prompt>$</prompt> <command>sudo ln</command> -s \
+ <filename>/usr/pkg/share/examples/kde4-dbus/net.sourceforge.smb4k.mounthelper.conf</filename> .</userinput>
+</screen>
+ </listitem>
<listitem><para>Edit the file <filename>/usr/pkg/etc/PolicyKit/PolicyKit.conf</filename> and add the following paragraph in the <config version="0.1"> section:</para>
<programlisting>
<match action="org.kde.smb4k.mounthelper.*">
-<return result="yes">
+ <return result="yes">
</match></programlisting>
<para>This will allow everyone to mount and unmount remote Samba shares with &smb4k;.</para></listitem>
@@ -3589,33 +3593,33 @@ client ipc max protocol = NT1
<para>This section describes the configuration, compilation and installation of &smb4k;. Make sure, you have read the <link linkend="appendix_requirements">Requirements</link> page before you start.</para>
<para><ulink url="https://sourceforge.net/projects/smb4k/files">Download</ulink> the version of Smb4K you are interested in and extract the source tarball:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>tar</command> xvfJ smb4k-x.y.z.tar.xz</userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>tar</command> xvfJ smb4k-x.y.z.tar.xz</userinput>
+</screen>
+
<para>Replace x.y.z with the version number. Change into the source code directory and create a <filename class="directory">build</filename> directory:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">smb4k-x.y.z</filename></userinput>
- <prompt>$</prompt> <userinput><command>mkdir</command> <filename class="directory">build</filename></userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">smb4k-x.y.z</filename></userinput>
+<prompt>$</prompt> <userinput><command>mkdir</command> <filename class="directory">build</filename></userinput>
+</screen>
+
<para>Change into the <filename class="directory">build</filename> directory and configure the source code:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">build</filename></userinput>
- <prompt>$</prompt> <userinput><command>cmake</command> -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` -DCMAKE_BUILD_TYPE=Release <filename class="directory">..</filename></userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">build</filename></userinput>
+<prompt>$</prompt> <userinput><command>cmake</command> -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` -DCMAKE_BUILD_TYPE=Release <filename class="directory">..</filename></userinput>
+</screen>
+
<para>If Smb4K cannot find some shared libraries after the installation (⪚ if you are using Kubuntu 16.04), it is necessary to add the <option>-DKDE_INSTALL_PLUGINDIR</option> argument to the command line above:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">build</filename></userinput>
- <prompt>$</prompt> <userinput><command>cmake</command> -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` \
- -DKDE_INSTALL_PLUGINDIR=`qtpaths --plugin-dir` -DCMAKE_BUILD_TYPE=Release <filename class="directory">..</filename></userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">build</filename></userinput>
+<prompt>$</prompt> <userinput><command>cmake</command> -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` \
+ -DKDE_INSTALL_PLUGINDIR=`qtpaths --plugin-dir` -DCMAKE_BUILD_TYPE=Release <filename class="directory">..</filename></userinput>
+</screen>
+
<para>If you want to compile Smb4K with debug symbols, replace Release by Debug. You should consider this if you experience &ie; a crash and want to either debug &smb4k; yourself or report a bug including a full backtrace</para>
<para>There are also some &smb4k; specific arguments you might be interested in:</para>
<para>
@@ -3644,17 +3648,17 @@ client ipc max protocol = NT1
</informaltable>
</para>
<para>After the configuration, compile and install &smb4k;:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>make</command> && <command>sudo make</command> install</userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>make</command> && <command>sudo make</command> install</userinput>
+</screen>
+
<para>If you want to be able to remove &smb4k; with your package manager later on, use <application>checkinstall</application> instead of <command>make install</command>. The package should be present in your distribution's repository. Run:</para>
- <para>
- <screen>
- <prompt>$</prompt> <userinput><command>make</command> && <command>sudo checkinstall</command></userinput>
- </screen>
- </para>
+
+<screen>
+<prompt>$</prompt> <userinput><command>make</command> && <command>sudo checkinstall</command></userinput>
+</screen>
+
</sect1>
</appendix>
</book>
\ No newline at end of file
More information about the kde-doc-english
mailing list