~ubuntu-branches/ubuntu/utopic/eiciel/utopic

« back to all changes in this revision

Viewing changes to doc/C/xattr.page

  • Committer: Package Import Robot
  • Author(s): Michael Biebl
  • Date: 2014-08-20 15:02:46 UTC
  • mfrom: (11.1.4 sid)
  • Revision ID: package-import@ubuntu.com-20140820150246-ngv7lwsuk498knpk
Tags: 0.9.9-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<page xmlns="http://projectmallard.org/1.0/"
 
2
        type="guide"
 
3
        id="xattr">
 
4
<info>
 
5
    <link type="guide" xref="index"/>
 
6
    <link type="seealso" xref="concepts"/>
 
7
    <desc>
 
8
    Extended user attributes allow to associate named strings to a file.
 
9
    </desc>
 
10
</info>
 
11
 
 
12
<title>Editing extended user attributes</title>
 
13
<p>
 
14
Extended user attributes are pairs of attributes and values that can be stored arbitrarily in files.
 
15
For instance one could store the last Revision of a file or a brief Description.
 
16
Eiciel allows to work with extended user attributes both in standalone application and Nautilus property
 
17
page.
 
18
</p>
 
19
 
 
20
<figure>
 
21
        <title>Extended user attributes</title>
 
22
    <media type="image" src="figures/screen_xattr.png"/>
 
23
</figure>
 
24
 
 
25
<section id="add-xattr">
 
26
<title>Adding an attribute</title>
 
27
<p>
 
28
You can add an attribute with <gui>Add</gui>. A default attribute name and value will be created.
 
29
You can edit them by clicking on the attribute list.
 
30
</p>
 
31
 
 
32
 
 
33
<note style="warning">
 
34
<p>
 
35
Even if extended user attributes are <em>encoding neutral</em> all the data
 
36
that can be introduced in Eiciel will be saved in UTF-8 charset. Remind this if you intend
 
37
to manage these attributes with another application which might not be UTF-8 capable.
 
38
Eiciel might not be useful if you store binary (non printable) data in your user
 
39
attribute values.
 
40
</p>
 
41
</note>
 
42
 
 
43
</section>
 
44
 
 
45
<section id="remove-xattr">
 
46
<title>Removing an attribute</title>
 
47
<p>
 
48
To remove an attribute, select it from the list and press <gui>Remove</gui>.
 
49
</p>
 
50
 
 
51
</section>
 
52
</page>