qemu-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Qemu-commits] [qemu/qemu] abbbb0: qemu-doc: Rework the network options


From: GitHub
Subject: [Qemu-commits] [qemu/qemu] abbbb0: qemu-doc: Rework the network options chapter to ma...
Date: Sat, 31 Mar 2018 01:40:20 -0700

  Branch: refs/heads/master
  Home:   https://github.com/qemu/qemu
  Commit: abbbb0350d780e24d2f6a0cf8fc3191badb0329a
      
https://github.com/qemu/qemu/commit/abbbb0350d780e24d2f6a0cf8fc3191badb0329a
  Author: Thomas Huth <address@hidden>
  Date:   2018-03-30 (Fri, 30 Mar 2018)

  Changed paths:
    M qemu-options.hx

  Log Message:
  -----------
  qemu-doc: Rework the network options chapter to make "-net" less prominent

"-net" is clearly a legacy option. Yet we still use it in almost all
examples in the qemu documentation, and many other spots in the network
chapter. We should make it less prominent that users are not lured into
using it so often anymore. So instead of starting the network chapter with
"-net nic" and documenting "-net <backend>" below "-netdev <backend>"
everywhere, all the "-net" related documentation is now moved to the end
of the chapter. The new "-nic" option is moved to the beginning of the
chapter instead, with a new example that should demonstrate how "-nic"
can be used to shortcut "-device" with "-netdev". The examples in this
chapter are changed to use the "-device" and "-netdev" options or
"-nic" instead of "-net nic -net <backend>".

While we're at it, also remove a legacy remark about very old Linux
distributions. Also remove the "[...]" from the examples in this chapter
since we are not using this ellipsis in any other examples in our docu-
mentation.

Signed-off-by: Thomas Huth <address@hidden>
Signed-off-by: Jason Wang <address@hidden>


  Commit: b60d667d3d0a9733a42552345b8c37587354f3cd
      
https://github.com/qemu/qemu/commit/b60d667d3d0a9733a42552345b8c37587354f3cd
  Author: Peter Maydell <address@hidden>
  Date:   2018-03-31 (Sat, 31 Mar 2018)

  Changed paths:
    M qemu-options.hx

  Log Message:
  -----------
  Merge remote-tracking branch 'remotes/jasowang/tags/net-pull-request' into 
staging

# gpg: Signature made Fri 30 Mar 2018 04:49:42 BST
# gpg:                using RSA key EF04965B398D6211
# gpg: Good signature from "Jason Wang (Jason Wang on RedHat) <address@hidden>"
# gpg: WARNING: This key is not certified with sufficiently trusted signatures!
# gpg:          It is not certain that the signature belongs to the owner.
# Primary key fingerprint: 215D 46F4 8246 689E C77F  3562 EF04 965B 398D 6211

* remotes/jasowang/tags/net-pull-request:
  qemu-doc: Rework the network options chapter to make "-net" less prominent

Signed-off-by: Peter Maydell <address@hidden>


Compare: https://github.com/qemu/qemu/compare/eae3aace85ea...b60d667d3d0a

reply via email to

[Prev in Thread] Current Thread [Next in Thread]