DPDK patches and discussions
 help / color / mirror / Atom feed
From: Ciara Power <ciara.power@intel.com>
To: dev@dpdk.org
Cc: bruce.richardson@intel.com, thomas@monjalon.net,
	Ciara Power <ciara.power@intel.com>
Subject: [dpdk-dev] [PATCH 20.11 16/19] doc: remove references to make in prog guides
Date: Fri,  7 Aug 2020 13:30:06 +0100	[thread overview]
Message-ID: <20200807123009.21266-17-ciara.power@intel.com> (raw)
In-Reply-To: <20200807123009.21266-1-ciara.power@intel.com>

Make is no longer supported for compiling DPDK, references are now
removed in the documentation.

Signed-off-by: Ciara Power <ciara.power@intel.com>
---
 doc/guides/prog_guide/build_app.rst           |  46 +---
 .../prog_guide/dev_kit_build_system.rst       | 218 +-----------------
 .../prog_guide/dev_kit_root_make_help.rst     | 188 ---------------
 .../prog_guide/env_abstraction_layer.rst      |  17 +-
 .../prog_guide/ext_app_lib_make_help.rst      |  25 +-
 doc/guides/prog_guide/graph_lib.rst           |   6 +-
 doc/guides/prog_guide/intro.rst               |   2 +-
 .../prog_guide/ip_fragment_reassembly_lib.rst |   5 -
 .../link_bonding_poll_mode_drv_lib.rst        |   5 -
 doc/guides/prog_guide/lto.rst                 |  13 +-
 doc/guides/prog_guide/mbuf_lib.rst            |   4 +-
 doc/guides/prog_guide/mempool_lib.rst         |   7 +-
 doc/guides/prog_guide/overview.rst            |  12 +-
 doc/guides/prog_guide/profile_app.rst         |  15 +-
 doc/guides/prog_guide/qos_framework.rst       |  10 +-
 doc/guides/prog_guide/rcu_lib.rst             |   7 +-
 doc/guides/prog_guide/source_org.rst          |  23 +-
 doc/guides/prog_guide/trace_lib.rst           |   3 +-
 .../prog_guide/writing_efficient_code.rst     |   3 +-
 19 files changed, 36 insertions(+), 573 deletions(-)
 delete mode 100644 doc/guides/prog_guide/dev_kit_root_make_help.rst

diff --git a/doc/guides/prog_guide/build_app.rst b/doc/guides/prog_guide/build_app.rst
index bffa55bbef..54e4283752 100644
--- a/doc/guides/prog_guide/build_app.rst
+++ b/doc/guides/prog_guide/build_app.rst
@@ -9,14 +9,11 @@ Building Your Own Application
 Compiling a Sample Application in the Development Kit Directory
 ---------------------------------------------------------------
 
-When compiling a sample application (for example, hello world), the following variables must be exported:
-RTE_SDK and RTE_TARGET.
+To compile a sample application (for example, hello world):
 
 .. code-block:: console
 
     ~/DPDK$ cd examples/helloworld/
-    ~/DPDK/examples/helloworld$ export RTE_SDK=/home/user/DPDK
-    ~/DPDK/examples/helloworld$ export RTE_TARGET=x86_64-native-linux-gcc
     ~/DPDK/examples/helloworld$ make
         CC main.o
         LD helloworld
@@ -39,8 +36,6 @@ The sample application (Hello World) can be duplicated in a new directory as a s
 
     ~$ cp -r DPDK/examples/helloworld my_rte_app
     ~$ cd my_rte_app/
-    ~/my_rte_app$ export RTE_SDK=/home/user/DPDK
-    ~/my_rte_app$ export RTE_TARGET=x86_64-native-linux-gcc
     ~/my_rte_app$ make
         CC main.o
         LD helloworld
@@ -53,47 +48,10 @@ Customizing Makefiles
 Application Makefile
 ~~~~~~~~~~~~~~~~~~~~
 
-The default makefile provided with the Hello World sample application is a good starting point. It includes:
-
-*   $(RTE_SDK)/mk/rte.vars.mk at the beginning
-
-*   $(RTE_SDK)/mk/rte.extapp.mk at the end
+The default makefile provided with the Hello World sample application is a good starting point.
 
 The user must define several variables:
 
 *   APP: Contains the name of the application.
 
 *   SRCS-y: List of source files (\*.c, \*.S).
-
-Library Makefile
-~~~~~~~~~~~~~~~~
-
-It is also possible to build a library in the same way:
-
-*   Include $(RTE_SDK)/mk/rte.vars.mk at the beginning.
-
-*   Include $(RTE_SDK)/mk/rte.extlib.mk  at the end.
-
-The only difference is that APP should be replaced by LIB, which contains the name of the library. For example, libfoo.a.
-
-Customize Makefile Actions
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Some variables can be defined to customize Makefile actions. The most common are listed below. Refer to
-:ref:`Makefile Description <Makefile_Description>` section in
-:ref:`Development Kit Build System <Development_Kit_Build_System>`
-
-chapter for details.
-
-*   VPATH: The path list where the build system will search for sources. By default,
-    RTE_SRCDIR will be included in VPATH.
-
-*   CFLAGS_my_file.o: The specific flags to add for C compilation of my_file.c.
-
-*   CFLAGS: The flags to use for C compilation.
-
-*   LDFLAGS: The flags to use for linking.
-
-*   CPPFLAGS: The flags to use to provide flags to the C preprocessor (only useful when assembling .S files)
-
-*   LDLIBS: A list of libraries to link with (for example, -L /path/to/libfoo - lfoo)
diff --git a/doc/guides/prog_guide/dev_kit_build_system.rst b/doc/guides/prog_guide/dev_kit_build_system.rst
index 74dba4dd16..91d2120e22 100644
--- a/doc/guides/prog_guide/dev_kit_build_system.rst
+++ b/doc/guides/prog_guide/dev_kit_build_system.rst
@@ -31,51 +31,17 @@ Each build directory contains include files, libraries, and applications.
 A build directory is specific to a configuration that includes architecture + execution environment + toolchain.
 It is possible to have several build directories sharing the same sources with different configurations.
 
-For instance, to create a new build directory called my_sdk_build_dir using the default configuration template config/defconfig_x86_64-linux,
-we use:
-
-.. code-block:: console
-
-    cd ${RTE_SDK}
-    make config T=x86_64-native-linux-gcc O=my_sdk_build_dir
-
-This creates a new my_sdk_build_dir directory. After that, we can compile by doing:
-
-.. code-block:: console
-
-    cd my_sdk_build_dir
-    make
-
-which is equivalent to:
-
-.. code-block:: console
-
-    make O=my_sdk_build_dir
-
-Refer to
-:ref:`Development Kit Root Makefile Help <Development_Kit_Root_Makefile_Help>`
-for details about make commands that can be used from the root of DPDK.
 
 Building External Applications
 ------------------------------
 
 Since DPDK is in essence a development kit, the first objective of end users will be to create an application using this SDK.
-To compile an application, the user must set the RTE_SDK and RTE_TARGET environment variables.
-
-.. code-block:: console
 
-    export RTE_SDK=/opt/DPDK
-    export RTE_TARGET=x86_64-native-linux-gcc
-    cd /path/to/my_app
-
-For a new application, the user must create their own Makefile that includes some .mk files, such as
-${RTE_SDK}/mk/rte.vars.mk, and ${RTE_SDK}/mk/ rte.app.mk.
-This is described in
+For a new application, the user must create their own Makefile. This is described in
 :ref:`Building Your Own Application <Building_Your_Own_Application>`.
 
