From 48847676ca94159f9ce4936a1353ae0f5f9683f9 Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Tue, 26 Jun 2018 01:43:33 +0900
Subject: [PATCH] man: add comments about MTUBytes= and MACAddress= for tuntap
 devices

Closes #9407.
---
 man/systemd.netdev.xml | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml
index 50732586413..7faa38d502e 100644
--- a/man/systemd.netdev.xml
+++ b/man/systemd.netdev.xml
@@ -266,12 +266,13 @@
         <varlistentry>
           <term><varname>MTUBytes=</varname></term>
           <listitem>
-            <para>The maximum transmission unit in bytes to set for
-            the device. The usual suffixes K, M, G, are supported and
-            are understood to the base of 1024. This key is not
-            currently supported for <literal>tun</literal> or
-            <literal>tap</literal> devices.
-            </para>
+            <para>The maximum transmission unit in bytes to set for the device. The usual suffixes K, M, G,
+            are supported and are understood to the base of 1024. For <literal>tun</literal> or
+            <literal>tap</literal> devices, <varname>MTUBytes=</varname> setting is not currently supported in
+            <literal>[NetDev]</literal> section. Please specify it in <literal>[Link]</literal> section of
+            corresponding
+            <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+            files.</para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -281,9 +282,11 @@
             given, one is generated based on the interface name and
             the
             <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
-            This key is not currently supported for
-            <literal>tun</literal> or <literal>tap</literal> devices.
-            </para>
+            For <literal>tun</literal> or <literal>tap</literal> devices, <varname>MACAddress=</varname> setting
+            is not currently supported in <literal>[NetDev]</literal> section. Please specify it in
+            <literal>[Link]</literal> section of corresponding
+            <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+            files.</para>
           </listitem>
         </varlistentry>
       </variablelist>
@@ -1342,7 +1345,7 @@
   </refsect1>
 
   <refsect1>
-    <title>Example</title>
+    <title>Examples</title>
     <example>
       <title>/etc/systemd/network/25-bridge.netdev</title>
 
-- 
2.47.3