Mercurial > libervia-backend
diff doc/libervia-cli/pubsub.rst @ 3573:813595f88612
merge changes from main branch
author | Goffi <goffi@goffi.org> |
---|---|
date | Thu, 17 Jun 2021 13:05:58 +0200 |
parents | 267e4987b58b |
children | 7c4fcef5b561 7acf19bdca2f |
line wrap: on
line diff
--- a/doc/libervia-cli/pubsub.rst Thu Jun 03 15:21:43 2021 +0200 +++ b/doc/libervia-cli/pubsub.rst Thu Jun 17 13:05:58 2021 +0200 @@ -45,6 +45,8 @@ $ li pubsub get -n notes -m 5 +.. _li_pubsub_delete: + delete ====== @@ -77,6 +79,25 @@ $ li pubsub edit -n notes -L +.. _li-pubsub_rename: + +rename +====== + +Move a item to a new ID. As there is currently no "rename" or "move" operation in XMPP +PubSub, this is done by republishing the item with the new ID, then deleting the old item +if the publication succeed. + +This is notably useful when user friendly URL based on ID are used, and one need to fix a +typo or something else. + +example +------- + +Rename a PubSub item with ID ``123`` to ``456``:: + + $ li pubsub rename -n some_node -i 123 456 + subscribe ========= @@ -292,7 +313,7 @@ If you have to modify the ``publisher`` of an item, you need specific privileges. The ``--admin`` allows you do to that, but it must be supported by your PubSub service -(currently only ``SàT PubSub`` supports this non standard feature). +(currently only ``Libervia PubSub`` supports this non standard feature). To modify all items of a node, use the ``-A, --all`` option. This will use `RSM`_ repetitively until all items are treated. Of course that means that your PubSub service