-Depending on the chosen target (architecture, machine, executive environment, toolchain) defined in the Makefile or as an environment variable,
-the applications and libraries will compile using the appropriate .h files and will link with the appropriate .a files.
-These files are located in ${RTE_SDK}/arch-machine-execenv-toolchain, which is referenced internally by ${RTE_BIN_SDK}.
+Depending on the chosen target (architecture, machine, executive environment, toolchain) defined, the applications and
+libraries will compile using the appropriate .h files and will link with the appropriate .a files.
 
 To compile their application, the user just has to call make.
 The compilation result will be located in /path/to/my_app/build directory.
@@ -90,92 +56,18 @@ Makefile Description
 General Rules For DPDK Makefiles
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In the DPDK, Makefiles always follow the same scheme:
-
-#. Include $(RTE_SDK)/mk/rte.vars.mk at the beginning.
-
-#. Define specific variables for RTE build system.
-
-#. Include a specific $(RTE_SDK)/mk/rte.XYZ.mk, where XYZ can be app, lib, extapp, extlib, obj, gnuconfigure,
-   and so on, depending on what kind of object you want to build.
-   :ref:`See Makefile Types <Makefile_Types>` below.
-
-#. Include user-defined rules and variables.
+In the DPDK, Makefiles always define specific variables for RTE build system.
 
    The following is a very simple example of an external application Makefile:
 
    ..  code-block:: make
 
-        include $(RTE_SDK)/mk/rte.vars.mk
-
         # binary name
         APP = helloworld
 
         # all source are stored in SRCS-y
         SRCS-y := main.c
 
-        CFLAGS += -O3
-        CFLAGS += $(WERROR_FLAGS)
-
-        include $(RTE_SDK)/mk/rte.extapp.mk
-
-.. _Makefile_Types:
-
-Makefile Types
-~~~~~~~~~~~~~~
-
-Depending on the .mk file which is included at the end of the user Makefile, the Makefile will have a different role.
-Note that it is not possible to build a library and an application in the same Makefile.
-For that, the user must create two separate Makefiles, possibly in two different directories.
-
-In any case, the rte.vars.mk file must be included in the user Makefile as soon as possible.
-
-Application
-^^^^^^^^^^^
-
-These Makefiles generate a binary application.
-
-*   rte.app.mk: Application in the development kit framework
-
-*   rte.extapp.mk: External application
-
-*   rte.hostapp.mk: prerequisite tool to build dpdk
-
-Library
-^^^^^^^
-
-Generate a .a library.
-
-*   rte.lib.mk: Library in the development kit framework
-
-*   rte.extlib.mk: external library
-
-*   rte.hostlib.mk: host library in the development kit framework
-
-Install
-^^^^^^^
-
-*   rte.install.mk: Does not build anything, it is only used to create links or copy files to the installation directory.
-    This is useful for including files in the development kit framework.
-
-Kernel Module
-^^^^^^^^^^^^^
-
-*   rte.module.mk: Build a kernel module in the development kit framework.
-
-Objects
-^^^^^^^
-
-*   rte.obj.mk: Object aggregation (merge several .o in one) in the development kit framework.
-
-*   rte.extobj.mk: Object aggregation (merge several .o in one) outside the development kit framework.
-
-Misc
-^^^^
-
-*   rte.gnuconfigure.mk: Build an application that is configure-based.
-
-*   rte.subdir.mk: Build several directories in the development kit framework.
 
 .. _Internally_Generated_Build_Tools:
 
@@ -220,112 +112,10 @@ hardware support of a given library or application.
 Useful Variables Provided by the Build System
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-*   RTE_SDK: The absolute path to the DPDK sources.
-    When compiling the development kit, this variable is automatically set by the framework.
-    It has to be defined by the user as an environment variable if compiling an external application.
-
-*   RTE_SRCDIR: The path to the root of the sources. When compiling the development kit, RTE_SRCDIR = RTE_SDK.
-    When compiling an external application, the variable points to the root of external application sources.
-
-*   RTE_OUTPUT: The path to which output files are written.
-    Typically, it is $(RTE_SRCDIR)/build, but it can be overridden by the O= option in the make command line.
-
-*   RTE_TARGET: A string identifying the target for which we are building.
-    The format is arch-machine-execenv-toolchain.
-    When compiling the SDK, the target is deduced by the build system from the configuration (.config).
-    When building an external application, it must be specified by the user in the Makefile or as an environment variable.
-
-*   RTE_SDK_BIN: References $(RTE_SDK)/$(RTE_TARGET).
-
 *   RTE_ARCH: Defines the architecture (i686, x86_64).
-    It is the same value as CONFIG_RTE_ARCH  but without the double-quotes around the string.
 
 *   RTE_MACHINE: Defines the machine.
-    It is the same value as CONFIG_RTE_MACHINE but without the double-quotes around the string.
 
 *   RTE_TOOLCHAIN: Defines the toolchain (gcc , icc).
-    It is the same value as CONFIG_RTE_TOOLCHAIN but without the double-quotes around the string.
 
 *   RTE_EXEC_ENV: Defines the executive environment (linux).
