sjs/vdirsyncer
1
0
Fork 0
mirror of https://github.com/samsonjs/vdirsyncer.git synced 2026-04-27 14:57:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Remove requirement of filenames being UIDs (#672)

Browse source
This commit is contained in:
Markus Unterwaditzer 2017-09-23 13:58:03 +02:00 committed by GitHub
parent 9314a93d67
commit 8495d87196
1 changed files with 5 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
docs/vdir.rst
View file

@ -30,12 +30,11 @@ also implies only one ``VEVENT``/``VTODO``/``VCARD`` component per file, but
e.g. recurrence exceptions would require multiple ``VEVENT`` components per e.g. recurrence exceptions would require multiple ``VEVENT`` components per
event. event.
The filename *should* consist of the ``ident``, followed by the file extension. The filename should have similar properties as the ``UID`` of the file content.
The ``ident`` is either the ``UID``, if the item has one, else a string with However, there is no requirement for these two to be the same. Programs may
similar properties as the ``UID``. However, several restrictions of the choose to store additional metadata in that filename, however, at the same time
underlying filesystem might make an implementation of this naming scheme for they *must not* assume that the metadata they included will be preserved by
items' filenames impossible. The approach to deal with such cases is left to other programs.
the client, which are free to choose a different scheme for filenames instead.
.. _vCard: https://tools.ietf.org/html/rfc6350 .. _vCard: https://tools.ietf.org/html/rfc6350
.. _iCalendar: https://tools.ietf.org/html/rfc5545 .. _iCalendar: https://tools.ietf.org/html/rfc5545