2017-07-17 15:46:36 -06:00
|
|
|
#!/usr/bin/perl
|
2019-05-27 00:55:06 -06:00
|
|
|
# SPDX-License-Identifier: GPL-2.0-or-later
|
2017-07-17 15:46:36 -06:00
|
|
|
use strict;
|
|
|
|
|
2019-05-29 17:09:24 -06:00
|
|
|
# Copyright (c) 2017-2019 Mauro Carvalho Chehab <mchehab@kernel.org>
|
2017-07-17 15:46:36 -06:00
|
|
|
#
|
|
|
|
|
2019-06-23 23:25:07 -06:00
|
|
|
my $prefix = "./";
|
|
|
|
$prefix = "$ENV{'srctree'}/" if ($ENV{'srctree'});
|
|
|
|
|
|
|
|
my $conf = $prefix . "Documentation/conf.py";
|
|
|
|
my $requirement_file = $prefix . "Documentation/sphinx/requirements.txt";
|
2019-05-29 17:09:24 -06:00
|
|
|
my $virtenv_prefix = "sphinx_";
|
2017-07-17 15:46:37 -06:00
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
#
|
|
|
|
# Static vars
|
|
|
|
#
|
|
|
|
|
|
|
|
my %missing;
|
|
|
|
my $system_release;
|
|
|
|
my $need = 0;
|
|
|
|
my $optional = 0;
|
|
|
|
my $need_symlink = 0;
|
|
|
|
my $need_sphinx = 0;
|
2019-05-22 15:43:46 -06:00
|
|
|
my $rec_sphinx_upgrade = 0;
|
2017-07-17 15:46:36 -06:00
|
|
|
my $install = "";
|
2019-05-29 17:09:24 -06:00
|
|
|
my $virtenv_dir = "";
|
|
|
|
my $min_version;
|
2017-07-17 15:46:36 -06:00
|
|
|
|
|
|
|
#
|
|
|
|
# Command line arguments
|
|
|
|
#
|
|
|
|
|
|
|
|
my $pdf = 1;
|
|
|
|
my $virtualenv = 1;
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
my $version_check = 0;
|
2017-07-17 15:46:36 -06:00
|
|
|
|
|
|
|
#
|
|
|
|
# List of required texlive packages on Fedora and OpenSuse
|
|
|
|
#
|
|
|
|
|
|
|
|
my %texlive = (
|
|
|
|
'amsfonts.sty' => 'texlive-amsfonts',
|
|
|
|
'amsmath.sty' => 'texlive-amsmath',
|
|
|
|
'amssymb.sty' => 'texlive-amsfonts',
|
|
|
|
'amsthm.sty' => 'texlive-amscls',
|
|
|
|
'anyfontsize.sty' => 'texlive-anyfontsize',
|
|
|
|
'atbegshi.sty' => 'texlive-oberdiek',
|
|
|
|
'bm.sty' => 'texlive-tools',
|
|
|
|
'capt-of.sty' => 'texlive-capt-of',
|
|
|
|
'cmap.sty' => 'texlive-cmap',
|
|
|
|
'ecrm1000.tfm' => 'texlive-ec',
|
|
|
|
'eqparbox.sty' => 'texlive-eqparbox',
|
|
|
|
'eu1enc.def' => 'texlive-euenc',
|
|
|
|
'fancybox.sty' => 'texlive-fancybox',
|
|
|
|
'fancyvrb.sty' => 'texlive-fancyvrb',
|
|
|
|
'float.sty' => 'texlive-float',
|
|
|
|
'fncychap.sty' => 'texlive-fncychap',
|
|
|
|
'footnote.sty' => 'texlive-mdwtools',
|
|
|
|
'framed.sty' => 'texlive-framed',
|
|
|
|
'luatex85.sty' => 'texlive-luatex85',
|
|
|
|
'multirow.sty' => 'texlive-multirow',
|
|
|
|
'needspace.sty' => 'texlive-needspace',
|
|
|
|
'palatino.sty' => 'texlive-psnfss',
|
|
|
|
'parskip.sty' => 'texlive-parskip',
|
|
|
|
'polyglossia.sty' => 'texlive-polyglossia',
|
|
|
|
'tabulary.sty' => 'texlive-tabulary',
|
|
|
|
'threeparttable.sty' => 'texlive-threeparttable',
|
|
|
|
'titlesec.sty' => 'texlive-titlesec',
|
|
|
|
'ucs.sty' => 'texlive-ucs',
|
|
|
|
'upquote.sty' => 'texlive-upquote',
|
|
|
|
'wrapfig.sty' => 'texlive-wrapfig',
|
|
|
|
);
|
|
|
|
|
|
|
|
#
|
|
|
|
# Subroutines that checks if a feature exists
|
|
|
|
#
|
|
|
|
|
|
|
|
sub check_missing(%)
|
|
|
|
{
|
|
|
|
my %map = %{$_[0]};
|
|
|
|
|
|
|
|
foreach my $prog (sort keys %missing) {
|
|
|
|
my $is_optional = $missing{$prog};
|
|
|
|
|
|
|
|
if ($is_optional) {
|
|
|
|
print "Warning: better to also install \"$prog\".\n";
|
|
|
|
} else {
|
|
|
|
print "ERROR: please install \"$prog\", otherwise, build won't work.\n";
|
|
|
|
}
|
|
|
|
if (defined($map{$prog})) {
|
|
|
|
$install .= " " . $map{$prog};
|
|
|
|
} else {
|
|
|
|
$install .= " " . $prog;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
$install =~ s/^\s//;
|
|
|
|
}
|
|
|
|
|
|
|
|
sub add_package($$)
|
|
|
|
{
|
|
|
|
my $package = shift;
|
|
|
|
my $is_optional = shift;
|
|
|
|
|
|
|
|
$missing{$package} = $is_optional;
|
|
|
|
if ($is_optional) {
|
|
|
|
$optional++;
|
|
|
|
} else {
|
|
|
|
$need++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_missing_file($$$)
|
|
|
|
{
|
|
|
|
my $file = shift;
|
|
|
|
my $package = shift;
|
|
|
|
my $is_optional = shift;
|
|
|
|
|
|
|
|
return if(-e $file);
|
|
|
|
|
|
|
|
add_package($package, $is_optional);
|
|
|
|
}
|
|
|
|
|
|
|
|
sub findprog($)
|
|
|
|
{
|
|
|
|
foreach(split(/:/, $ENV{PATH})) {
|
|
|
|
return "$_/$_[0]" if(-x "$_/$_[0]");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_program($$)
|
|
|
|
{
|
|
|
|
my $prog = shift;
|
|
|
|
my $is_optional = shift;
|
|
|
|
|
|
|
|
return if findprog($prog);
|
|
|
|
|
|
|
|
add_package($prog, $is_optional);
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_perl_module($$)
|
|
|
|
{
|
|
|
|
my $prog = shift;
|
|
|
|
my $is_optional = shift;
|
|
|
|
|
|
|
|
my $err = system("perl -M$prog -e 1 2>/dev/null /dev/null");
|
|
|
|
return if ($err == 0);
|
|
|
|
|
|
|
|
add_package($prog, $is_optional);
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_python_module($$)
|
|
|
|
{
|
|
|
|
my $prog = shift;
|
|
|
|
my $is_optional = shift;
|
|
|
|
|
|
|
|
my $err = system("python3 -c 'import $prog' 2>/dev/null /dev/null");
|
|
|
|
return if ($err == 0);
|
|
|
|
my $err = system("python -c 'import $prog' 2>/dev/null /dev/null");
|
|
|
|
return if ($err == 0);
|
|
|
|
|
|
|
|
add_package($prog, $is_optional);
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_rpm_missing($$)
|
|
|
|
{
|
|
|
|
my @pkgs = @{$_[0]};
|
|
|
|
my $is_optional = $_[1];
|
|
|
|
|
|
|
|
foreach my $prog(@pkgs) {
|
|
|
|
my $err = system("rpm -q '$prog' 2>/dev/null >/dev/null");
|
|
|
|
add_package($prog, $is_optional) if ($err);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_pacman_missing($$)
|
|
|
|
{
|
|
|
|
my @pkgs = @{$_[0]};
|
|
|
|
my $is_optional = $_[1];
|
|
|
|
|
|
|
|
foreach my $prog(@pkgs) {
|
|
|
|
my $err = system("pacman -Q '$prog' 2>/dev/null >/dev/null");
|
|
|
|
add_package($prog, $is_optional) if ($err);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_missing_tex($)
|
|
|
|
{
|
|
|
|
my $is_optional = shift;
|
|
|
|
my $kpsewhich = findprog("kpsewhich");
|
|
|
|
|
|
|
|
foreach my $prog(keys %texlive) {
|
|
|
|
my $package = $texlive{$prog};
|
|
|
|
if (!$kpsewhich) {
|
|
|
|
add_package($package, $is_optional);
|
|
|
|
next;
|
|
|
|
}
|
|
|
|
my $file = qx($kpsewhich $prog);
|
|
|
|
add_package($package, $is_optional) if ($file =~ /^\s*$/);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-05-22 15:43:46 -06:00
|
|
|
sub get_sphinx_fname()
|
2017-07-17 15:46:36 -06:00
|
|
|
{
|
2019-05-22 15:43:46 -06:00
|
|
|
my $fname = "sphinx-build";
|
|
|
|
return $fname if findprog($fname);
|
2017-07-17 15:46:36 -06:00
|
|
|
|
2019-05-22 15:43:46 -06:00
|
|
|
$fname = "sphinx-build-3";
|
|
|
|
if (findprog($fname)) {
|
2017-07-17 15:46:36 -06:00
|
|
|
$need_symlink = 1;
|
2019-05-22 15:43:46 -06:00
|
|
|
return $fname;
|
2017-07-17 15:46:36 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
if ($virtualenv) {
|
2017-07-21 10:20:41 -06:00
|
|
|
my $prog = findprog("virtualenv-3");
|
|
|
|
$prog = findprog("virtualenv-3.5") if (!$prog);
|
|
|
|
|
|
|
|
check_program("virtualenv", 0) if (!$prog);
|
2017-07-17 15:46:36 -06:00
|
|
|
$need_sphinx = 1;
|
|
|
|
} else {
|
|
|
|
add_package("python-sphinx", 0);
|
|
|
|
}
|
2019-05-22 15:43:46 -06:00
|
|
|
|
|
|
|
return "";
|
|
|
|
}
|
|
|
|
|
|
|
|
sub check_sphinx()
|
|
|
|
{
|
|
|
|
my $rec_version;
|
|
|
|
my $cur_version;
|
|
|
|
|
|
|
|
open IN, $conf or die "Can't open $conf";
|
|
|
|
while (<IN>) {
|
|
|
|
if (m/^\s*needs_sphinx\s*=\s*[\'\"]([\d\.]+)[\'\"]/) {
|
|
|
|
$min_version=$1;
|
|
|
|
last;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
close IN;
|
|
|
|
|
|
|
|
die "Can't get needs_sphinx version from $conf" if (!$min_version);
|
|
|
|
|
|
|
|
open IN, $requirement_file or die "Can't open $requirement_file";
|
|
|
|
while (<IN>) {
|
|
|
|
if (m/^\s*Sphinx\s*==\s*([\d\.]+)$/) {
|
|
|
|
$rec_version=$1;
|
|
|
|
last;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
close IN;
|
|
|
|
|
|
|
|
die "Can't get recommended sphinx version from $requirement_file" if (!$min_version);
|
|
|
|
|
2019-05-29 17:09:24 -06:00
|
|
|
$virtenv_dir = $virtenv_prefix . $rec_version;
|
2019-05-22 15:43:46 -06:00
|
|
|
|
|
|
|
my $sphinx = get_sphinx_fname();
|
|
|
|
return if ($sphinx eq "");
|
|
|
|
|
|
|
|
open IN, "$sphinx --version 2>&1 |" or die "$sphinx returned an error";
|
|
|
|
while (<IN>) {
|
|
|
|
if (m/^\s*sphinx-build\s+([\d\.]+)$/) {
|
|
|
|
$cur_version=$1;
|
|
|
|
last;
|
|
|
|
}
|
|
|
|
# Sphinx 1.2.x uses a different format
|
|
|
|
if (m/^\s*Sphinx.*\s+([\d\.]+)$/) {
|
|
|
|
$cur_version=$1;
|
|
|
|
last;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
close IN;
|
|
|
|
|
|
|
|
die "$sphinx didn't return its version" if (!$cur_version);
|
|
|
|
|
|
|
|
if ($cur_version lt $min_version) {
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
printf "ERROR: Sphinx version is %s. It should be >= %s (recommended >= %s)\n",
|
|
|
|
$cur_version, $min_version, $rec_version;;
|
2019-05-22 15:43:46 -06:00
|
|
|
$need_sphinx = 1;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($cur_version lt $rec_version) {
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
printf "Sphinx version %s\n", $cur_version;
|
2019-05-22 15:43:46 -06:00
|
|
|
print "Warning: It is recommended at least Sphinx version $rec_version.\n";
|
|
|
|
$rec_sphinx_upgrade = 1;
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
return;
|
2019-05-22 15:43:46 -06:00
|
|
|
}
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
|
|
|
|
# On version check mode, just assume Sphinx has all mandatory deps
|
|
|
|
exit (0) if ($version_check);
|
2017-07-17 15:46:36 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Ancillary subroutines
|
|
|
|
#
|
|
|
|
|
|
|
|
sub catcheck($)
|
|
|
|
{
|
|
|
|
my $res = "";
|
|
|
|
$res = qx(cat $_[0]) if (-r $_[0]);
|
|
|
|
return $res;
|
|
|
|
}
|
|
|
|
|
|
|
|
sub which($)
|
|
|
|
{
|
|
|
|
my $file = shift;
|
|
|
|
my @path = split ":", $ENV{PATH};
|
|
|
|
|
|
|
|
foreach my $dir(@path) {
|
|
|
|
my $name = $dir.'/'.$file;
|
|
|
|
return $name if (-x $name );
|
|
|
|
}
|
|
|
|
return undef;
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Subroutines that check distro-specific hints
|
|
|
|
#
|
|
|
|
|
|
|
|
sub give_debian_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"python-sphinx" => "python3-sphinx",
|
|
|
|
"sphinx_rtd_theme" => "python3-sphinx-rtd-theme",
|
|
|
|
"virtualenv" => "virtualenv",
|
|
|
|
"dot" => "graphviz",
|
|
|
|
"convert" => "imagemagick",
|
|
|
|
"Pod::Usage" => "perl-modules",
|
|
|
|
"xelatex" => "texlive-xetex",
|
2017-07-17 15:46:40 -06:00
|
|
|
"rsvg-convert" => "librsvg2-bin",
|
2017-07-17 15:46:36 -06:00
|
|
|
);
|
|
|
|
|
|
|
|
if ($pdf) {
|
|
|
|
check_missing_file("/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
|
|
|
|
"fonts-dejavu", 1);
|
|
|
|
}
|
|
|
|
|
|
|
|
check_program("dvipng", 1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
|
|
|
printf("You should run:\n\n\tsudo apt-get install $install\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
sub give_redhat_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"python-sphinx" => "python3-sphinx",
|
|
|
|
"sphinx_rtd_theme" => "python3-sphinx_rtd_theme",
|
|
|
|
"virtualenv" => "python3-virtualenv",
|
|
|
|
"dot" => "graphviz",
|
|
|
|
"convert" => "ImageMagick",
|
|
|
|
"Pod::Usage" => "perl-Pod-Usage",
|
|
|
|
"xelatex" => "texlive-xetex-bin",
|
2017-07-17 15:46:40 -06:00
|
|
|
"rsvg-convert" => "librsvg2-tools",
|
2017-07-17 15:46:36 -06:00
|
|
|
);
|
|
|
|
|
2017-07-17 15:46:39 -06:00
|
|
|
my @fedora26_opt_pkgs = (
|
|
|
|
"graphviz-gd", # Fedora 26: needed for PDF support
|
|
|
|
);
|
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
my @fedora_tex_pkgs = (
|
|
|
|
"texlive-collection-fontsrecommended",
|
|
|
|
"texlive-collection-latex",
|
|
|
|
"dejavu-sans-fonts",
|
|
|
|
"dejavu-serif-fonts",
|
|
|
|
"dejavu-sans-mono-fonts",
|
|
|
|
);
|
|
|
|
|
scripts/sphinx-pre-install: add minimum support for RHEL
RHEL 7.x and clone distros are shipped with Sphinx 1.1.x,
with is incompatible with Kernel ReST markups.
So, on those systems, the only alternative is to install
it via a Python virtual environment.
While seeking for "pip" on CentOS 7.3, I noticed that it
is not really needed, as python-virtualenv has its version
packaged there already. So, remove this from the list of
requirements for all distributions.
With regards to PDF, we need at least texlive-tabulary
extension, but that is not shipped there (at least on
CentOS). So, disable PDF packages as a whole.
Please notice, however, that texlive + amsmath is needed for
ReST to properly handle ReST ".. math::" tags. Yet, Sphinx
fall back to display the LaTeX math expressions as-is, if
such extension is not available.
So, let's just disable all texlive packages as a whole.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2017-07-24 06:09:24 -06:00
|
|
|
#
|
|
|
|
# Checks valid for RHEL/CentOS version 7.x.
|
|
|
|
#
|
|
|
|
if (! $system_release =~ /Fedora/) {
|
|
|
|
$map{"virtualenv"} = "python-virtualenv";
|
|
|
|
}
|
|
|
|
|
2017-07-17 15:46:39 -06:00
|
|
|
my $release;
|
|
|
|
|
|
|
|
$release = $1 if ($system_release =~ /Fedora\s+release\s+(\d+)/);
|
|
|
|
|
|
|
|
check_rpm_missing(\@fedora26_opt_pkgs, 1) if ($pdf && $release >= 26);
|
2017-07-17 15:46:36 -06:00
|
|
|
check_rpm_missing(\@fedora_tex_pkgs, 1) if ($pdf);
|
|
|
|
check_missing_tex(1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
scripts/sphinx-pre-install: add minimum support for RHEL
RHEL 7.x and clone distros are shipped with Sphinx 1.1.x,
with is incompatible with Kernel ReST markups.
So, on those systems, the only alternative is to install
it via a Python virtual environment.
While seeking for "pip" on CentOS 7.3, I noticed that it
is not really needed, as python-virtualenv has its version
packaged there already. So, remove this from the list of
requirements for all distributions.
With regards to PDF, we need at least texlive-tabulary
extension, but that is not shipped there (at least on
CentOS). So, disable PDF packages as a whole.
Please notice, however, that texlive + amsmath is needed for
ReST to properly handle ReST ".. math::" tags. Yet, Sphinx
fall back to display the LaTeX math expressions as-is, if
such extension is not available.
So, let's just disable all texlive packages as a whole.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2017-07-24 06:09:24 -06:00
|
|
|
|
|
|
|
if ($release >= 18) {
|
|
|
|
# dnf, for Fedora 18+
|
|
|
|
printf("You should run:\n\n\tsudo dnf install -y $install\n");
|
|
|
|
} else {
|
|
|
|
# yum, for RHEL (and clones) or Fedora version < 18
|
|
|
|
printf("You should run:\n\n\tsudo yum install -y $install\n");
|
|
|
|
}
|
2017-07-17 15:46:36 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
sub give_opensuse_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"python-sphinx" => "python3-sphinx",
|
|
|
|
"sphinx_rtd_theme" => "python3-sphinx_rtd_theme",
|
|
|
|
"virtualenv" => "python3-virtualenv",
|
|
|
|
"dot" => "graphviz",
|
|
|
|
"convert" => "ImageMagick",
|
|
|
|
"Pod::Usage" => "perl-Pod-Usage",
|
|
|
|
"xelatex" => "texlive-xetex-bin",
|
2017-07-17 15:46:40 -06:00
|
|
|
"rsvg-convert" => "rsvg-view",
|
2017-07-17 15:46:36 -06:00
|
|
|
);
|
|
|
|
|
|
|
|
my @suse_tex_pkgs = (
|
|
|
|
"texlive-babel-english",
|
|
|
|
"texlive-caption",
|
|
|
|
"texlive-colortbl",
|
|
|
|
"texlive-courier",
|
|
|
|
"texlive-dvips",
|
|
|
|
"texlive-helvetic",
|
|
|
|
"texlive-makeindex",
|
|
|
|
"texlive-metafont",
|
|
|
|
"texlive-metapost",
|
|
|
|
"texlive-palatino",
|
|
|
|
"texlive-preview",
|
|
|
|
"texlive-times",
|
|
|
|
"texlive-zapfchan",
|
|
|
|
"texlive-zapfding",
|
|
|
|
);
|
|
|
|
|
|
|
|
check_rpm_missing(\@suse_tex_pkgs, 1) if ($pdf);
|
|
|
|
check_missing_tex(1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
|
|
|
printf("You should run:\n\n\tsudo zypper install --no-recommends $install\n");
|
|
|
|
}
|
|
|
|
|
2017-07-21 10:20:41 -06:00
|
|
|
sub give_mageia_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"python-sphinx" => "python3-sphinx",
|
|
|
|
"sphinx_rtd_theme" => "python3-sphinx_rtd_theme",
|
|
|
|
"virtualenv" => "python3-virtualenv",
|
|
|
|
"dot" => "graphviz",
|
|
|
|
"convert" => "ImageMagick",
|
|
|
|
"Pod::Usage" => "perl-Pod-Usage",
|
|
|
|
"xelatex" => "texlive",
|
|
|
|
"rsvg-convert" => "librsvg2-tools",
|
|
|
|
);
|
|
|
|
|
|
|
|
my @tex_pkgs = (
|
|
|
|
"texlive-fontsextra",
|
|
|
|
);
|
|
|
|
|
|
|
|
check_rpm_missing(\@tex_pkgs, 1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
|
|
|
printf("You should run:\n\n\tsudo urpmi $install\n");
|
|
|
|
}
|
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
sub give_arch_linux_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"sphinx_rtd_theme" => "python-sphinx_rtd_theme",
|
|
|
|
"virtualenv" => "python-virtualenv",
|
|
|
|
"dot" => "graphviz",
|
|
|
|
"convert" => "imagemagick",
|
|
|
|
"xelatex" => "texlive-bin",
|
2017-07-17 15:46:40 -06:00
|
|
|
"rsvg-convert" => "extra/librsvg",
|
2017-07-17 15:46:36 -06:00
|
|
|
);
|
|
|
|
|
|
|
|
my @archlinux_tex_pkgs = (
|
|
|
|
"texlive-core",
|
|
|
|
"texlive-latexextra",
|
|
|
|
"ttf-dejavu",
|
|
|
|
);
|
|
|
|
check_pacman_missing(\@archlinux_tex_pkgs, 1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
|
|
|
printf("You should run:\n\n\tsudo pacman -S $install\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
sub give_gentoo_hints()
|
|
|
|
{
|
|
|
|
my %map = (
|
|
|
|
"sphinx_rtd_theme" => "dev-python/sphinx_rtd_theme",
|
|
|
|
"virtualenv" => "dev-python/virtualenv",
|
|
|
|
"dot" => "media-gfx/graphviz",
|
|
|
|
"convert" => "media-gfx/imagemagick",
|
|
|
|
"xelatex" => "dev-texlive/texlive-xetex media-fonts/dejavu",
|
2017-07-17 15:46:40 -06:00
|
|
|
"rsvg-convert" => "gnome-base/librsvg",
|
2017-07-17 15:46:36 -06:00
|
|
|
);
|
|
|
|
|
|
|
|
check_missing_file("/usr/share/fonts/dejavu/DejaVuSans.ttf",
|
|
|
|
"media-fonts/dejavu", 1) if ($pdf);
|
|
|
|
|
|
|
|
check_missing(\%map);
|
|
|
|
|
|
|
|
return if (!$need && !$optional);
|
2017-07-17 15:46:41 -06:00
|
|
|
|
|
|
|
printf("You should run:\n\n");
|
|
|
|
printf("\tsudo su -c 'echo \"media-gfx/imagemagick svg png\" > /etc/portage/package.use/imagemagick'\n");
|
|
|
|
printf("\tsudo su -c 'echo \"media-gfx/graphviz cairo pdf\" > /etc/portage/package.use/graphviz'\n");
|
|
|
|
printf("\tsudo emerge --ask $install\n");
|
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
sub check_distros()
|
|
|
|
{
|
|
|
|
# Distro-specific hints
|
|
|
|
if ($system_release =~ /Red Hat Enterprise Linux/) {
|
|
|
|
give_redhat_hints;
|
|
|
|
return;
|
|
|
|
}
|
scripts/sphinx-pre-install: add minimum support for RHEL
RHEL 7.x and clone distros are shipped with Sphinx 1.1.x,
with is incompatible with Kernel ReST markups.
So, on those systems, the only alternative is to install
it via a Python virtual environment.
While seeking for "pip" on CentOS 7.3, I noticed that it
is not really needed, as python-virtualenv has its version
packaged there already. So, remove this from the list of
requirements for all distributions.
With regards to PDF, we need at least texlive-tabulary
extension, but that is not shipped there (at least on
CentOS). So, disable PDF packages as a whole.
Please notice, however, that texlive + amsmath is needed for
ReST to properly handle ReST ".. math::" tags. Yet, Sphinx
fall back to display the LaTeX math expressions as-is, if
such extension is not available.
So, let's just disable all texlive packages as a whole.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2017-07-24 06:09:24 -06:00
|
|
|
if ($system_release =~ /CentOS/) {
|
|
|
|
give_redhat_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /Scientific Linux/) {
|
|
|
|
give_redhat_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /Oracle Linux Server/) {
|
|
|
|
give_redhat_hints;
|
|
|
|
return;
|
|
|
|
}
|
2017-07-17 15:46:36 -06:00
|
|
|
if ($system_release =~ /Fedora/) {
|
|
|
|
give_redhat_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /Ubuntu/) {
|
|
|
|
give_debian_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /Debian/) {
|
|
|
|
give_debian_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /openSUSE/) {
|
|
|
|
give_opensuse_hints;
|
|
|
|
return;
|
|
|
|
}
|
2017-07-21 10:20:41 -06:00
|
|
|
if ($system_release =~ /Mageia/) {
|
|
|
|
give_mageia_hints;
|
|
|
|
return;
|
|
|
|
}
|
2017-07-17 15:46:36 -06:00
|
|
|
if ($system_release =~ /Arch Linux/) {
|
|
|
|
give_arch_linux_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if ($system_release =~ /Gentoo/) {
|
|
|
|
give_gentoo_hints;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Fall-back to generic hint code for other distros
|
|
|
|
# That's far from ideal, specially for LaTeX dependencies.
|
|
|
|
#
|
|
|
|
my %map = (
|
|
|
|
"sphinx-build" => "sphinx"
|
|
|
|
);
|
|
|
|
check_missing_tex(1) if ($pdf);
|
|
|
|
check_missing(\%map);
|
|
|
|
print "I don't know distro $system_release.\n";
|
|
|
|
print "So, I can't provide you a hint with the install procedure.\n";
|
|
|
|
print "There are likely missing dependencies.\n";
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Common dependencies
|
|
|
|
#
|
|
|
|
|
|
|
|
sub check_needs()
|
|
|
|
{
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
# Check for needed programs/tools
|
|
|
|
check_sphinx();
|
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
if ($system_release) {
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
print "Detected OS: $system_release.\n\n";
|
2017-07-17 15:46:36 -06:00
|
|
|
} else {
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
print "Unknown OS\n\n";
|
scripts/sphinx-pre-install: add minimum support for RHEL
RHEL 7.x and clone distros are shipped with Sphinx 1.1.x,
with is incompatible with Kernel ReST markups.
So, on those systems, the only alternative is to install
it via a Python virtual environment.
While seeking for "pip" on CentOS 7.3, I noticed that it
is not really needed, as python-virtualenv has its version
packaged there already. So, remove this from the list of
requirements for all distributions.
With regards to PDF, we need at least texlive-tabulary
extension, but that is not shipped there (at least on
CentOS). So, disable PDF packages as a whole.
Please notice, however, that texlive + amsmath is needed for
ReST to properly handle ReST ".. math::" tags. Yet, Sphinx
fall back to display the LaTeX math expressions as-is, if
such extension is not available.
So, let's just disable all texlive packages as a whole.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2017-07-24 06:09:24 -06:00
|
|
|
}
|
|
|
|
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
print "To upgrade Sphinx, use:\n\n" if ($rec_sphinx_upgrade);
|
|
|
|
|
2017-07-17 15:46:36 -06:00
|
|
|
# Check for needed programs/tools
|
|
|
|
check_perl_module("Pod::Usage", 0);
|
|
|
|
check_program("make", 0);
|
|
|
|
check_program("gcc", 0);
|
|
|
|
check_python_module("sphinx_rtd_theme", 1) if (!$virtualenv);
|
|
|
|
check_program("xelatex", 1) if ($pdf);
|
|
|
|
check_program("dot", 1);
|
|
|
|
check_program("convert", 1);
|
2017-07-17 15:46:40 -06:00
|
|
|
check_program("rsvg-convert", 1) if ($pdf);
|
2019-03-30 07:45:59 -06:00
|
|
|
check_program("latexmk", 1) if ($pdf);
|
2017-07-17 15:46:36 -06:00
|
|
|
|
|
|
|
check_distros();
|
|
|
|
|
|
|
|
if ($need_symlink) {
|
|
|
|
printf "\tsudo ln -sf %s /usr/bin/sphinx-build\n\n",
|
|
|
|
which("sphinx-build-3");
|
|
|
|
}
|
2019-05-22 15:43:46 -06:00
|
|
|
if ($need_sphinx || $rec_sphinx_upgrade) {
|
2019-05-29 17:09:24 -06:00
|
|
|
my $min_activate = "$ENV{'PWD'}/${virtenv_prefix}${min_version}/bin/activate";
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
my @activates = glob "$ENV{'PWD'}/${virtenv_prefix}*/bin/activate";
|
2019-05-29 17:09:24 -06:00
|
|
|
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
@activates = sort {$b cmp $a} @activates;
|
2019-05-29 17:09:24 -06:00
|
|
|
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
if ($need_sphinx && scalar @activates > 0 && $activates[0] ge $min_activate) {
|
|
|
|
printf "\nNeed to activate a compatible Sphinx version on virtualenv with:\n";
|
2019-05-29 17:09:24 -06:00
|
|
|
printf "\t. $activates[0]\n";
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
exit (1);
|
2017-07-17 15:46:37 -06:00
|
|
|
} else {
|
2019-05-29 17:09:24 -06:00
|
|
|
my $rec_activate = "$virtenv_dir/bin/activate";
|
2017-07-17 15:46:37 -06:00
|
|
|
my $virtualenv = findprog("virtualenv-3");
|
2017-07-21 10:20:41 -06:00
|
|
|
$virtualenv = findprog("virtualenv-3.5") if (!$virtualenv);
|
2017-07-17 15:46:37 -06:00
|
|
|
$virtualenv = findprog("virtualenv") if (!$virtualenv);
|
|
|
|
$virtualenv = "virtualenv" if (!$virtualenv);
|
|
|
|
|
|
|
|
printf "\t$virtualenv $virtenv_dir\n";
|
2019-05-29 17:09:24 -06:00
|
|
|
printf "\t. $rec_activate\n";
|
2017-07-17 15:46:38 -06:00
|
|
|
printf "\tpip install -r $requirement_file\n";
|
2019-05-22 15:43:46 -06:00
|
|
|
|
|
|
|
$need++ if (!$rec_sphinx_upgrade);
|
2017-07-17 15:46:37 -06:00
|
|
|
}
|
2017-07-17 15:46:36 -06:00
|
|
|
}
|
|
|
|
printf "\n";
|
|
|
|
|
2019-05-30 15:59:14 -06:00
|
|
|
print "All optional dependencies are met.\n" if (!$optional);
|
2017-07-17 15:46:36 -06:00
|
|
|
|
|
|
|
if ($need == 1) {
|
|
|
|
die "Can't build as $need mandatory dependency is missing";
|
|
|
|
} elsif ($need) {
|
|
|
|
die "Can't build as $need mandatory dependencies are missing";
|
|
|
|
}
|
|
|
|
|
|
|
|
print "Needed package dependencies are met.\n";
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Main
|
|
|
|
#
|
|
|
|
|
|
|
|
while (@ARGV) {
|
|
|
|
my $arg = shift(@ARGV);
|
|
|
|
|
|
|
|
if ($arg eq "--no-virtualenv") {
|
|
|
|
$virtualenv = 0;
|
|
|
|
} elsif ($arg eq "--no-pdf"){
|
|
|
|
$pdf = 0;
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
} elsif ($arg eq "--version-check"){
|
|
|
|
$version_check = 1;
|
2017-07-17 15:46:36 -06:00
|
|
|
} else {
|
scripts/sphinx-pre-install: always check if version is compatible with build
Call the script every time a make docs target is selected, on
a simplified check mode.
With this change, the script will set two vars:
$min_version - obtained from `needs_sphinx` var inside
conf.py (currently, '1.3')
$rec_version - obtained from sphinx/requirements.txt.
With those changes, a target like "make htmldocs" will do:
1) If no sphinx-build/sphinx-build3 is found, it will run
the script on normal mode as before, checking for all
system dependencies and providing install hints for the
needed programs and will abort the build;
2) If no sphinx-build/sphinx-build3 is found, but there is
a sphinx_${VER}/bin/activate file, and if
${VER} >= $min_version (string comparation), it will
run in full mode, and will recommend to activate the
virtualenv. If there are multiple virtualenvs, it
will string sort the versions, recommending the
highest version and will abort the build;
3) If Sphinx is detected but has a version lower than
$min_version, it will run in full mode - with will
recommend creating a virtual env using sphinx/requirements.txt,
and will abort the build.
4) If Sphinx is detected and version is lower than
$rec_version, it will run in full mode and will
recommend creating a virtual env using sphinx/requirements.txt.
In this case, it **won't** abort the build.
5) If Sphinx is detected and version is equal or righer than
$rec_version it will return just after detecting the
version ("quick mode"), not checking if are there any
missing dependencies.
Just like before, if one wants to install Sphinx from the
distro, it has to call the script manually and use `--no-virtualenv`
argument to get the hints for his OS:
You should run:
sudo dnf install -y python3-sphinx python3-sphinx_rtd_theme
While here, add a small help for the three optional arguments
for the script.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-05-29 17:09:26 -06:00
|
|
|
print "Usage:\n\t$0 <--no-virtualenv> <--no-pdf> <--version-check>\n\n";
|
|
|
|
print "Where:\n";
|
|
|
|
print "\t--no-virtualenv\t- Recommend installing Sphinx instead of using a virtualenv\n";
|
|
|
|
print "\t--version-check\t- if version is compatible, don't check for missing dependencies\n";
|
|
|
|
print "\t--no-pdf\t- don't check for dependencies required to build PDF docs\n\n";
|
2017-07-17 15:46:36 -06:00
|
|
|
exit -1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#
|
|
|
|
# Determine the system type. There's no standard unique way that would
|
|
|
|
# work with all distros with a minimal package install. So, several
|
|
|
|
# methods are used here.
|
|
|
|
#
|
|
|
|
# By default, it will use lsb_release function. If not available, it will
|
|
|
|
# fail back to reading the known different places where the distro name
|
|
|
|
# is stored
|
|
|
|
#
|
|
|
|
|
|
|
|
$system_release = qx(lsb_release -d) if which("lsb_release");
|
|
|
|
$system_release =~ s/Description:\s*// if ($system_release);
|
|
|
|
$system_release = catcheck("/etc/system-release") if !$system_release;
|
|
|
|
$system_release = catcheck("/etc/redhat-release") if !$system_release;
|
|
|
|
$system_release = catcheck("/etc/lsb-release") if !$system_release;
|
|
|
|
$system_release = catcheck("/etc/gentoo-release") if !$system_release;
|
|
|
|
$system_release = catcheck("/etc/issue") if !$system_release;
|
|
|
|
$system_release =~ s/\s+$//;
|
|
|
|
|
|
|
|
check_needs;
|