-    It is the same value as CONFIG_RTE_EXEC_ENV but without the double-quotes around the string.
-
-*   RTE_KERNELDIR: This variable contains the absolute path to the kernel sources that will be used to compile the kernel modules.
-    The kernel headers must be the same as the ones that will be used on the target machine (the machine that will run the application).
-    By default, the variable is set to /lib/modules/$(shell uname -r)/build,
-    which is correct when the target machine is also the build machine.
-
-*   RTE_DEVEL_BUILD: Stricter options (stop on warning). It defaults to y in a git tree.
-
-Variables that Can be Set/Overridden in a Makefile Only
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-*   VPATH: The path list that the build system will search for sources. By default, RTE_SRCDIR will be included in VPATH.
-
-*   CFLAGS: Flags to use for C compilation. The user should use +=  to append data in this variable.
-
-*   LDFLAGS: Flags to use for linking. The user should use +=  to append data in this variable.
-
-*   ASFLAGS: Flags to use for assembly. The user should use +=  to append data in this variable.
-
-*   CPPFLAGS: Flags to use to give flags to C preprocessor (only useful when assembling .S files).
-    The user should use += to append data in this variable.
-
-*   LDLIBS: In an application, the list of libraries to link with (for example, -L  /path/to/libfoo -lfoo ).
-    The user should use  +=  to append data in this variable.
-
-*   SRC-y: A list of source files (.c, .S, or .o  if the source is a binary) in case of application, library or object Makefiles.
-    The sources must be available from VPATH.
-
-*   INSTALL-y-$(INSTPATH): A list of files to be installed in  $(INSTPATH).
-    The files must be available from VPATH and will be copied in $(RTE_OUTPUT)/$(INSTPATH). Can be used in almost any RTE Makefile.
-
-*   SYMLINK-y-$(INSTPATH): A list of files to be installed in $(INSTPATH).
-    The files must be available from VPATH and will be linked (symbolically) in  $(RTE_OUTPUT)/$(INSTPATH).
-    This variable can be used in almost any DPDK Makefile.
-
-*   PREBUILD: A list of prerequisite actions to be taken before building. The user should use +=  to append data in this variable.
-
-*   POSTBUILD: A list of actions to be taken after the main build. The user should use += to append data in this variable.
-
-*   PREINSTALL: A list of prerequisite actions to be taken before installing. The user should use += to append data in this variable.
-
-*   POSTINSTALL: A list of actions to be taken after installing. The user should use += to append data in this variable.
-
-*   PRECLEAN: A list of prerequisite actions to be taken before cleaning. The user should use += to append data in this variable.
-
-*   POSTCLEAN: A list of actions to be taken after cleaning. The user should use += to append data in this variable.
-
-*   DEPDIRS-$(DIR): Only used in the development kit framework to specify if the build of the current directory depends on build of another one.
-    This is needed to support parallel builds correctly.
-
-Variables that can be Set/Overridden by the User on the Command Line Only
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Some variables can be used to configure the build system behavior. They are documented in
-:ref:`Development Kit Root Makefile Help <Development_Kit_Root_Makefile_Help>` and
-:ref:`External Application/Library Makefile Help <External_Application/Library_Makefile_Help>`
-
-    *   WERROR_CFLAGS: By default, this is set to a specific value that depends on the compiler.
-        Users are encouraged to use this variable as follows:
-
-            CFLAGS += $(WERROR_CFLAGS)
-
-This avoids the use of different cases depending on the compiler (icc or gcc).
-Also, this variable can be overridden from the command line, which allows bypassing of the flags for testing purposes.
-
-Variables that Can be Set/Overridden by the User in a Makefile or Command Line
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-*   CFLAGS_my_file.o: Specific flags to add for C compilation of my_file.c.
-
-*   LDFLAGS_my_app: Specific flags to add when linking my_app.
-
-*   EXTRA_CFLAGS: The content of this variable is appended after CFLAGS when compiling.
-
-*   EXTRA_LDFLAGS: The content of this variable is appended after LDFLAGS when linking.
-
-*   EXTRA_LDLIBS: The content of this variable is appended after LDLIBS when linking.
-
-*   EXTRA_ASFLAGS: The content of this variable is appended after ASFLAGS when assembling.
-
-*   EXTRA_CPPFLAGS: The content of this variable is appended after CPPFLAGS when using a C preprocessor on assembly files.
diff --git a/doc/guides/prog_guide/dev_kit_root_make_help.rst b/doc/guides/prog_guide/dev_kit_root_make_help.rst
deleted file mode 100644
index a30db7d5b4..0000000000
--- a/doc/guides/prog_guide/dev_kit_root_make_help.rst
+++ /dev/null
@@ -1,188 +0,0 @@
-..  SPDX-License-Identifier: BSD-3-Clause
-    Copyright(c) 2010-2014 Intel Corporation.
-
-.. _Development_Kit_Root_Makefile_Help:
-
-Development Kit Root Makefile Help
-==================================
-
-The DPDK provides a root level Makefile with targets for configuration, building, cleaning, testing, installation and others.
-These targets are explained in the following sections.
-
-Configuration Targets
----------------------
-
-The configuration target requires the name of the target, which is specified using T=mytarget and it is mandatory.
-The list of available targets are in $(RTE_SDK)/config (remove the defconfig _ prefix).
-
-Configuration targets also support the specification of the name of the output directory, using O=mybuilddir.
-This is an optional parameter, the default output directory is build.
-
-*   Config
-
-    This will create a build directory, and generates a configuration from a template.
-    A Makefile is also created in the new build directory.
-
-    Example:
-
-    .. code-block:: console
-
-        make config O=mybuild T=x86_64-native-linux-gcc
-
-Build Targets
--------------
-
-Build targets support the optional specification of the name of the output directory, using O=mybuilddir.
-The default output directory is build.
-
-*   all, build or just make
-
-    Build the DPDK in the output directory previously created by a make config.
-
-    Example:
-
-    .. code-block:: console
-
-        make O=mybuild
-
-*   clean
-
-    Clean all objects created using make build.
-
-    Example:
-
-    .. code-block:: console
-
-        make clean O=mybuild
-
-*   %_sub
-
-    Build a subdirectory only, without managing dependencies on other directories.
-
-    Example:
-
-    .. code-block:: console
-
-        make lib/librte_eal_sub O=mybuild
-
-*   %_clean
-
-    Clean a subdirectory only.
-
-    Example:
-
-    .. code-block:: console
-
-        make lib/librte_eal_clean O=mybuild
-
-Install Targets
----------------
-
-*   Install
-
-    The list of available targets are in $(RTE_SDK)/config (remove the defconfig\_ prefix).
-
-    The GNU standards variables may be used:
-    http://gnu.org/prep/standards/html_node/Directory-Variables.html and
-    http://gnu.org/prep/standards/html_node/DESTDIR.html
-
-    Example:
-
-    .. code-block:: console
-
-        make install DESTDIR=myinstall prefix=/usr
-
-Test Targets
-------------
-
-*   test
-
-    Launch automatic tests for a build directory specified using O=mybuilddir.
-    It is optional, the default output directory is build.
-
-    Example:
-
-    .. code-block:: console
-
-        make test O=mybuild
-
-Documentation Targets
----------------------
-
-*   doc
-
-    Generate the documentation (API and guides).
-
-*   doc-api-html
-
-    Generate the Doxygen API documentation in html.
-
-*   doc-guides-html
-
-    Generate the guides documentation in html.
-
-*   doc-guides-pdf
-
-    Generate the guides documentation in pdf.
-
-Misc Targets
-------------
-
-*   help
-
-    Show a quick help.
-
-Other Useful Command-line Variables
------------------------------------
-
-The following variables can be specified on the command line:
-
-*   V=
-
-    Enable verbose build (show full compilation command line, and some intermediate commands).
-
-*   D=
-
-    Enable dependency debugging. This provides some useful information about why a target is built or not.
-
-*   EXTRA_CFLAGS=, EXTRA_LDFLAGS=, EXTRA_LDLIBS=, EXTRA_ASFLAGS=, EXTRA_CPPFLAGS=
-
-    Append specific compilation, link or asm flags.
-
-*   CROSS=
-
-    Specify a cross toolchain header that will prefix all gcc/binutils applications. This only works when using gcc.
-
-Make in a Build Directory
--------------------------
-
-All targets described above are called from the SDK root $(RTE_SDK).
-It is possible to run the same Makefile targets inside the build directory.
-For instance, the following command:
-
-.. code-block:: console
-
-    cd $(RTE_SDK)
-    make config O=mybuild T=x86_64-native-linux-gcc
-    make O=mybuild
-
-is equivalent to:
-
-.. code-block:: console
-
-    cd $(RTE_SDK)
-    make config O=mybuild T=x86_64-native-linux-gcc
-    cd mybuild
-
-    # no need to specify O= now
-    make
-
-Compiling for Debug
--------------------
-
-To compile the DPDK and sample applications with debugging information included and the optimization level set to 0,
-the EXTRA_CFLAGS environment variable should be set before compiling as follows:
-
-.. code-block:: console
-
-    export EXTRA_CFLAGS='-O0 -g'
diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst
index f64ae953d1..936c885081 100644
--- a/doc/guides/prog_guide/env_abstraction_layer.rst
+++ b/doc/guides/prog_guide/env_abstraction_layer.rst
@@ -201,16 +201,16 @@ each segment is strictly one physical page. It is possible to change the amount
 of virtual memory being preallocated at startup by editing the following config
 variables:
 
-* ``CONFIG_RTE_MAX_MEMSEG_LISTS`` controls how many segment lists can DPDK have
-* ``CONFIG_RTE_MAX_MEM_MB_PER_LIST`` controls how much megabytes of memory each
+* ``RTE_MAX_MEMSEG_LISTS`` controls how many segment lists can DPDK have
+* ``RTE_MAX_MEM_MB_PER_LIST`` controls how much megabytes of memory each
   segment list can address
-* ``CONFIG_RTE_MAX_MEMSEG_PER_LIST`` controls how many segments each segment can
+* ``RTE_MAX_MEMSEG_PER_LIST`` controls how many segments each segment can
   have
