This file is indexed.

/usr/share/help/sl/mate-user-share/index.docbook is in mate-user-share-common 1.16.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>