--- a/doc/libervia-cli/event.rst	Thu Sep 22 00:01:48 2022 +0200
+++ b/doc/libervia-cli/event.rst	Thu Sep 22 12:01:44 2022 +0200
@@ -5,74 +5,70 @@
 Event commands allows you to create/modify or get data about an event, and to manage your
 invitees.
 
-list
-====
+get
+===
 
-List events available on a service
+Get metadata about one or more event(s).
+
+By default the events are displayed in a format readable, and ``--verbose, -v`` can be
+used one or more times to show more or less data. As usual, :ref:`libervia-cli_output` can
+be used to get the data in a different way.
 
 example
 -------
 
-Retrieve events of profile::
-
-  $ li event list
+Retrieve events from personal agenda::
 
-.. _libervia-cli_event_get:
-
-get
-===
+  $ li event get
 
-Get metadata about a specific event.
+Get details of a next dentist appointment from personal agenda::
 
-example
--------
-
-Retrieve an event metadata::
-
-  $ li event get  -n org.salut-a-toi.event:0__BsyCsXpcrRh44CQhSVTUMi -i 'org.salut-a-toi.event:0'
+  $ li event get -i dentist -vv
 
 .. _libervia-cli_event_create:
 
 create
 ======
 
-Create a new event. You can specify the date of the event with ``-d DATE, --date DATE``,
-and an id with ``-i ID, --id ID`` (default id is used if omitted).
-
-Configuration options are specified using ``-f KEY VALUE, --field KEY VALUE`` where key
-can be a custom data or one of:
+Create a new event. You can specify the starting time of the event with ``-S TIME_PATTERN, --start TIME_PATTERN``, and either its end time with ``-E TIME_PATTERN, --end TIME_PATTERN`` or its duration with ``-D DURATION, --duration DURATION``. ``--start`` and ``--end`` use a full :ref:`time_pattern` when ``--duration`` uses the relative delta part of it. It's mandatory when creating and event to specify starting and ending time (or duration).
 
-name
-  name of the event
-description
-  details of the event
-image
-  URL of the main picture of the event
-background-image
-  URL of image to use as background
-register
-  a boolean value, set to ``true`` if you want to register the event in your local list
+If your organsise an item, the ``--rsvp`` flag should be used: it will use the default
+RSVP form which ask for attendance. If you want to request more information to your guest,
+``--rsvp_json JSON`` can be used: the JSON argument is a data dict as described in
+``dataDict2dataForm`` function where the ``namespace`` key is not necessary (it's set
+automatically):
+
+.. autofunction:: sat.tools.xml_tools.dataDict2dataForm
+
+If the event links to an other one, ``--external JID NODE ITEM`` can be user
 
 example
 -------
 
 Create an event about to celebrate New Year::
 
-  $ li event create -d 2019-12-31 -f name "New Year's Eve" -f description "Party to celebrate new year" -f register true -f image https://example.net/some_image.jpg
+  $ li event create -s some_pubsub@example.net -n urn:xmpp:events:0/party -i new_year_eve_2022 --start 2022-12-31 --end 2023-01-01 -d "Party to celebrate new year" -H https://example.net/some_image.jpg "New Year's Eve"
+
+Add the dentist appointement on coming Tuesday to our personal agenda::
+
+  $ li event create -S tuesday -D "1 hour" Dentist
 
 
 modify
 ======
 
-This command in the same way as libervia-cli_event_create_ but modify an existing event. You need to
-specify the node of the event to modify using ``-n NODE, --node NODE``.
+This command works in the same way as libervia-cli_event_create_ but modify an existing
+event: all arguments are optional, those specified will override the original ones from
+the updated event.
+
+If the ending time or duration must be modified, the starting must be specified again.
 
 example
 -------
 
-Add a background image to the New Year event created above::
+Change the head picture from the New Year event created above::
 
-  $ li event modify -n org.salut-a-toi.event:0__d8QQLJvbcpDXxK66UBXKfT -f background-image https://example.net/some_background_image.jpg
+  $ li event modify -s some_pubsub@example.net -n urn:xmpp:events:0/party -i new_year_eve_2022 -H https://example.net/some_other_image.jpg
 
 
 invitee