mirrors/systemd
0
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2024-12-01 06:13:38 +08:00
Code Issues Packages Projects Releases Wiki Activity
539bcc831b
systemd/man/systemd-vconsole-setup.service.xml

64 lines
2.9 KiB
XML
Raw Normal View History

man: document systemd-vconsole-setup.service
2012-06-25 18:00:43 +08:00
<?xml version="1.0"?>
<!--*-nxml-*-->
man: use same header for all files The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
2019-03-14 21:40:58 +08:00
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
man: standarize on one-line license header No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
2019-03-14 21:29:37 +08:00
<!-- SPDX-License-Identifier: LGPL-2.1+ -->
build-sys: create Makefile-man.am automatically man rules were repeating the same information in too many places, which was error prone. Those rules can be easily generated from .xml files. For efficiency and because python is not a required dependency, Makefile-man.am is only regenerated when requested with make update-man-list If no metadata in man/*.xml changed, this file should not change. So only when a new man page or a new alias is added, this file should show up in 'git diff'. The change should then be committed. If the support for building from git without python was dropped, we could drop Makefile-man.am from version control. This would also increase the partial build time (since more stuff would be rebuild whenever sources in man/*.xml would be modified), so it would probably wouldn't be worth it.
2013-02-03 11:47:47 +08:00
<refentry id="systemd-vconsole-setup.service" conditional='ENABLE_VCONSOLE'>
man: document systemd-vconsole-setup.service
2012-06-25 18:00:43 +08:00
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
<refentryinfo>
<title>systemd-vconsole-setup.service</title>
<productname>systemd</productname>
</refentryinfo>
<refmeta>
<refentrytitle>systemd-vconsole-setup.service</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv>
<refname>systemd-vconsole-setup.service</refname>
<refname>systemd-vconsole-setup</refname>
vconsole: manual update (#4021) To more correctly reflect current behaviour as well as to provide a few more details.
2016-10-27 07:21:02 +08:00
<refpurpose>Configure the virtual consoles</refpurpose>
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
</refnamediv>
<refsynopsisdiv>
<para><filename>systemd-vconsole-setup.service</filename></para>
vconsole: manual update (#4021) To more correctly reflect current behaviour as well as to provide a few more details.
2016-10-27 07:21:02 +08:00
<cmdsynopsis>
<command>/usr/lib/systemd/systemd-vconsole-setup</command>
<arg choice="opt">TTY</arg>
</cmdsynopsis>
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
</refsynopsisdiv>
<refsect1>
<title>Description</title>
man: rework systemd-vconsole-setup man page a bit (#7312) It's not systemd that invokes the service internally as needed, it's systemd-localed. Correct that. Also, stop using the word "helper". To me a "helper" constitutes something internal, not official API. I doubt systemd-vconsole-setup really matches that description though, hence let's better avoid the term. Also, clean up some other wording, and be less imbiguous, by suggesting a single command to apply vconsole.conf instead of two. Follow-up for 597c25d2a7c61453acd723340350e8748a5106dd
2017-11-14 02:14:19 +08:00
<para><filename>systemd-vconsole-setup</filename> sets up and configures either all virtual consoles, or — if the
optional <replaceable>TTY</replaceable> parameter is provided — a specific one. When the system is booting up it's
called by <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry> during
VT console subsystem initialization. Also,
<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> invokes
it as needed when language or console changes are made. Internally, this program calls <citerefentry
project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry> and <citerefentry
project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
vconsole: manual update (#4021) To more correctly reflect current behaviour as well as to provide a few more details.
2016-10-27 07:21:02 +08:00
</para>
man: rework systemd-vconsole-setup man page a bit (#7312) It's not systemd that invokes the service internally as needed, it's systemd-localed. Correct that. Also, stop using the word "helper". To me a "helper" constitutes something internal, not official API. I doubt systemd-vconsole-setup really matches that description though, hence let's better avoid the term. Also, clean up some other wording, and be less imbiguous, by suggesting a single command to apply vconsole.conf instead of two. Follow-up for 597c25d2a7c61453acd723340350e8748a5106dd
2017-11-14 02:14:19 +08:00
<para>Execute <command>systemctl restart systemd-vconsole-setup.service</command> in order to apply any manual
changes made to <filename>/etc/vconsole.conf</filename>.</para>
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
man: rework systemd-vconsole-setup man page a bit (#7312) It's not systemd that invokes the service internally as needed, it's systemd-localed. Correct that. Also, stop using the word "helper". To me a "helper" constitutes something internal, not official API. I doubt systemd-vconsole-setup really matches that description though, hence let's better avoid the term. Also, clean up some other wording, and be less imbiguous, by suggesting a single command to apply vconsole.conf instead of two. Follow-up for 597c25d2a7c61453acd723340350e8748a5106dd
2017-11-14 02:14:19 +08:00
<para>See <citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
information about the configuration files and kernel command line options understood by this program.</para>
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
man: fix a bunch of links All hail linkchecker!
2015-03-14 10:22:39 +08:00
<citerefentry project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
Reindent man pages to 2ch
2015-02-04 10:14:13 +08:00
<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>
</refsect1>
man: document systemd-vconsole-setup.service
2012-06-25 18:00:43 +08:00
</refentry>
Reference in New Issue Copy Permalink