``group`` section
=================

Groups collect processes, states, and other groups for display and control in
ln_manager.

syntax::

  GROUP_SECTION := "group " + GROUP_NAME + "\n" + GROUP_SETTING*

example:

.. code-block:: lnc

  group monitoring
  add members: logger, watcher_*, !watcher_old
  add flags: show_opened

Member selection
----------------

Groups are populated through the ``members`` list.

Useful forms are:

* exact names such as ``logger``
* glob-style patterns such as ``watcher_*``
* exclusions prefixed with ``!``, such as ``!watcher_old``

The parser matches member patterns against configured process, state, and group
names.

Behavior details:

* matching group names adds those groups as nested group members
* recursive group linkage is prevented automatically
* if a member pattern matches nothing, config loading fails by default
* the ``allow_empty`` flag disables that error and allows unmatched patterns

Flags
-----

Relevant group flags are:

``allow_empty``
  allow member patterns that currently match nothing

``show_opened``
  show the group expanded by default in the GUI

``show_closed``
  show the group collapsed by default in the GUI

``sorted``
  sort members by name

``unsorted``
  preserve the original member order

Defaults
--------

If no explicit open/sort flag is set, group behavior falls back to the
instance-wide defaults from :doc:`config_instance`:

* ``groups_opened_default``
* ``groups_sorted_default``