-* ``CONFIG_RTE_MAX_MEMSEG_PER_TYPE`` controls how many segments each memory type
+* ``RTE_MAX_MEMSEG_PER_TYPE`` controls how many segments each memory type
   can have (where "type" is defined as "page size + NUMA node" combination)
-* ``CONFIG_RTE_MAX_MEM_MB_PER_TYPE`` controls how much megabytes of memory each
+* ``RTE_MAX_MEM_MB_PER_TYPE`` controls how much megabytes of memory each
   memory type can address
-* ``CONFIG_RTE_MAX_MEM_MB`` places a global maximum on the amount of memory
+* ``RTE_MAX_MEM_MB`` places a global maximum on the amount of memory
   DPDK can reserve
 
 Normally, these options do not need to be changed.
@@ -715,11 +715,6 @@ However, they can be used in configuration code.
 Refer to the rte_malloc() function description in the *DPDK API Reference*
 manual for more information.
 
-Cookies
-~~~~~~~
-
-When CONFIG_RTE_MALLOC_DEBUG is enabled, the allocated memory contains
-overwrite protection fields to help identify buffer overflows.
 
 Alignment and NUMA Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/guides/prog_guide/ext_app_lib_make_help.rst b/doc/guides/prog_guide/ext_app_lib_make_help.rst
index 4312778dc9..681114239d 100644
--- a/doc/guides/prog_guide/ext_app_lib_make_help.rst
+++ b/doc/guides/prog_guide/ext_app_lib_make_help.rst
@@ -1,28 +1,11 @@
 ..  SPDX-License-Identifier: BSD-3-Clause
     Copyright(c) 2010-2014 Intel Corporation.
 
-.. _External_Application/Library_Makefile_help:
+.. _External_Application_Makefile_help:
 
-External Application/Library Makefile help
+External Application Makefile help
 ==========================================
 
-External applications or libraries should include specific Makefiles from RTE_SDK, located in mk directory.
-These Makefiles are:
-
-*   ${RTE_SDK}/mk/rte.extapp.mk: Build an application
-
-*   ${RTE_SDK}/mk/rte.extlib.mk: Build a static library
-
-*   ${RTE_SDK}/mk/rte.extobj.mk: Build objects (.o)
-
-Prerequisites
--------------
-
-The following variables must be defined:
-
-*   ${RTE_SDK}: Points to the root directory of the DPDK.
-
-*   ${RTE_TARGET}: Reference the target to be used for compilation (for example, x86_64-native-linux-gcc).
 
 Build Targets
 -------------
@@ -32,7 +15,7 @@ This is optional; the default output directory is build.
 
 *   all, "nothing" (meaning just make)
 
-    Build the application or the library in the specified output directory.
+    Build the application in the specified output directory.
 
     Example:
 
@@ -93,6 +76,4 @@ It is possible to run the Makefile from another directory, by specifying the out
 
 .. code-block:: console
 
-    export RTE_SDK=/path/to/DPDK
-    export RTE_TARGET=x86_64-native-linux-icc
     make -f /path/to/my_app/Makefile S=/path/to/my_app O=/path/to/build_dir
diff --git a/doc/guides/prog_guide/graph_lib.rst b/doc/guides/prog_guide/graph_lib.rst
index 669d77c740..c922d10f3d 100644
--- a/doc/guides/prog_guide/graph_lib.rst
+++ b/doc/guides/prog_guide/graph_lib.rst
@@ -45,13 +45,11 @@ Performance tuning parameters
 -----------------------------
 
 - Test with various burst size values (256, 128, 64, 32) using
-  CONFIG_RTE_GRAPH_BURST_SIZE config option.
+  RTE_GRAPH_BURST_SIZE config option.
   The testing shows, on x86 and arm64 servers, The sweet spot is 256 burst
   size. While on arm64 embedded SoCs, it is either 64 or 128.
-- Disable node statistics (using ``CONFIG_RTE_LIBRTE_GRAPH_STATS`` config option)
+- Disable node statistics (using ``RTE_LIBRTE_GRAPH_STATS`` config option)
   if not needed.
-- Use arm64 optimized memory copy for arm64 architecture by
-  selecting ``CONFIG_RTE_ARCH_ARM64_MEMCPY``.
 
 Programming model
 -----------------
diff --git a/doc/guides/prog_guide/intro.rst b/doc/guides/prog_guide/intro.rst
index 5b319d36d9..44877bd3e3 100644
--- a/doc/guides/prog_guide/intro.rst
+++ b/doc/guides/prog_guide/intro.rst
@@ -34,7 +34,7 @@ The following is a list of DPDK documents in the suggested reading order:
         specifically in a Linux* application (linux) environment
 
     *   The content of the DPDK, the build system
-        (including the commands that can be used in the root DPDK Makefile to build the development kit and an application)
+        (including the commands that can be used in the root DPDK to build the development kit and an application)
         and guidelines for porting an application
 
     *   Optimizations used in the software and those that should be considered for new development
diff --git a/doc/guides/prog_guide/ip_fragment_reassembly_lib.rst b/doc/guides/prog_guide/ip_fragment_reassembly_lib.rst
index 6ac1bba649..314d4adbb8 100644
--- a/doc/guides/prog_guide/ip_fragment_reassembly_lib.rst
+++ b/doc/guides/prog_guide/ip_fragment_reassembly_lib.rst
@@ -103,8 +103,3 @@ Debug logging and Statistics Collection
 
 The RTE_LIBRTE_IP_FRAG_TBL_STAT config macro controls statistics collection for the Fragment Table.
 This macro is not enabled by default.
-
-The RTE_LIBRTE_IP_FRAG_DEBUG controls debug logging of IP fragments processing and reassembling.
-This macro is disabled by default.
-Note that while logging contains a lot of detailed information,
-it slows down packet processing and might cause the loss of a lot of packets.
diff --git a/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst b/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst
index 2459fd243e..c376ac5f74 100644
--- a/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst
+++ b/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst
@@ -25,11 +25,6 @@ The librte_pmd_bond library exports a C API which provides an API for the
 creation of bonded devices as well as the configuration and management of the
 bonded device and its slave devices.
 
-.. note::
-
-    The Link Bonding PMD Library is enabled by default in the build
-    configuration files, the library can be disabled by setting
-    ``CONFIG_RTE_LIBRTE_PMD_BOND=n`` and recompiling the DPDK.
 
 Link Bonding Modes Overview
 ---------------------------
diff --git a/doc/guides/prog_guide/lto.rst b/doc/guides/prog_guide/lto.rst
index 277a6f1090..efa0cec4a1 100644
--- a/doc/guides/prog_guide/lto.rst
+++ b/doc/guides/prog_guide/lto.rst
@@ -26,17 +26,8 @@ need to explicitly initialize variable in order to silence the compiler.
 Please note that turning LTO on causes considerable extension of
 build time.
 
-When using make based build, link time optimization can be enabled for
-the whole DPDK by setting:
-
-.. code-block:: console
-
-    CONFIG_RTE_ENABLE_LTO=y
-
-in config file.
-
-For the meson based build it can be enabled by setting meson built-in
-'b_lto' option:
+For the meson based build link time optimization can be enabled by setting
+meson built-in 'b_lto' option:
 
 .. code-block:: console
 
diff --git a/doc/guides/prog_guide/mbuf_lib.rst b/doc/guides/prog_guide/mbuf_lib.rst
index c3dbfb9221..2f190b40e4 100644
--- a/doc/guides/prog_guide/mbuf_lib.rst
+++ b/doc/guides/prog_guide/mbuf_lib.rst
@@ -266,8 +266,8 @@ can be found in several of the sample applications, for example, the IPv4 Multic
 Debug
 -----
 
