From: Thomas Monjalon <thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
To: siobhan.a.butler-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org,
bernard.iremonger-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org
Cc: dev-VfR2kkLFssw@public.gmane.org
Subject: [PATCH v2 0/3] split programmers guide a bit
Date: Thu, 19 Mar 2015 17:48:28 +0100 [thread overview]
Message-ID: <1426783711-2407-1-git-send-email-thomas.monjalon@6wind.com> (raw)
In-Reply-To: <1422747307-13792-1-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
Too many things are included in the programmers guide.
I think it should cover only API and knowledge needed to make an application.
That's why I suggest to move Xen and NICs doc outside.
Then it will be easier to add doc for a new environment or a new NIC.
Note that drivers or device-related libs like KNI, vhost or bonding stay
in the programmer's guide because they are more high-level than NICs drivers.
Changes in v2:
- create index for Xen guide
- rename figure links
- rebase with mlx4
- HTML copyright removal has been sent separately
Thomas Monjalon (3):
doc: fix file attributes
doc: move Xen guide out of programmers guide
doc: nics guide
MAINTAINERS | 17 +-
doc/guides/index.rst | 2 +
.../driver_vm_emul_dev.rst => nics/e1000em.rst} | 0
doc/guides/{prog_guide => nics}/img/console.png | Bin
.../{prog_guide => nics}/img/fast_pkt_proc.png | Bin
.../{prog_guide => nics}/img/forward_stats.png | Bin
.../{prog_guide => nics}/img/host_vm_comms.png | Bin
.../img/host_vm_comms_qemu.png | Bin
.../{prog_guide => nics}/img/inter_vm_comms.png | Bin
.../{prog_guide => nics}/img/perf_benchmark.png | Bin
.../{prog_guide => nics}/img/single_port_nic.png | Bin
.../{prog_guide => nics}/img/vm_vm_comms.png | Bin
.../{prog_guide => nics}/img/vmxnet3_int.png | Bin
doc/guides/{prog_guide => nics}/img/vswitch_vm.png | Bin
doc/guides/{ => nics}/index.rst | 28 ++--
.../intel_vf.rst} | 8 +-
doc/guides/nics/ixgbe.rst | 184 +++++++++++++++++++++
.../mlx4_poll_mode_drv.rst => nics/mlx4.rst} | 0
.../pcap_ring.rst} | 0
.../virtio.rst} | 4 +-
.../vmxnet3.rst} | 0
doc/guides/prog_guide/index.rst | 18 --
doc/guides/prog_guide/poll_mode_drv.rst | 152 -----------------
.../img/dpdk_xen_pkt_switch.png | Bin
doc/guides/{prog_guide => xen}/img/grant_refs.png | Bin
doc/guides/{prog_guide => xen}/img/grant_table.png | Bin
doc/guides/{ => xen}/index.rst | 21 +--
.../pkt_switch.rst} | 0
28 files changed, 228 insertions(+), 206 deletions(-)
rename doc/guides/{prog_guide/driver_vm_emul_dev.rst => nics/e1000em.rst} (100%)
rename doc/guides/{prog_guide => nics}/img/console.png (100%)
rename doc/guides/{prog_guide => nics}/img/fast_pkt_proc.png (100%)
rename doc/guides/{prog_guide => nics}/img/forward_stats.png (100%)
rename doc/guides/{prog_guide => nics}/img/host_vm_comms.png (100%)
rename doc/guides/{prog_guide => nics}/img/host_vm_comms_qemu.png (100%)
rename doc/guides/{prog_guide => nics}/img/inter_vm_comms.png (100%)
rename doc/guides/{prog_guide => nics}/img/perf_benchmark.png (100%)
rename doc/guides/{prog_guide => nics}/img/single_port_nic.png (100%)
rename doc/guides/{prog_guide => nics}/img/vm_vm_comms.png (100%)
rename doc/guides/{prog_guide => nics}/img/vmxnet3_int.png (100%)
rename doc/guides/{prog_guide => nics}/img/vswitch_vm.png (100%)
copy doc/guides/{ => nics}/index.rst (88%)
rename doc/guides/{prog_guide/i40e_ixgbe_igb_virt_func_drv.rst => nics/intel_vf.rst} (99%)
mode change 100755 => 100644
create mode 100644 doc/guides/nics/ixgbe.rst
rename doc/guides/{prog_guide/mlx4_poll_mode_drv.rst => nics/mlx4.rst} (100%)
rename doc/guides/{prog_guide/libpcap_ring_based_poll_mode_drv.rst => nics/pcap_ring.rst} (100%)
rename doc/guides/{prog_guide/poll_mode_drv_emulated_virtio_nic.rst => nics/virtio.rst} (99%)
rename doc/guides/{prog_guide/poll_mode_drv_paravirtual_vmxnets_nic.rst => nics/vmxnet3.rst} (100%)
mode change 100755 => 100644 doc/guides/prog_guide/poll_mode_drv.rst
rename doc/guides/{prog_guide => xen}/img/dpdk_xen_pkt_switch.png (100%)
rename doc/guides/{prog_guide => xen}/img/grant_refs.png (100%)
rename doc/guides/{prog_guide => xen}/img/grant_table.png (100%)
copy doc/guides/{ => xen}/index.rst (88%)
rename doc/guides/{prog_guide/intel_dpdk_xen_based_packet_switch_sol.rst => xen/pkt_switch.rst} (100%)
--
2.2.2
next prev parent reply other threads:[~2015-03-19 16:48 UTC|newest]
Thread overview: 28+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-01-31 23:35 [RFC PATCH 0/4] welcome doc for new nics and environments Thomas Monjalon
[not found] ` <1422747307-13792-1-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-01-31 23:35 ` [RFC PATCH 1/4] doc: fix file attributes Thomas Monjalon
2015-01-31 23:35 ` [RFC PATCH 2/4] doc: move Xen guide out of programmers guide Thomas Monjalon
2015-01-31 23:35 ` [RFC PATCH 3/4] doc: nics guide Thomas Monjalon
[not found] ` <1422747307-13792-4-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-02-02 14:11 ` Iremonger, Bernard
[not found] ` <8CEF83825BEC744B83065625E567D7C2049DCC0B-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-02-02 14:33 ` Thomas Monjalon
2015-02-02 14:59 ` Iremonger, Bernard
[not found] ` <8CEF83825BEC744B83065625E567D7C2049DCC4E-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-02-02 17:11 ` Thomas Monjalon
2015-02-02 17:33 ` Iremonger, Bernard
[not found] ` <8CEF83825BEC744B83065625E567D7C2049DCD83-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-02-02 17:38 ` Thomas Monjalon
2015-02-02 17:54 ` Iremonger, Bernard
2015-01-31 23:35 ` [RFC PATCH 4/4] doc: remove copyright footer Thomas Monjalon
2015-03-19 16:48 ` Thomas Monjalon [this message]
[not found] ` <1426783711-2407-1-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-03-19 16:48 ` [PATCH v2 1/3] doc: fix file attributes Thomas Monjalon
[not found] ` <1426783711-2407-2-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-03-19 18:03 ` Butler, Siobhan A
2015-03-19 16:48 ` [PATCH v2 2/3] doc: move Xen guide out of programmers guide Thomas Monjalon
[not found] ` <1426783711-2407-3-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-03-19 18:03 ` Butler, Siobhan A
2015-03-19 16:48 ` [PATCH v2 3/3] doc: nics guide Thomas Monjalon
[not found] ` <1426783711-2407-4-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
2015-03-19 17:36 ` Iremonger, Bernard
2015-03-19 18:02 ` Butler, Siobhan A
2015-03-30 23:38 ` [PATCH v2 0/3] split programmers guide a bit Thomas Monjalon
2015-03-31 11:34 ` Mcnamara, John
[not found] ` <B27915DBBA3421428155699D51E4CFE2F001CD-kPTMFJFq+rELt2AQoY/u9bfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-03-31 12:23 ` Thomas Monjalon
2015-04-01 9:19 ` Iremonger, Bernard
[not found] ` <8CEF83825BEC744B83065625E567D7C204A0B91F-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-04-01 16:36 ` Mcnamara, John
[not found] ` <B27915DBBA3421428155699D51E4CFE2F01048-kPTMFJFq+rELt2AQoY/u9bfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-04-01 17:20 ` Iremonger, Bernard
[not found] ` <8CEF83825BEC744B83065625E567D7C204A0BAB5-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
2015-04-02 7:59 ` Mcnamara, John
2015-04-02 11:04 ` [RFC] doc: refactored figure numbers into references John McNamara
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1426783711-2407-1-git-send-email-thomas.monjalon@6wind.com \
--to=thomas.monjalon-pdr9zngts4eavxtiumwx3w@public.gmane.org \
--cc=bernard.iremonger-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org \
--cc=dev-VfR2kkLFssw@public.gmane.org \
--cc=siobhan.a.butler-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.