diff --git a/doc/guide.html b/doc/guide.html index 30869296d..2ade11ecc 100644 --- a/doc/guide.html +++ b/doc/guide.html @@ -2756,13 +2756,24 @@ is replaced at start time with the real virtual host name.
{access_createnode, AccessName}
This option restricts which users are allowed to create pubsub nodes using ACL and ACCESS. The default value is pubsub_createnode.
{plugins, [ Plugin, ...]}
-To specify which pubsub node plugins to use. If not defined, the default -pubsub plugin is always used. -
{nodetree, Name}
-To specify which nodetree to use. If not defined, the default pubsub -nodetree is used. Only one nodetree can be used per host, -and is shared by all node plugins. -
{pep_sendlast_offline, false|true}
+To specify which pubsub node plugins to use. +If not defined, the default pubsub plugin is always used: "flat". +
{nodetree, Nodetree}
+To specify which nodetree to use. +If not defined, the default pubsub nodetree is used: "tree". +Only one nodetree can be used per host, and is shared by all node plugins.

The "virtual" nodetree does not store nodes on database. +This saves resources on systems with tons of nodes. +If using the "virtual" nodetree, +you can only enable those node plugins: +["flat","pep"] or ["flat"]; +any other plugins configuration will not work. +Also, all nodes will have the defaut configuration, +and this can not be changed. +Using "virtual" nodetree requires to start from a clean database, +it will not work if you used the default "tree" nodetree before.

The "dag" nodetree provides experimental support for PubSub Collection Nodes (XEP-0248). +In that case you should also add "dag" node plugin as default, for example: +{plugins, ["dag","flat","hometree","pep"]} +

{pep_sendlast_offline, false|true}
To specify whether or not we should get last published PEP items from users in our roster which are offline when we connect. Value is true or false. If not defined, pubsub assumes false so we only get last items of online contacts. diff --git a/doc/guide.tex b/doc/guide.tex index 024f11b72..32081dad9 100644 --- a/doc/guide.tex +++ b/doc/guide.tex @@ -3531,12 +3531,27 @@ Options: This option restricts which users are allowed to create pubsub nodes using ACL and ACCESS. The default value is \term{pubsub\_createnode}. % Not clear enough + do not use abbreviations. \titem{\{plugins, [ Plugin, ...]\}} \ind{options!plugins} - To specify which pubsub node plugins to use. If not defined, the default - pubsub plugin is always used. -\titem{\{nodetree, Name\}} \ind{options!nodetree} - To specify which nodetree to use. If not defined, the default pubsub - nodetree is used. Only one nodetree can be used per host, - and is shared by all node plugins. + To specify which pubsub node plugins to use. + If not defined, the default pubsub plugin is always used: "flat". +\titem{\{nodetree, Nodetree\}} \ind{options!nodetree} + To specify which nodetree to use. + If not defined, the default pubsub nodetree is used: "tree". + Only one nodetree can be used per host, and is shared by all node plugins. + + The "virtual" nodetree does not store nodes on database. + This saves resources on systems with tons of nodes. + If using the "virtual" nodetree, + you can only enable those node plugins: + ["flat","pep"] or ["flat"]; + any other plugins configuration will not work. + Also, all nodes will have the defaut configuration, + and this can not be changed. + Using "virtual" nodetree requires to start from a clean database, + it will not work if you used the default "tree" nodetree before. + + The "dag" nodetree provides experimental support for PubSub Collection Nodes (\xepref{0248}). + In that case you should also add "dag" node plugin as default, for example: + \term{\{plugins, ["dag","flat","hometree","pep"]\}} \titem{\{pep\_sendlast\_offline, false|true\}} \ind{options!pep\_sendlast\_offline} To specify whether or not we should get last published PEP items from users in our roster which are offline when we connect. Value is true or false.