aboutsummaryrefslogtreecommitdiff
path: root/doc/ref/vcomponent/data-formats.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ref/vcomponent/data-formats.texi')
-rw-r--r--doc/ref/vcomponent/data-formats.texi27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/ref/vcomponent/data-formats.texi b/doc/ref/vcomponent/data-formats.texi
new file mode 100644
index 00000000..a871ea1a
--- /dev/null
+++ b/doc/ref/vcomponent/data-formats.texi
@@ -0,0 +1,27 @@
+@node Data Formats
+@section Data Formats
+
+Data formats are the serialization formats for components.
+The primary serialization format is iCalendar, but xCalendar and
+sxCalendar also exists.
+
+Each available format should be included as
+@code{(vcomponent formats @var{format-name})}.
+Which module corresponds to what file type is currently defined out of
+band.
+
+Each module should expose the following procedures.
+
+@defun serialize component port
+Write a serialized representation of @var{component} to @var{port}.
+@end defun
+
+@defun deserialize port
+Read a serialized representation of a component from @var{port}, and
+return the deserialized instance of this object.
+@end defun
+
+@subsection iCalendar
+RFC 5545
+
+@subsection xCal