From c0f0c63c670d799dee4fa7577083d0cbace56db4 Mon Sep 17 00:00:00 2001 From: infirit Date: Mon, 10 Feb 2014 02:31:30 +0100 Subject: Restore user-guide and port to yelp --- help/C/figures/file-sharing-preferences.png | Bin 0 -> 34673 bytes help/C/figures/receiving-over-bluetooth.png | Bin 0 -> 11176 bytes help/C/figures/sharing-over-bluetooth.png | Bin 0 -> 9216 bytes help/C/figures/sharing-over-the-network.png | Bin 0 -> 10333 bytes help/C/index.docbook | 202 ++++++++++++++++++++++++++++ help/C/legal.xml | 72 ++++++++++ 6 files changed, 274 insertions(+) create mode 100644 help/C/figures/file-sharing-preferences.png create mode 100644 help/C/figures/receiving-over-bluetooth.png create mode 100644 help/C/figures/sharing-over-bluetooth.png create mode 100644 help/C/figures/sharing-over-the-network.png create mode 100644 help/C/index.docbook create mode 100644 help/C/legal.xml (limited to 'help/C') diff --git a/help/C/figures/file-sharing-preferences.png b/help/C/figures/file-sharing-preferences.png new file mode 100644 index 0000000..028e402 Binary files /dev/null and b/help/C/figures/file-sharing-preferences.png differ diff --git a/help/C/figures/receiving-over-bluetooth.png b/help/C/figures/receiving-over-bluetooth.png new file mode 100644 index 0000000..80da000 Binary files /dev/null and b/help/C/figures/receiving-over-bluetooth.png differ diff --git a/help/C/figures/sharing-over-bluetooth.png b/help/C/figures/sharing-over-bluetooth.png new file mode 100644 index 0000000..fdfca65 Binary files /dev/null and b/help/C/figures/sharing-over-bluetooth.png differ diff --git a/help/C/figures/sharing-over-the-network.png b/help/C/figures/sharing-over-the-network.png new file mode 100644 index 0000000..be49c83 Binary files /dev/null and b/help/C/figures/sharing-over-the-network.png differ diff --git a/help/C/index.docbook b/help/C/index.docbook new file mode 100644 index 0000000..92a389b --- /dev/null +++ b/help/C/index.docbook @@ -0,0 +1,202 @@ + + + +]> + +
+ + Personal File Sharing Manual + + 2009 + Red Hat, Inc. + + + + + + Matthias + Clasen + + + + + + + + 1.0 + 2009 + + Matthias Clasen mclasen@redhat.com + + + + This manual describes version &appversion; of &app;. + + Feedback + To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page. + + + &app; is a session service that enables easy sharing of files + between several computers. + + + mate-user-share + file sharing + sharing + + + Introduction + + &app; is a session service that exports the contents of the Public 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 'user's shared files' in the caja Network window, where user will be replaced by your user name. + + + &app; uses a WebDAV server to share the Public folder, and advertises the share on the local network using mDNS. + + + Additionally, &app; can make the shared files available via ObexFTP over Bluetooth, and receive files that are sent to your computer via Bluetooth via ObexPush. + + + + + Getting started + + + Starting &app; + + + The &app; service is normally started by mate-session when you log in. You can change this by opening PreferencesStartup Applications in the System menu, and modifying the 'User Sharing' entry in the list of startup programs. + + + + To configure various aspects of file sharing, use the File Sharing Preferences, which can be found in the System menu under + PreferencesPersonal File Sharing. + +
+ File Sharing Preferences + + + + + + + +
+ + + + Enabling file sharing over the network + + Open the File Sharing Preferences using + PreferencesPersonal File Sharing in the System menu. + +
+ Share Files over the Network + + + + + + + +
+ + To enable file sharing via WebDAV, use the Share public files on network 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. + 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. + + + + Select Never to allow everybody to + freely read or write files in the shared folder. + + + + + Select Always to require the password + to read or write files in the shared folder. + + + + + Select When writing files to allow everybody + to freely read files in the shared folder, but require the + password when writing files. + + + + 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. + + + + + Enabling file sharing over Bluetooth + + Open the File Sharing Preferences using + PreferencesPersonal File Sharing in the System menu. + +
+ Share Files over Bluetooth + + + + + + + +
+ + To enable file sharing via Bluetooth, use the Share public files over Bluetooth checkbox. + To allow remote Bluetooth devices to delete files in your shared folder, use the Allow remote devices to delete files checkbox. + To allow remote Bluetooth devices to access your shared files even when they are not bonded with your computer, use the Require remote devices to pair with this computer checkbox. + 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. + + + + + + Receiving Files over Bluetooth + + Open the File Sharing Preferences using + PreferencesPersonal File Sharing in the System menu. + +
+ Receive Files over Bluetooth + + + + + + + +
+ + To let remote Bluetooth devices send files to your computer, use the Receive files in Downloads folder over Bluetooth checkbox. Received files will be stored in the Downloads folder in your home directory. When receiving files is enabled, the Accept files selection allows you to determine which remote devices are allowed to send files. + + + + Select Always to allow any remote device to send files. + + + + + Select Only for Bonded devices to accept files only from bonded devices. + Bonded devices are the ones that were connected to your computer, and had to enter a PIN code to connect to or from. + + + + + + Select Only for Bonded and Trusted devices to accept files only from bonded devices. + Devices can be marked as trusted in the bluetooth-properties's Known devices section. + + + + + + Use the Notify about received files checkbox to select whether you want to be notified whenever a file is received via Bluetooth. + + + + +
diff --git a/help/C/legal.xml b/help/C/legal.xml new file mode 100644 index 0000000..0ecbd2f --- /dev/null +++ b/help/C/legal.xml @@ -0,0 +1,72 @@ + + + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation + License (GFDL), Version 1.1 or any later version published + by the Free Software Foundation with no Invariant Sections, + no Front-Cover Texts, and no Back-Cover Texts. You can find + a copy of the GFDL at this link or in the file COPYING-DOCS + distributed with this manual. + + This manual is part of a collection of GNOME manuals + distributed under the GFDL. If you want to distribute this + manual separately from the collection, you can do so by + adding a copy of the license to the manual, as described in + section 6 of the license. + + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and the members of + the GNOME Documentation Project are made aware of those + trademarks, then the names are in capital letters or initial + capital letters. + + + + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED + UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE + WITH THE FURTHER UNDERSTANDING THAT: + + + + DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, + WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR + IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES + THAT THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR + A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE + RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE + OF THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR + MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, + YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY + CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY + SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER + OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS + LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED + VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER + EXCEPT UNDER THIS DISCLAIMER; AND + UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL + THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), + CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, + INITIAL WRITER, ANY CONTRIBUTOR, OR ANY + DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION + OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH + PARTIES, BE LIABLE TO ANY PERSON FOR ANY + DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR + CONSEQUENTIAL DAMAGES OF ANY CHARACTER + INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS + OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR + MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR + LOSSES ARISING OUT OF OR RELATING TO USE OF THE + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, + EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF + THE POSSIBILITY OF SUCH DAMAGES. + + + + + -- cgit v1.2.1