On Sat, Jun 11, 2022 at 2:07 AM June Knauth <june.knauth@xxxxxxxxx> wrote: > > From: "June Knauth (VMware)" <june.knauth@xxxxxxxxx> > > This patch covers several small improvements in the README. They are: > 1. Removal of the > characters and excess linebreaks to improve readability > 2. Addition of two dependencies to the manual install instructions: > binutils-dev and pkg-config. > 3. Addition of a "Testing" section Hi June, "Testing" is described in the CONTRIBUTING file, as it is more related to the development process, but I agree that it is useful to have it in the README as well. Applied. Thanks for polishing the documentation! > > Signed-off-by: June Knauth (VMware) <june.knauth@xxxxxxxxx> > --- > README.md | 104 +++++++++++++++++++++--------------------------------- > 1 file changed, 40 insertions(+), 64 deletions(-) > > diff --git a/README.md b/README.md > index 95cbd8e..cba5495 100644 > --- a/README.md > +++ b/README.md > @@ -17,83 +17,59 @@ Trace-Cruncher has the following external dependencies: > > 1.1 In order to install all packages on Ubuntu do the following: > > - > sudo apt-get update > - > - > sudo apt-get install build-essential git cmake libjson-c-dev -y > - > - > sudo apt-get install libpython3-dev cython3 python3-numpy python3-pip -y > - > - > sudo apt-get install flex valgrind -y > - > - > sudo pip3 install --system pkgconfig GitPython > + sudo apt-get update > + sudo apt-get install build-essential git cmake libjson-c-dev -y > + sudo apt-get install libpython3-dev cython3 python3-numpy python3-pip -y > + sudo apt-get install flex valgrind binutils-dev pkg-config -y > + sudo pip3 install --system pkgconfig GitPython > > 1.2 In order to install all packages on Fedora, as root do the following: > > - > sudo dnf install gcc gcc-c++ git cmake json-c-devel -y > - > - > sudo dnf install python3-devel python3-Cython python3-numpy python3-pip -y > - > - > sudo dnf install flex valgrind -y > - > - > sudo pip3 install --system pkgconfig GitPython > - > + sudo dnf install gcc gcc-c++ git cmake json-c-devel -y > + sudo dnf install python3-devel python3-Cython python3-numpy python3-pip -y > + sudo dnf install flex valgrind -y > + sudo pip3 install --system pkgconfig GitPython > > 2 In order to install all third party libraries do the following: > > - > git clone https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ > - > - > cd libtraceevent > - > - > make > - > - > sudo make install > - > - > cd .. > - > - > - > git clone https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/ > - > - > cd libtracefs > - > - > make > - > - > sudo make install > - > - > cd .. > - > - > - > git clone https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/ > - > - > cd trace-cmd > - > - > make > - > - > sudo make install_libs > - > - > cd .. > - > - > - > git clone https://git.kernel.org/pub/scm/utils/trace-cmd/kernel-shark.git/ > - > - > cd kernel-shark/build > - > - > cmake .. > - > - > make > - > - > sudo make install > - > - > cd ../.. > + git clone https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ > + cd libtraceevent > + make > + sudo make install > + cd .. > + > + git clone https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/ > + cd libtracefs > + make > + sudo make install > + cd .. > + > + git clone https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/ > + cd trace-cmd > + make > + sudo make install_libs > + cd .. > + > + git clone https://git.kernel.org/pub/scm/utils/trace-cmd/kernel-shark.git/ > + cd kernel-shark/build > + cmake .. > + make > + sudo make install > + cd ../.. > > ### Build & Run > > Installing trace-cruncher is very simple. After downloading the source code, you just have to run: > > - > cd trace-cruncher > + cd trace-cruncher > + make > + sudo make install > + > +### Testing > > - > make > +To execute the unit tests run the following from the `trace-cruncher/tests` directory: > > - > sudo make install > + sudo python3 -m unittest discover . > > ## Documentation > For questions about the use of Trace-Cruncher, please send email to: linux-trace-users@xxxxxxxxxxxxxxx > -- > 2.25.1 > -- Tzvetomir (Ceco) Stoyanov VMware Open Source Technology Center