docs: Add programming-languages.rst

Most new contributors are probably going to modify existing code rather
than introducing all-new programs and scripts, and even when the latter
happen they'll hopefully get a feel for which programming languages are
considered acceptable for the project by looking at what's already in
the repo. Make this part less prominent by moving it to a separate page.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
Andrea Bolognani 2020-04-06 14:45:11 +02:00
parent 5155f6f4b1
commit 94153862ab
2 changed files with 21 additions and 21 deletions

View File

@ -322,27 +322,6 @@ background reading on the subject, on `Richard Jones' guide to
working with open source
projects <http://people.redhat.com/rjones/how-to-supply-code-to-open-source-projects/>`__.
Language Usage
==============
The libvirt repository makes use of a large number of programming
languages. It is anticipated that in the future libvirt will adopt
use of other new languages. To reduce the overall burden on
developers, there is thus a general desire to phase out usage of
some of the existing languages.
The preferred languages at this time are:
- C - for the main libvirt codebase. Dialect supported by
GCC/CLang only.
- Python - for supporting build scripts / tools. Code must run
with both version 2.7 and 3.x at this time.
Languages that should not be used for any new contributions:
- Perl - build scripts must be written in Python instead.
- Shell - build scripts must be written in Python instead.
Tooling
=======

View File

@ -0,0 +1,21 @@
=====================
Programming languages
=====================
The libvirt repository makes use of a large number of programming
languages. It is anticipated that in the future libvirt will adopt
use of other new languages. To reduce the overall burden on
developers, there is thus a general desire to phase out usage of
some of the existing languages.
The preferred languages at this time are:
- C - for the main libvirt codebase. Dialect supported by
GCC/CLang only.
- Python - for supporting build scripts / tools. Code must run
with both version 2.7 and 3.x at this time.
Languages that should not be used for any new contributions:
- Perl - build scripts must be written in Python instead.
- Shell - build scripts must be written in Python instead.