-In debug mode (CONFIG_RTE_MBUF_DEBUG is enabled),
-the functions of the mbuf library perform sanity checks before any operation (such as, buffer corruption, bad type, and so on).
+In debug mode, the functions of the mbuf library perform sanity checks before any operation (such as, buffer corruption,
+bad type, and so on).
 
 Use Cases
 ---------
diff --git a/doc/guides/prog_guide/mempool_lib.rst b/doc/guides/prog_guide/mempool_lib.rst
index e3e1f940be..f0bdcd3be1 100644
--- a/doc/guides/prog_guide/mempool_lib.rst
+++ b/doc/guides/prog_guide/mempool_lib.rst
@@ -17,14 +17,13 @@ This library is used by the :ref:`Mbuf Library <Mbuf_Library>`.
 Cookies
 -------
 
-In debug mode (CONFIG_RTE_LIBRTE_MEMPOOL_DEBUG is enabled), cookies are added at the beginning and end of allocated blocks.
+In debug mode, cookies are added at the beginning and end of allocated blocks.
 The allocated objects then contain overwrite protection fields to help debugging buffer overflows.
 
 Stats
 -----
 
-In debug mode (CONFIG_RTE_LIBRTE_MEMPOOL_DEBUG is enabled),
-statistics about get from/put in the pool are stored in the mempool structure.
+In debug mode, statistics about get from/put in the pool are stored in the mempool structure.
 Statistics are per-lcore to avoid concurrent access to statistics counters.
 
 Memory Alignment Constraints on x86 architecture
@@ -90,7 +89,7 @@ the speed at which a core can access its own cache for a specific memory pool wi
 The cache is composed of a small, per-core table of pointers and its length (used as a stack).
 This internal cache can be enabled or disabled at creation of the pool.
 
-The maximum size of the cache is static and is defined at compilation time (CONFIG_RTE_MEMPOOL_CACHE_MAX_SIZE).
+The maximum size of the cache is static and is defined at compilation time (RTE_MEMPOOL_CACHE_MAX_SIZE).
 
 :numref:`figure_mempool` shows a cache in operation.
 
diff --git a/doc/guides/prog_guide/overview.rst b/doc/guides/prog_guide/overview.rst
index 986c896908..537a568f1e 100644
--- a/doc/guides/prog_guide/overview.rst
+++ b/doc/guides/prog_guide/overview.rst
@@ -18,7 +18,7 @@ The framework creates a set of libraries for specific environments
 through the creation of an Environment Abstraction Layer (EAL),
 which may be specific to a mode of the Intel® architecture (32-bit or 64-bit),
 Linux* user space compilers or a specific platform.
-These environments are created through the use of make files and configuration files.
+These environments are created through the use of meson files and configuration files.
 Once the EAL library is created, the user may link with the library to create their own applications.
 Other libraries, outside of EAL, including the Hash,
 Longest Prefix Match (LPM) and rings libraries are also provided.
@@ -38,21 +38,13 @@ Development Environment
 -----------------------
 
 The DPDK project installation requires Linux and the associated toolchain,
-such as one or more compilers, assembler, make utility,
+such as one or more compilers, assembler, meson utility,
 editor and various libraries to create the DPDK components and libraries.
 
 Once these libraries are created for the specific environment and architecture,
 they may then be used to create the user's data plane application.
 
 When creating applications for the Linux user space, the glibc library is used.
-For DPDK applications, two environmental variables (RTE_SDK and RTE_TARGET)
-must be configured before compiling the applications.
-The following are examples of how the variables can be set:
-
-.. code-block:: console
-
-    export RTE_SDK=/home/user/DPDK
-    export RTE_TARGET=x86_64-native-linux-gcc
 
 See the *DPDK Getting Started Guide* for information on setting up the development environment.
 
diff --git a/doc/guides/prog_guide/profile_app.rst b/doc/guides/prog_guide/profile_app.rst
index e5d0e9079e..9394bb7b41 100644
--- a/doc/guides/prog_guide/profile_app.rst
+++ b/doc/guides/prog_guide/profile_app.rst
@@ -33,14 +33,6 @@ Refer to the
 for details about application profiling.
 
 
-Profiling with VTune
-~~~~~~~~~~~~~~~~~~~~
-
-To allow VTune attaching to the DPDK application, reconfigure and recompile
-the DPDK with ``CONFIG_RTE_ETHDEV_RXTX_CALLBACKS`` and
-``CONFIG_RTE_ETHDEV_PROFILE_WITH_VTUNE`` enabled.
-
-
 Profiling on ARM64
 ------------------
 
@@ -76,8 +68,7 @@ cycle counter for user space access by configuring the PMU from the privileged
 mode (kernel space).
 
 By default the ``rte_rdtsc()`` implementation uses a portable ``cntvct_el0``
-scheme.  Application can choose the PMU based implementation with
-``CONFIG_RTE_ARM_EAL_RDTSC_USE_PMU``.
+scheme.
 
 The example below shows the steps to configure the PMU based cycle counter on
 an ARMv8 machine.
@@ -88,10 +79,6 @@ an ARMv8 machine.
     cd armv8_pmu_cycle_counter_el0
     make
     sudo insmod pmu_el0_cycle_counter.ko
-    cd $DPDK_DIR
-    make config T=arm64-armv8a-linux-gcc
-    echo "CONFIG_RTE_ARM_EAL_RDTSC_USE_PMU=y" >> build/.config
-    make
 
 .. warning::
 
diff --git a/doc/guides/prog_guide/qos_framework.rst b/doc/guides/prog_guide/qos_framework.rst
index a159709450..4e4ea33ccb 100644
--- a/doc/guides/prog_guide/qos_framework.rst
+++ b/doc/guides/prog_guide/qos_framework.rst
@@ -1525,15 +1525,7 @@ Integration with the DPDK QoS Scheduler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 RED functionality in the DPDK QoS scheduler is disabled by default.
-To enable it, use the DPDK configuration parameter:
-
-::
-
-    CONFIG_RTE_SCHED_RED=y
-
-This parameter must be set to y.
-The parameter is found in the build configuration files in the DPDK/config directory,
-for example, DPDK/config/common_linux.
+The parameter is found in the build configuration files in the DPDK/config directory.
 RED configuration parameters are specified in the rte_red_params structure within the rte_sched_port_params structure
 that is passed to the scheduler on initialization.
 RED parameters are specified separately for four traffic classes and three packet colors (green, yellow and red)
diff --git a/doc/guides/prog_guide/rcu_lib.rst b/doc/guides/prog_guide/rcu_lib.rst
index d142d0c79d..d0aef3bc16 100644
--- a/doc/guides/prog_guide/rcu_lib.rst
+++ b/doc/guides/prog_guide/rcu_lib.rst
@@ -186,10 +186,9 @@ they entered a quiescent state. This API checks if a writer has triggered a
 quiescent state query and update the state accordingly.
 
 The ``rte_rcu_qsbr_lock()`` and ``rte_rcu_qsbr_unlock()`` are empty functions.
-However, when ``CONFIG_RTE_LIBRTE_RCU_DEBUG`` is enabled, these APIs aid
-in debugging issues. One can mark the access to shared data structures on the
-reader side using these APIs. The ``rte_rcu_qsbr_quiescent()`` will check if
-all the locks are unlocked.
+However, these APIs can aid in debugging issues. One can mark the access to
+shared data structures on the reader side using these APIs. The
+``rte_rcu_qsbr_quiescent()`` will check if all the locks are unlocked.
 
 Resource reclamation framework for DPDK
 ---------------------------------------
