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(a)redhat.com>
---
docs/hacking.rst | 21 ---------------------
docs/programming-languages.rst | 21 +++++++++++++++++++++
2 files changed, 21 insertions(+), 21 deletions(-)
create mode 100644 docs/programming-languages.rst
diff --git a/docs/hacking.rst b/docs/hacking.rst
index 356dbc506b..89f8f412c1 100644
--- a/docs/hacking.rst
+++ b/docs/hacking.rst
@@ -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-project....
-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
=======
diff --git a/docs/programming-languages.rst b/docs/programming-languages.rst
new file mode 100644
index 0000000000..9d7dbdcd37
--- /dev/null
+++ b/docs/programming-languages.rst
@@ -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.
--
2.25.1