/usr/share/help/sl/mate-user-share/index.docbook is in mate-user-share-common 1.12.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 | <?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY appversion "2.26">
<!ENTITY app "mate-user-share">
]>
<article id="index" lang="sl">
<articleinfo>
<title lang="en">Personal File Sharing Manual</title>
<copyright lang="en">
<year>2009</year>
<holder>Red Hat, Inc.</holder>
</copyright>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>
<authorgroup>
<author role="maintainer" lang="en">
<firstname>Matthias</firstname>
<surname>Clasen</surname>
</author>
</authorgroup>
<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document. If not, you can omit it. -->
<revhistory>
<revision lang="en">
<revnumber>1.0</revnumber>
<date>2009</date>
<revdescription>
<para role="author" lang="en">Matthias Clasen <email>mclasen@redhat.com</email></para>
</revdescription>
</revision>
</revhistory>
<releaseinfo lang="en">This manual describes version 2.26 of mate-user-share.</releaseinfo>
<legalnotice>
<title lang="en">Feedback</title>
<para lang="en">To report a bug or make a suggestion regarding the mate-user-share application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.</para>
</legalnotice>
<abstract role="description">
<para lang="en">mate-user-share is a session service that enables easy sharing of files
between several computers.</para>
</abstract>
</articleinfo>
<indexterm lang="en"><primary>mate-user-share</primary></indexterm>
<indexterm lang="en"><primary>file sharing</primary></indexterm>
<indexterm lang="en"><primary>sharing</primary></indexterm>
<sect1 id="mate-user-share-intro">
<title lang="en">Introduction</title>
<para lang="en">
mate-user-share is a session service that exports the contents of the <filename>Public</filename> folder in your home directory, so that they can easily be accessed from other computers on the same local network. On the other computers, the shared folder will appear with a name like '<replaceable>user</replaceable>'s shared files' in the <application>caja</application> Network window, where <replaceable>user</replaceable> will be replaced by your user name.
</para>
<para lang="en">
mate-user-share uses a WebDAV server to share the <filename>Public</filename> folder, and advertises the share on the local network using mDNS.
</para>
<para lang="en">
Additionally, mate-user-share can make the shared files available via ObexFTP over Bluetooth, and receive files that are sent to your computer via Bluetooth via ObexPush.
</para>
</sect1>
<sect1 id="mate-user-share-getting-started">
<title lang="en">Getting started</title>
<sect2 id="mate-user-share-start">
<title lang="en">Starting mate-user-share</title>
<para lang="en">
The mate-user-share service is normally started by <application>mate-session</application> when you log in. You can change this by opening <menuchoice><guimenu>Preferences</guimenu><guimenu>Startup Applications</guimenu></menuchoice> in the <guimenu>System</guimenu> menu, and modifying the 'User Sharing' entry in the list of startup programs.
</para>
<para lang="en">
To configure various aspects of file sharing, use the File Sharing Preferences, which can be found in the <guimenu>System</guimenu> menu under
<menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice>.
</para>
<figure id="file-sharing-preferences">
<title lang="en">File Sharing Preferences</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/file-sharing-preferences.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</figure>
</sect2>
<sect2 id="mate-user-share-enabling-sharing">
<title lang="en">Enabling file sharing over the network</title>
<para lang="en">
Open the File Sharing Preferences using
<menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
</para>
<figure id="sharing-over-the-network">
<title lang="en">Share Files over the Network</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/sharing-over-the-network.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</figure>
<para lang="en">
To enable file sharing via WebDAV, use the <guilabel>Share public files on network</guilabel> checkbox. When file sharing it enabled, the controls for password protection allow to set a password that needs to be specified before a user on another computer is granted access to the shared files.
<note><para lang="en">Some firewall configurations on the local machine might cause problems with the advertisment, as well as the access to the shared files. Consult your system administrator for more details.</para></note>
<itemizedlist>
<listitem>
<para lang="en">
Select <guilabel>Never</guilabel> to allow everybody to
freely read or write files in the shared folder.
</para>
</listitem>
<listitem>
<para lang="en">
Select <guilabel>Always</guilabel> to require the password
to read or write files in the shared folder.
</para>
</listitem>
<listitem>
<para lang="en">
Select <guilabel>When writing files</guilabel> to allow everybody
to freely read files in the shared folder, but require the
password when writing files.
</para>
</listitem>
</itemizedlist>
<note><para lang="en">When you set a password, you have to give the password to all users that you want to have access to the shared files. Therefore, you should use a password that is different from other passwords you use.</para></note>
</para>
</sect2>
<sect2 id="mate-user-share-enabling-bluetooth">
<title lang="en">Enabling file sharing over Bluetooth</title>
<para lang="en">
Open the File Sharing Preferences using
<menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
</para>
<figure id="sharing-over-bluetooth">
<title lang="en">Share Files over Bluetooth</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/sharing-over-bluetooth.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</figure>
<para lang="en">
To enable file sharing via Bluetooth, use the <guilabel>Share public files over Bluetooth</guilabel> checkbox.
To allow remote Bluetooth devices to delete files in your shared folder, use the <guilabel>Allow remote devices to delete files</guilabel> checkbox.
To allow remote Bluetooth devices to access your shared files even when they are not bonded with your computer, use the <guilabel>Require remote devices to pair with this computer</guilabel> checkbox.
<note><para lang="en">When you allow unbonded remote devices to access your shared files, anybody with a Bluetooth-enabled cell phone in the vicinity of your computer can access and perhaps even modify your shared files.
</para></note>
</para>
</sect2>
<sect2 id="mate-user-share-bluetooth-receiving">
<title lang="en">Receiving Files over Bluetooth</title>
<para lang="en">
Open the File Sharing Preferences using
<menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
</para>
<figure id="receiving-over-bluetooth">
<title lang="en">Receive Files over Bluetooth</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/receiving-over-bluetooth.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</figure>
<para lang="en">
To let remote Bluetooth devices send files to your computer, use the <guilabel>Receive files in Downloads folder over Bluetooth</guilabel> checkbox. Received files will be stored in the <filename>Downloads</filename> folder in your home directory. When receiving files is enabled, the <guilabel>Accept files</guilabel> selection allows you to determine which remote devices are allowed to send files.
<itemizedlist>
<listitem>
<para lang="en">
Select <guilabel>Always</guilabel> to allow any remote device to send files.
</para>
</listitem>
<listitem>
<para lang="en">
Select <guilabel>Only for Bonded devices</guilabel> to accept files only from bonded devices.
<note><para lang="en">Bonded devices are the ones that were connected to your computer, and had to enter a PIN code to connect to or from.</para></note>
</para>
</listitem>
<listitem>
<para lang="en">
Select <guilabel>Only for Bonded and Trusted devices</guilabel> to accept files only from bonded devices.
<note><para lang="en">Devices can be marked as trusted in the <application>bluetooth-properties</application>'s <guilabel>Known devices</guilabel> section.</para></note>
</para>
</listitem>
</itemizedlist>
</para>
<para lang="en">
Use the <guilabel>Notify about received files</guilabel> checkbox to select whether you want to be notified whenever a file is received via Bluetooth.
</para>
</sect2>
</sect1>
</article>
|