[systemd-devel] [PATCH] systemctl: clarify usage of "--all" versus list-unit-files

[Lennart Poettering]

On Wed, 10.04.13 12:34, harald at redhat.com (harald at redhat.com) wrote:

> From: Harald Hoyer <harald at redhat.com>
> 
> Novice users might think, that
>  $ systemctl --all
> is equal to
>  $ systemctl list-unit-files

Note that "systemctl" will already clarify this this in the quick
summary it shows at the end of the list.

> -          <para>When listing units, show all units, regardless of
> +          <para>When listing units, show all internally loaded units, regardless of
>            their state, including inactive units. When showing
>            unit/job/manager properties, show all properties regardless
>            whether they are set or not.</para>
> +          <para>To list all units installed on disk, use the command
> +          <command>list-unit-files</command> instead.</para>

I just did a minor modification to the text in git: I dropped the
"internally", since I wouldn't know what this is supposed to mean, and
we shouldn't introduce new terminology here we use nowhere else.

Lennart

-- 
Lennart Poettering - Red Hat, Inc.