diff --git a/doc/guides/prog_guide/source_org.rst b/doc/guides/prog_guide/source_org.rst
index 31c153a1b7..8d531bd9ef 100644
--- a/doc/guides/prog_guide/source_org.rst
+++ b/doc/guides/prog_guide/source_org.rst
@@ -8,29 +8,10 @@ Source Organization
 
 This section describes the organization of sources in the DPDK framework.
 
-Makefiles and Config
---------------------
-
-.. note::
-
-    In the following descriptions,
-    ``RTE_SDK`` is the environment variable that points to the base directory into which the tarball was extracted.
-    See
-    :ref:`Useful_Variables_Provided_by_the_Build_System`
-    for descriptions of other variables.
-
-Makefiles that are provided by the DPDK libraries and applications are located in ``$(RTE_SDK)/mk``.
-
-Config templates are located in ``$(RTE_SDK)/config``. The templates describe the options that are enabled for each target.
-The config file also contains items that can be enabled and disabled for many of the DPDK libraries,
-including debug options.
-The user should look at the config file and become familiar with these options.
-The config file is also used to create a header file, which will be located in the new build directory.
-
 Libraries
 ---------
 
-Libraries are located in subdirectories of ``$(RTE_SDK)/lib``.
+Libraries are located in subdirectories of ``dpdk/lib``.
 By convention a library refers to any code that provides an API to an application.
 Typically, it generates an archive file (``.a``), but a kernel module would also go in the same directory.
 
@@ -55,7 +36,7 @@ Applications
 ------------
 
 Applications are source files that contain a ``main()`` function.
-They are located in the ``$(RTE_SDK)/app`` and ``$(RTE_SDK)/examples`` directories.
+They are located in the ``dpdk/app`` and ``dpdk/examples`` directories.
 
 The app directory contains sample applications that are used to test DPDK (such as autotests)
 or the Poll Mode Drivers (test-pmd).
diff --git a/doc/guides/prog_guide/trace_lib.rst b/doc/guides/prog_guide/trace_lib.rst
index 9bbfd165d8..fbadf9fde9 100644
--- a/doc/guides/prog_guide/trace_lib.rst
+++ b/doc/guides/prog_guide/trace_lib.rst
@@ -135,8 +135,7 @@ In order to avoid performance impact in fast path code, the library introduced
 the user must use ``RTE_TRACE_POINT_FP`` instead of ``RTE_TRACE_POINT``.
 
 ``RTE_TRACE_POINT_FP`` is compiled out by default and it can be enabled using
-``CONFIG_RTE_ENABLE_TRACE_FP`` configuration parameter.
-The ``enable_trace_fp`` option shall be used for the same for meson build.
+the ``enable_trace_fp`` option for meson build.
 
 Event record mode
 -----------------
diff --git a/doc/guides/prog_guide/writing_efficient_code.rst b/doc/guides/prog_guide/writing_efficient_code.rst
index 2639ef7bf6..db2f1ddbc2 100644
--- a/doc/guides/prog_guide/writing_efficient_code.rst
+++ b/doc/guides/prog_guide/writing_efficient_code.rst
@@ -258,8 +258,7 @@ For instance:
 Setting the Target CPU Type
 ---------------------------
 
-The DPDK supports CPU microarchitecture-specific optimizations by means of CONFIG_RTE_MACHINE option
-in the DPDK configuration file.
+The DPDK supports CPU microarchitecture-specific optimizations by means of RTE_MACHINE option.
 The degree of optimization depends on the compiler's ability to optimize for a specific microarchitecture,
 therefore it is preferable to use the latest compiler versions whenever possible.
 
-- 
2.17.1


  parent reply	other threads:[~2020-08-07 12:41 UTC|newest]

