From nobody Thu May 2 03:10:41 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1586865190; cv=none; d=zohomail.com; s=zohoarc; b=iFVYPhlQe2ghkCf1ctQeRCGmttwtA9sSMiOPafcdJwf42SleN536TxSTG+hAuA5f182xQBj93fNi9/oKPsQVYFw5kXOS7Biq6BpT65hUCdrQcO0iRmzggTIgOertpvPJNo7eV2n3mwGWbDYFuRT8H9zMW8xguleF4kV6NRpb6PM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586865190; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=jpQgWwv0YcCdj0xbAhNeDkOjHofZVcqf0BTNLYpzbc0=; b=XBHCY2/kZwVrmVVfTdjEn/GviYAXsltgarSFiOeMI6habl/AT8sX+PDriNMHF8Gz71Wp3AM9RjUiQEd0C0T/j4FuioukOdtBLh1/OyQBovsX9c7wLI2fjhzL87BFNXv3otMezxl1TB2gSQMmDf9cvPhBZeD/Z9LLR/UWRNERL+c= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1586865190063775.9371331918054; Tue, 14 Apr 2020 04:53:10 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-67-aYn2ueLhMzCnPs4kvxqTjg-1; Tue, 14 Apr 2020 07:52:43 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 643F98018B3; Tue, 14 Apr 2020 11:52:37 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id CFD6260BE2; Tue, 14 Apr 2020 11:52:36 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id C671193068; Tue, 14 Apr 2020 11:52:35 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 03EBqYaI029641 for ; Tue, 14 Apr 2020 07:52:34 -0400 Received: by smtp.corp.redhat.com (Postfix) id 0B91F126519; Tue, 14 Apr 2020 11:52:34 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.64]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 60B44126518 for ; Tue, 14 Apr 2020 11:52:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586865188; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=jpQgWwv0YcCdj0xbAhNeDkOjHofZVcqf0BTNLYpzbc0=; b=bUNZY2vscfnJrnr2DNNF0tV9GzB+5CZakIJk/t1FApPLbaDkuPDeEo/R+GQWRPtKBXysh2 dKH7EG6JLEjAbg2IEJWgQVN6ZBhVYqkJ6GuO9GwunAz6MIixwVgVsKUWjHLwmo4yLMuxnV dbK/TVhncdvZksr8GEVT1deITj6EqJM= X-MC-Unique: aYn2ueLhMzCnPs4kvxqTjg-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH] Convert all remaining Markdown files to reStructuredText Date: Tue, 14 Apr 2020 13:52:25 +0200 Message-Id: <20200414115225.312702-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani Reviewed-by: J=C3=A1n Tomko --- Note that I've taken a few liberties during the conversion when it comes to formatting, with the goal of staying close to the style used for existing reStructuredText documents, but I have not altered the contents beyond that. ABOUT-NLS | 2 +- Makefile.am | 2 +- README | 2 +- README.md =3D> README.rst | 55 ++++++++++++----------- docs/Makefile.am | 2 +- docs/fonts/{LICENSE.md =3D> LICENSE.rst} | 30 +++++++++---- libvirt.spec.in | 2 +- po/{README.md =3D> README.rst} | 32 ++++++++----- tools/wireshark/{README.md =3D> README.rst} | 28 ++++++++---- 9 files changed, 97 insertions(+), 58 deletions(-) rename README.md =3D> README.rst (65%) rename docs/fonts/{LICENSE.md =3D> LICENSE.rst} (94%) rename po/{README.md =3D> README.rst} (86%) rename tools/wireshark/{README.md =3D> README.rst} (52%) diff --git a/ABOUT-NLS b/ABOUT-NLS index b583e276a7..91a3266ed6 120000 --- a/ABOUT-NLS +++ b/ABOUT-NLS @@ -1 +1 @@ -po/README.md \ No newline at end of file +po/README.rst \ No newline at end of file diff --git a/Makefile.am b/Makefile.am index 5590c88e4d..06475344c1 100644 --- a/Makefile.am +++ b/Makefile.am @@ -43,7 +43,7 @@ EXTRA_DIST =3D \ autogen.sh \ GNUmakefile \ run.in \ - README.md \ + README.rst \ AUTHORS.in \ scripts/apibuild.py \ scripts/augeas-gentest.py \ diff --git a/README b/README index 42061c01a1..92cacd2853 120000 --- a/README +++ b/README @@ -1 +1 @@ -README.md \ No newline at end of file +README.rst \ No newline at end of file diff --git a/README.md b/README.rst similarity index 65% rename from README.md rename to README.rst index 44b0dd87c5..663fba4510 100644 --- a/README.md +++ b/README.rst @@ -1,6 +1,9 @@ -[![Build Status](https://travis-ci.org/libvirt/libvirt.svg)](https://travi= s-ci.org/libvirt/libvirt) - [![CII Best Practices](https://bestpractices.coreinfrastructure.org/proje= cts/355/badge)](https://bestpractices.coreinfrastructure.org/projects/355) +.. image:: https://travis-ci.org/libvirt/libvirt.svg + :alt: Travis CI Build Status +.. image:: https://bestpractices.coreinfrastructure.org/projects/355/badge + :alt: CII Best Practices =20 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D Libvirt API for virtualization =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D =20 @@ -21,66 +24,66 @@ mappings into object systems such as GObject, CIM and S= NMP. Further information about the libvirt project can be found on the website: =20 -[https://libvirt.org](https://libvirt.org) +https://libvirt.org =20 =20 License -------- +=3D=3D=3D=3D=3D=3D=3D =20 The libvirt C API is distributed under the terms of GNU Lesser General Public License, version 2.1 (or later). Some parts of the code that are not part of the C library may have the more restrictive GNU General -Public License, version 2.0 (or later). See the files `COPYING.LESSER` -and `COPYING` for full license terms & conditions. +Public License, version 2.0 (or later). See the files ``COPYING.LESSER`` +and ``COPYING`` for full license terms & conditions. =20 =20 Installation ------------- +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 Libvirt uses the GNU Autotools build system, so in general can be built and installed with the usual commands, however, we mandate to have the build directory different than the source directory. For example, to build in a manner that is suitable for installing as root, use: =20 -``` -$ mkdir build && cd build -$ ../configure --prefix=3D/usr --sysconfdir=3D/etc --localstatedir=3D/var -$ make -$ sudo make install -``` +:: + + $ mkdir build && cd build + $ ../configure --prefix=3D/usr --sysconfdir=3D/etc --localstatedir=3D/var + $ make + $ sudo make install =20 While to build & install as an unprivileged user =20 -``` -$ mkdir build && cd build -$ ../configure --prefix=3D$HOME/usr -$ make -$ make install -``` +:: + + $ mkdir build && cd build + $ ../configure --prefix=3D$HOME/usr + $ make + $ make install =20 The libvirt code relies on a large number of 3rd party libraries. These wi= ll -be detected during execution of the `configure` script and a summary print= ed +be detected during execution of the ``configure`` script and a summary pri= nted which lists any missing (optional) dependencies. =20 =20 Contributing ------------- +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The libvirt project welcomes contributions in many ways. For most componen= ts the best way to contribute is to send patches to the primary development mailing list. Further guidance on this can be found on the website: =20 -[https://libvirt.org/contribute.html](https://libvirt.org/contribute.html) +https://libvirt.org/contribute.html =20 =20 Contact -------- +=3D=3D=3D=3D=3D=3D=3D =20 The libvirt project has two primary mailing lists: =20 - * libvirt-users@redhat.com (**for user discussions**) - * libvir-list@redhat.com (**for development only**) +* libvirt-users@redhat.com (**for user discussions**) +* libvir-list@redhat.com (**for development only**) =20 Further details on contacting the project are available on the website: =20 -[https://libvirt.org/contact.html](https://libvirt.org/contact.html) +https://libvirt.org/contact.html diff --git a/docs/Makefile.am b/docs/Makefile.am index 404121a2a2..6860efc888 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -118,7 +118,7 @@ javascriptdir =3D $(HTML_DIR)/js javascript_DATA =3D $(javascript) =20 fonts =3D \ - fonts/LICENSE.md \ + fonts/LICENSE.rst \ fonts/stylesheet.css \ fonts/overpass-bold-italic.woff \ fonts/overpass-bold.woff \ diff --git a/docs/fonts/LICENSE.md b/docs/fonts/LICENSE.rst similarity index 94% rename from docs/fonts/LICENSE.md rename to docs/fonts/LICENSE.rst index 9520f30f73..4e32b1a1d3 100644 --- a/docs/fonts/LICENSE.md +++ b/docs/fonts/LICENSE.rst @@ -1,18 +1,24 @@ -## License +=3D=3D=3D=3D=3D=3D=3D +License +=3D=3D=3D=3D=3D=3D=3D =20 Copyright (C) 2015 Red Hat, Inc., =20 This Font Software is licensed under the SIL Open Font License, Version 1.= 1. This license is copied below, and is also available with a FAQ at: + http://scripts.sil.org/OFL =20 =20 -#### SIL OPEN FONT LICENSE +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +SIL OPEN FONT LICENSE +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + Version 1.1 - 26 February 2007 =20 ---- +PREAMBLE +=3D=3D=3D=3D=3D=3D=3D=3D =20 -#### PREAMBLE The goals of the Open Font License (OFL) are to stimulate worldwide develo= pment of collaborative font projects, to support the font creation efforts of academic and linguistic communities, and to provide a free and open framew= ork @@ -27,7 +33,9 @@ any other type of license. The requirement for fonts to r= emain under this license does not apply to any document created using the fonts or their derivatives. =20 -#### DEFINITIONS +DEFINITIONS +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + =E2=80=9CFont Software=E2=80=9D refers to the set of files released by the= Copyright Holder(s) under this license and clearly marked as such. This may include source fil= es, build scripts and documentation. @@ -45,7 +53,9 @@ by changing formats or by porting the Font Software to a = new environment. =E2=80=9CAuthor=E2=80=9D refers to any designer, engineer, programmer, tec= hnical writer or other person who contributed to the Font Software. =20 -#### PERMISSION & CONDITIONS +PERMISSION & CONDITIONS +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + Permission is hereby granted, free of charge, to any person obtaining a co= py of the Font Software, to use, study, copy, merge, embed, modify, redistribute= , and sell modified and unmodified copies of the Font Software, subject to the @@ -76,10 +86,14 @@ distributed entirely under this license, and must not b= e distributed under any other license. The requirement for fonts to remain under this license does= not apply to any document created using the Font Software. =20 -#### TERMINATION +TERMINATION +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + This license becomes null and void if any of the above conditions are not = met. =20 -#### DISCLAIMER +DISCLAIMER +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + THE FONT SOFTWARE IS PROVIDED =E2=80=9CAS IS=E2=80=9D, WITHOUT WARRANTY OF= ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, diff --git a/libvirt.spec.in b/libvirt.spec.in index 6061a26497..6abf97df85 100644 --- a/libvirt.spec.in +++ b/libvirt.spec.in @@ -1505,7 +1505,7 @@ exit 0 %files =20 %files docs -%doc AUTHORS ChangeLog NEWS README README.md +%doc AUTHORS ChangeLog NEWS README README.rst %doc %{_vpath_builddir}/libvirt-docs/* =20 %files daemon diff --git a/po/README.md b/po/README.rst similarity index 86% rename from po/README.md rename to po/README.rst index 2f77c5d48c..2e234547ca 100644 --- a/po/README.md +++ b/po/README.rst @@ -1,3 +1,4 @@ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D Libvirt Message Translation =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D =20 @@ -7,6 +8,7 @@ file formats, in combination with the Zanata web service. python-zanata-client is required in order to use make to pull/push transla= tions from/to Zanata server. =20 + Source repository =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -14,21 +16,25 @@ The libvirt GIT repository does NOT store the master "l= ibvirt.pot" file, nor does it store full "po" files for translations. The master "libvirt.pot" f= ile can be generated at any time using =20 - make libvirt.pot +:: + + $ make libvirt.pot =20 The translations are kept in minimized files that are the same file format as normal po files but with all redundant information stripped and messages re-ordered. The key differences between the ".mini.po" files in GIT and the full ".po" files are =20 - - msgids with no current translation are omitted - - msgids are sorted in alphabetical order not source file order - - msgids with a msgstr marked "fuzzy" are discarded - - source file locations are omitted +* msgids with no current translation are omitted +* msgids are sorted in alphabetical order not source file order +* msgids with a msgstr marked "fuzzy" are discarded +* source file locations are omitted =20 The full po files can be created at any time using =20 - make update-po +:: + + $ make update-po =20 This merges the "libvirt.pot" with the "$LANG.mini.po" for each language, = to create the "$LANG.po" files. These are included in the release archives cr= eated @@ -37,7 +43,9 @@ by "make dist". When a full po file is updated, changes can be propagated back into the minimized po files using =20 - make update-mini-po +:: + + $ make update-mini-po =20 Note, however, that this is generally not something that should be run by developers normally, as it is triggered by 'make pull-po' when refreshing @@ -50,7 +58,7 @@ Zanata web service The translation of libvirt messages has been outsourced to the Fedora translation team using the Zanata web service: =20 - https://fedora.zanata.org/project/view/libvirt +https://fedora.zanata.org/project/view/libvirt =20 As such, changes to translations will generally NOT be accepted as patches directly to libvirt GIT. Any changes made to "$LANG.mini.po" files in libv= irt @@ -59,12 +67,16 @@ GIT will be overwritten and lost the next time content = is imported from Zanata. The master "libvirt.pot" file is periodically pushed to Zanata to provide = the translation team with content changes, using =20 - make push-pot +:: + + $ make push-pot =20 New translated text is then periodically pulled down from Zanata to update= the minimized po files, using =20 - make pull-po +:: + + $ make pull-po =20 Sometimes the translators make mistakes, most commonly with handling printf format specifiers. The "pull-po" command re-generates the .gmo files to tr= y to diff --git a/tools/wireshark/README.md b/tools/wireshark/README.rst similarity index 52% rename from tools/wireshark/README.md rename to tools/wireshark/README.rst index b7f40d0954..919b89d32a 100644 --- a/tools/wireshark/README.md +++ b/tools/wireshark/README.rst @@ -1,5 +1,7 @@ +=3D=3D=3D=3D=3D About =3D=3D=3D=3D=3D + This is the project of Google Summer of Code 2013 accepted by QEMU.org and libvirt community. The goal of this project is, provide Wireshark dissect= or for Libvirt RPC protocol. It will provide Libvirt packet overview/detail analy= sing @@ -8,24 +10,32 @@ definition placed in Libvirt source tree to support late= st protocol specification. =20 See also: -- http://www.google-melange.com/gsoc/project/google/gsoc2013/kawamuray/7001 -- https://wiki.qemu.org/Features/LibvirtWiresharkDissector + +* http://www.google-melange.com/gsoc/project/google/gsoc2013/kawamuray/7001 +* https://wiki.qemu.org/Features/LibvirtWiresharkDissector + =20 Installation =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -Run ./configure with --with-wireshark-dissector option enabled. + +Run ``./configure`` with ``--with-wireshark-dissector`` option enabled. Then dissector will compiled with libvirt itself. =20 Add/Remove protocol from dissector's support -------------------------------------------- -Modify variable WS\_DISSECTOR\_PROTO\_FILES in tools/wireshark/src/Makefil= e.am. + +Modify variable ``WS_DISSECTOR_PROTO_FILES`` +in ``tools/wireshark/src/Makefile.am``. =20 Changing installation directory ------------------------------- -You can change installation directory of pluggable shared object(libvirt.s= o) by -specifying --with-ws-plugindir=3D. =20 -You can install libvirt.so into your local wireshark plugin directory: +You can change installation directory of pluggable shared +object(``libvirt.so``) by specifying ``--with-ws-plugindir=3D``. + +You can install ``libvirt.so`` into your local wireshark plugin directory: + +:: =20 - ./configure --with-wireshark-dissector \ - --with-ws-plugindir=3D$HOME/.wireshark/plugins + $ ./configure --with-wireshark-dissector \ + --with-ws-plugindir=3D$HOME/.wireshark/plugins --=20 2.25.2