[systemd-devel] Man page description for systemd.log_target & Co is completely lost.

[Andrei Borzenkov]

man systemd(1):

$SYSTEMD_LOG_TARGET
===================
systemd reads the log target from this environment variable. This can be
overridden with --log-target=.

--log-target=
=============
Set log target. See systemd.log_target above.

systemd.log_color, systemd.log_level=, systemd.log_location,
systemd.log_target=, systemd.log_time, systemd.log_tid
============================================================
Controls log output, with the same effect as the $SYSTEMD_LOG_COLOR,
$SYSTEMD_LOG_LEVEL, $SYSTEMD_LOG_LOCATION, $SYSTEMD_LOG_TARGET,
$SYSTEMD_LOG_TIME, and $SYSTEMD_LOG_TID environment variables described
above. systemd.log_color, systemd.log_location, systemd.log_time, and
systemd.log_tid= can be specified without an argument, with the same
effect as a positive boolean.

Oops. Déjà Vu ...

Sepulka – pl: sepulki, a prominent element of the civilization of
Ardrites from the planet of Enteropia; see "Sepulkaria"
Sepulkaria – sing: sepulkarium, establishments used for sepuling; see
"Sepuling"
Sepuling – an activity of Ardrites from the planet of Enteropia; see
"Sepulka"


Looking in history ...

commit c035f3766c7808955a7d2e42316b3f008a236fcc
Author: Zbigniew Jędrzejewski-Szmek <zbyszek at in.waw.pl>
Date:   Fri Nov 15 13:30:02 2019 +0100

    man: significantly downgrade the Options section in systemd(1)

    This structure of the man page originates from the time when systemd was
    installed on top of sysvinit systems, and users had an actual chance to
    interact with the systemd binary directly. Nowadays it is almost
never called
    directly, so let's properly explain this in the overview.

    The Options section is moved down below the kernel command line,
those options
    are only needed in special circumstances. Let's refer the reader to the
    description of the kernel command line options, and not duplicate the
    descriptions (which makes the text longer than necessary and
increases chances
    for discrepancies).

Well, I do not see any reference to "kernel command line" in description
above. There is cross reference to kernel-command-line(7) in See also
... let's try it.


systemd.unit=, rd.systemd.unit=, systemd.dump_core,
systemd.early_core_pattern=, systemd.crash_chvt, systemd.crash_shell,
systemd.crash_reboot, systemd.confirm_spawn, systemd.service_watchdogs,
systemd.show_status, systemd.status_unit_format=, systemd.log_target=,
systemd.log_level=, systemd.log_location=, systemd.log_color,
systemd.default_standard_output=, systemd.default_standard_error=,
systemd.setenv=, systemd.machine_id=, systemd.unified_cgroup_hierarchy,
systemd.legacy_systemd_cgroup_controller
=====================================================================
Parameters understood by the system and service manager to control
system behavior. For details, see systemd(1).

We are back to square one.