Thread overview: 300+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-08-07 12:29 [dpdk-dev] [PATCH 20.11 00/19] remove make support in DPDK Ciara Power
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 01/19] examples: remove legacy sections of makefiles Ciara Power
2020-08-12 16:38   ` Bruce Richardson
2020-08-13 14:29     ` Power, Ciara
2020-08-14 10:29   ` Bruce Richardson
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 02/19] build: remove makefiles and mk directory Ciara Power
2020-08-07 12:45   ` Bruce Richardson
2020-08-07 13:19     ` Jerin Jacob
2020-08-07 13:23       ` Bruce Richardson
2020-08-07 13:34         ` Ferruh Yigit
2020-08-07 14:01           ` Jerin Jacob
2020-08-07 15:05             ` Gaëtan Rivet
2020-08-12 15:50               ` Bruce Richardson
2020-08-12 16:12                 ` Jerin Jacob
2020-08-12 16:40                   ` Bruce Richardson
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 03/19] config: remove all config files used by make Ciara Power
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 04/19] buildtools: remove all scripts for use with make Ciara Power
2020-08-12 21:54   ` Thomas Monjalon
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 05/19] doc: remove references to make in bbdev guides Ciara Power
2020-08-12 21:56   ` Thomas Monjalon
2020-08-18 11:46   ` Laatz, Kevin
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 06/19] doc: remove references to make in compressdev guides Ciara Power
2020-08-18 11:46   ` Laatz, Kevin
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 07/19] doc: remove references to make in contributing guides Ciara Power
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 08/19] doc: remove references to make in cryptodev guides Ciara Power
2020-08-18 11:46   ` Laatz, Kevin
2020-08-07 12:29 ` [dpdk-dev] [PATCH 20.11 09/19] doc: remove references to make in eventdev guides Ciara Power
2020-08-18 11:46   ` Laatz, Kevin
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 10/19] doc: remove references to make in FreeBSD gsg guide Ciara Power
2020-08-18 11:33   ` Bruce Richardson
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 11/19] doc: remove references to make in howto guides Ciara Power
2020-08-12 22:00   ` Thomas Monjalon
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 12/19] doc: remove references to make in Linux gsg guides Ciara Power
2020-08-18 11:40   ` Bruce Richardson
2020-08-19 13:03     ` Bruce Richardson
2020-08-18 11:48   ` Bruce Richardson
2020-08-18 13:11   ` Bruce Richardson
2020-08-18 13:34   ` Bruce Richardson
2020-08-18 14:31   ` Bruce Richardson
2020-08-18 14:45   ` Bruce Richardson
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 13/19] doc: remove references to make in mempool guides Ciara Power
2020-08-18 10:34   ` Kilheeney, Louise
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 14/19] doc: remove references to make in NIC guides Ciara Power
2020-08-19 16:22   ` Bruce Richardson
2020-08-19 17:17   ` Bruce Richardson
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 15/19] doc: remove references to make in platform guides Ciara Power
2020-08-12 22:03   ` Thomas Monjalon
2020-08-07 12:30 ` Ciara Power [this message]
2020-08-12 22:05   ` [dpdk-dev] [PATCH 20.11 16/19] doc: remove references to make in prog guides Thomas Monjalon
2020-08-17 13:54   ` Bruce Richardson
2020-08-19 15:54     ` Stephen Hemminger
2020-08-19 15:21   ` Laatz, Kevin
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 17/19] doc: remove references to make in rawdev guides Ciara Power
2020-08-18 11:46   ` Laatz, Kevin
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 18/19] doc: remove references to make in sample app guides Ciara Power
2020-08-07 12:30 ` [dpdk-dev] [PATCH 20.11 19/19] doc: remove references to make in vdpadevs guides Ciara Power
2020-08-07 13:28 ` [dpdk-dev] [PATCH 20.11 00/19] remove make support in DPDK Bruce Richardson
2020-08-12 22:07   ` Thomas Monjalon
2020-08-12 21:50 ` Thomas Monjalon
2020-08-20 12:41 ` [dpdk-dev] [PATCH v2 00/37] " Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 01/37] examples: remove legacy sections of makefiles Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 02/37] examples/multi_process: convert to pkg-config-based build Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 03/37] examples/server_node_efd: " Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 04/37] examples/ka-agent: " Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 05/37] examples/pthread: " Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 06/37] examples/vm_power_manager: convert to use DPDK pkg-config Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 07/37] examples/vm_power_manager: convert guest cli to pkg-config Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 08/37] examples/ethtool: convert to pkg-config-based build Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 09/37] build: create dummy Makefile Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 10/37] build: remove makefiles and mk directory Ciara Power
2020-08-21  3:18     ` Ruifeng Wang
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 11/37] config: remove all config files used by make Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 12/37] examples: remove old build system references Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 13/37] buildtools: remove all scripts for use with make Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 14/37] devtools: remove use of make in scripts Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 15/37] app/test: remove references to make Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 16/37] drivers: remove references to make config options Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 17/37] lib: " Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 18/37] doc/guides: remove use of DPDK make build system Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 19/37] doc: remove deprecation notice for make Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 20/37] doc: remove references to make in bbdev guides Ciara Power
2020-08-21  2:12     ` Chautru, Nicolas
2020-08-21 10:55       ` Power, Ciara
2020-08-21 15:18         ` Chautru, Nicolas
2020-08-21  2:22     ` Chautru, Nicolas
2020-08-21  9:41       ` Bruce Richardson
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 21/37] doc: remove references to make in compressdev guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 22/37] doc: remove references to make in contributing guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 23/37] doc: remove references to make in cryptodev guides Ciara Power
2020-08-20 15:08     ` Laatz, Kevin
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 24/37] doc: remove references to make in eventdev guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 25/37] doc: remove references to make in FreeBSD gsg guide Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 26/37] doc: remove references to make in howto guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 27/37] doc: remove references to make in Linux gsg guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 28/37] doc: remove references to make in mempool guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 29/37] doc: remove references to make in NIC guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 30/37] doc: remove references to make in platform guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 31/37] doc: remove references to make in prog guides Ciara Power
2020-08-20 15:08     ` Laatz, Kevin
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 32/37] doc: remove references to make in rawdev guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 33/37] doc: remove references to make in sample app guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 34/37] doc: remove references to make in vdpadevs guides Ciara Power
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 35/37] doc: remove reference to make in tools guides Ciara Power
2020-09-02 11:08     ` Laatz, Kevin
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 36/37] doc: remove references to make in testpmd guides Ciara Power
2020-09-02 11:08     ` Laatz, Kevin
2020-08-20 12:41   ` [dpdk-dev] [PATCH v2 37/37] doc: update quick build doc to remove make references Ciara Power
2020-09-02 11:08     ` Laatz, Kevin
2020-09-03 15:26 ` [dpdk-dev] [PATCH v3 00/37] remove make support in DPDK Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 01/37] examples: remove legacy sections of makefiles Ciara Power
2020-09-04  0:36     ` Chautru, Nicolas
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 02/37] examples/multi_process: convert to pkg-config-based build Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 03/37] examples/server_node_efd: " Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 04/37] examples/ka-agent: " Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 05/37] examples/pthread: " Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 06/37] examples/vm_power_manager: convert to use DPDK pkg-config Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 07/37] examples/vm_power_manager: convert guest cli to pkg-config Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 08/37] examples/ethtool: convert to pkg-config-based build Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 09/37] build: create dummy Makefile Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 10/37] build: remove makefiles and mk directory Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 11/37] config: remove all config files used by make Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 12/37] examples: remove old build system references Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 13/37] buildtools: remove all scripts for use with make Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 14/37] devtools: remove use of make in scripts Ciara Power
2020-09-06 10:15     ` Thomas Monjalon
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 15/37] app/test: remove references to make Ciara Power
2020-09-04  0:24     ` Chautru, Nicolas
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 16/37] drivers: remove references to make config options Ciara Power
2020-09-06 10:24     ` Thomas Monjalon
2020-09-07  8:18       ` Bruce Richardson
2020-09-07  9:43         ` Thomas Monjalon
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 17/37] lib: " Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 18/37] doc/guides: remove use of DPDK make build system Ciara Power
2020-09-03 15:26   ` [dpdk-dev] [PATCH v3 19/37] doc: remove deprecation notice for make Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 20/37] doc: remove references to make in bbdev guides Ciara Power
2020-09-04  1:35     ` Chautru, Nicolas
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 21/37] doc: remove references to make in compressdev guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 22/37] doc: remove references to make in contributing guides Ciara Power
2020-09-07 10:20     ` Thomas Monjalon
2020-09-17 13:44       ` Power, Ciara
2020-09-21 16:14         ` Thomas Monjalon
2020-09-21 19:14           ` Dumitrescu, Cristian
2020-09-22  8:39             ` Power, Ciara
2020-09-22  9:14               ` Dumitrescu, Cristian
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 23/37] doc: remove references to make in cryptodev guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 24/37] doc: remove references to make in eventdev guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 25/37] doc: remove references to make in FreeBSD gsg guide Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 26/37] doc: remove references to make in howto guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 27/37] doc: remove references to make in Linux gsg guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 28/37] doc: remove references to make in mempool guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 29/37] doc: remove references to make in NIC guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 30/37] doc: remove references to make in platform guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 31/37] doc: remove references to make in prog guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 32/37] doc: remove references to make in rawdev guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 33/37] doc: remove references to make in sample app guides Ciara Power
2020-09-04  0:34     ` Chautru, Nicolas
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 34/37] doc: remove references to make in vdpadevs guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 35/37] doc: remove reference to make in tools guides Ciara Power
2020-09-04  0:32     ` Chautru, Nicolas
2020-09-04  9:04     ` Pattan, Reshma
2020-09-04 13:34       ` Bruce Richardson
2020-09-04 13:54         ` Pattan, Reshma
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 36/37] doc: remove references to make in testpmd guides Ciara Power
2020-09-03 15:27   ` [dpdk-dev] [PATCH v3 37/37] doc: update quick build doc to remove make references Ciara Power
2020-09-06 13:19     ` Thomas Monjalon
2020-09-06 21:58   ` [dpdk-dev] [PATCH v3 00/37] remove make support in DPDK Thomas Monjalon
2020-09-07 22:06   ` [dpdk-dev] [PATCH v4 00/31] " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 01/31] doc: build without using make Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 02/31] examples: remove legacy sections of makefiles Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 03/31] examples/ka-agent: convert to pkg-config-based build Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 04/31] examples/server_node_efd: " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 05/31] examples/performance-thread: " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 06/31] examples/multi_process: " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 07/31] examples/vm_power: " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 08/31] examples/ethtool: " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 09/31] examples: remove old build system references Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 10/31] build: create dummy Makefile Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 11/31] build: remove makefiles Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 12/31] buildtools: remove scripts used only with make Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 13/31] config: remove default configs used " Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 14/31] devtools: remove legacy flags from includes check Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 15/31] app: remove references to make-based config Thomas Monjalon
2020-09-14 17:11       ` Laatz, Kevin
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 16/31] doc: remove references to make from Linux guide Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 17/31] doc: remove references to make from FreeBSD guide Thomas Monjalon
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 18/31] doc: remove references to make from howto guides Thomas Monjalon
2020-09-14 16:53       ` Laatz, Kevin
2020-09-07 22:06     ` [dpdk-dev] [PATCH v4 19/31] doc: remove references to make from prog guide Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 20/31] doc: remove references to make from platforms guides Thomas Monjalon
2020-09-14 16:52       ` Laatz, Kevin
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 21/31] doc: remove references to make from mempool guide Thomas Monjalon
2020-09-14 16:52       ` Laatz, Kevin
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 22/31] doc: remove references to make from NICs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 23/31] doc: remove references to make from vdpadevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 24/31] doc: remove references to make from bbdevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 25/31] doc: remove references to make from cryptodevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 26/31] doc: remove references to make from compressdevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 27/31] doc: remove references to make from eventdevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 28/31] doc: remove references to make from rawdevs guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 29/31] doc: remove references to make from app guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 30/31] doc: remove reference to make from tools guides Thomas Monjalon
2020-09-07 22:07     ` [dpdk-dev] [PATCH v4 31/31] doc: remove references to make from contributing guide Thomas Monjalon
2020-09-08 10:16       ` Thomas Monjalon
2020-09-08  8:16     ` [dpdk-dev] [PATCH v4 00/31] remove make support in DPDK Bruce Richardson
2020-09-08  9:05       ` Thomas Monjalon
2020-09-15 14:02         ` David Marchand
2020-09-15 15:08           ` Power, Ciara
2020-09-15 15:44             ` Thomas Monjalon
2020-09-15 15:57               ` Richardson, Bruce
2020-09-15 16:10                 ` Thomas Monjalon
2020-09-15 16:39                   ` Chautru, Nicolas
2020-09-15 16:42                     ` Thomas Monjalon
2020-09-16 14:58             ` David Marchand
2020-09-08 13:02     ` David Marchand
2020-09-21 13:59 ` [dpdk-dev] [PATCH v5 00/20] " Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 01/20] devtools: remove legacy flags from includes check Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 02/20] app: remove references to make-based config Ciara Power
2020-09-21 14:28     ` Chautru, Nicolas
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 03/20] doc: remove references to make from Linux guide Ciara Power
2020-09-30 22:09     ` Thomas Monjalon
2020-10-01  8:31       ` Power, Ciara
2020-10-01  8:36       ` Power, Ciara
2020-10-01  9:49         ` Thomas Monjalon
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 04/20] doc: remove references to make from FreeBSD guide Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 05/20] doc: remove references to make from howto guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 06/20] doc: remove references to make from prog guide Ciara Power
2020-10-09 12:07     ` Ferruh Yigit
2020-10-09 12:12       ` Ferruh Yigit
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 07/20] doc: remove references to make from platforms guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 08/20] doc: remove references to make from mempool guide Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 09/20] doc: remove references to make from NICs guides Ciara Power
2020-10-09 12:08     ` Ferruh Yigit
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 10/20] doc: remove references to make from vdpadevs guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 11/20] doc: remove references to make from bbdevs guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 12/20] doc: remove references to make from cryptodevs guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 13/20] doc: remove references to make from compressdevs guides Ciara Power
2020-10-02  9:33     ` Daly, Lee
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 14/20] doc: remove references to make from eventdevs guides Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 15/20] doc: remove references to make from rawdevs guides Ciara Power
2020-10-01 15:17     ` Bruce Richardson
2020-10-02 14:57     ` Xu, Rosen
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 16/20] doc: remove references to make from app guides Ciara Power
2020-09-24 13:17     ` David Hunt
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 17/20] doc: remove reference to make from tools guides Ciara Power
2020-10-01 14:03     ` Power, Ciara
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 18/20] doc: remove references to make from contributing guide Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 19/20] doc: add to release notes to reflect removal of make Ciara Power
2020-09-21 13:59   ` [dpdk-dev] [PATCH v5 20/20] doc: update patch cheatsheet to use meson Ciara Power
2020-10-01 15:09   ` [dpdk-dev] [PATCH v5 00/20] remove make support in DPDK Thomas Monjalon
2020-10-09 10:21 ` [dpdk-dev] [PATCH v6 00/14] " Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 01/14] doc: remove references to make from platforms guides Ciara Power
2020-10-12 19:37     ` Harman Kalra
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 02/14] doc: remove references to make from mempool guide Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 03/14] doc: remove references to make from NICs guides Ciara Power
2020-10-09 12:00     ` [dpdk-dev] [EXT] " Igor Russkikh
2020-10-11 21:01       ` Thomas Monjalon
2020-10-12  6:47         ` Rasesh Mody
2020-10-09 12:15     ` [dpdk-dev] " Ferruh Yigit
2020-10-12  0:42       ` Ajit Khaparde
2020-10-12  2:41     ` Hyong Youb Kim (hyonkim)
2020-10-12 19:57     ` [dpdk-dev] [EXT] " Harman Kalra
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 04/14] doc: remove references to make from vdpadevs guides Ciara Power
2020-10-11  6:49     ` Matan Azrad
2020-10-11 20:57     ` Thomas Monjalon
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 05/14] doc: remove references to make from bbdevs guides Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 06/14] doc: remove references to make from cryptodevs guides Ciara Power
2020-10-09 10:30     ` Akhil Goyal
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 07/14] doc: remove references to make from compressdevs guides Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 08/14] doc: remove references to make from eventdevs guides Ciara Power
2020-10-11 20:36     ` Thomas Monjalon
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 09/14] doc: remove references to make from rawdevs guides Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 10/14] doc: remove references to make from app guides Ciara Power
2020-10-09 12:23     ` Ferruh Yigit
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 11/14] doc: remove reference to make from tools guides Ciara Power
2020-10-11 20:45     ` Thomas Monjalon
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 12/14] doc: remove references to make from contributing guide Ciara Power
2020-10-11 20:52     ` Thomas Monjalon
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 13/14] doc: add to release notes to reflect removal of make Ciara Power
2020-10-09 10:21   ` [dpdk-dev] [PATCH v6 14/14] doc: update patch cheatsheet to use meson Ciara Power
2020-10-21  8:17 ` [dpdk-dev] [PATCH v7 00/14] remove make support in DPDK Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 01/14] doc: remove references to make from platforms guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 02/14] doc: remove references to make from mempool guide Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 03/14] doc: remove references to make from NICs guides Ciara Power
2020-10-22  8:31     ` Thomas Monjalon
2020-10-22 10:03       ` Power, Ciara
2020-10-22 10:16         ` Thomas Monjalon
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 04/14] doc: remove references to make from vdpadevs guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 05/14] doc: remove references to make from bbdevs guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 06/14] doc: remove references to make from cryptodevs guides Ciara Power
2020-10-21  8:33     ` Ruifeng Wang
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 07/14] doc: remove references to make from compressdevs guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 08/14] doc: remove references to make from eventdevs guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 09/14] doc: remove references to make from rawdevs guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 10/14] doc: remove references to make from app guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 11/14] doc: remove reference to make from tools guides Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 12/14] doc: remove references to make from contributing guide Ciara Power
2020-10-22 20:40     ` Thomas Monjalon
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 13/14] doc: add to release notes to reflect removal of make Ciara Power
2020-10-21  8:17   ` [dpdk-dev] [PATCH v7 14/14] doc: update patch cheatsheet to use meson Ciara Power
2020-10-22 20:53   ` [dpdk-dev] [PATCH v7 00/14] remove make support in DPDK Thomas Monjalon

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=20200807123009.21266-17-ciara.power@intel.com \
    --to=ciara.power@intel.com \
    --cc=bruce.richardson@intel.com \
    --cc=dev@dpdk.org \
    --cc=thomas@monjalon.net \
    /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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).