stuartl/linux-mainline
1
0
Fork 0
mirror of https://kernel.googlesource.com/pub/scm/linux/kernel/git/torvalds/linux synced 2025-11-04 08:34:47 +10:00
Code Issues Releases Wiki Activity

scripts: sphinx-pre-install: change recommendation text if venv exists

Browse Source 
If one is running a Sphinx version older than what's recommended,
but there's already a newer working virtual env, change the
text, as it is just a matter of switching to the new venv, instead
of creating a new one from scratch.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/bcf79d0399a1c3444ca938dcdce599c3273980ab.1587478901.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2020-04-21 16:31:07 +02:00 committed by Jonathan Corbet
parent 1ef70ced55
commit 2834a7412b
1 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
scripts/sphinx-pre-install
View File

@ -29,6 +29,7 @@ my $install = "";
my $virtenv_dir = ""; my $virtenv_dir = "";
my $python_cmd = ""; my $python_cmd = "";
my $min_version; my $min_version;
my $cur_version;
my $rec_version = "1.7.9"; # PDF won't build here my $rec_version = "1.7.9"; # PDF won't build here
my $min_pdf_version = "2.4.4"; # Min version where pdf builds my $min_pdf_version = "2.4.4"; # Min version where pdf builds
@ -257,7 +258,6 @@ sub get_sphinx_version($)
sub check_sphinx() sub check_sphinx()
{ {
my $default_version; my $default_version;
my $cur_version;
open IN, $conf or die "Can't open $conf"; open IN, $conf or die "Can't open $conf";
while (<IN>) { while (<IN>) {
@ -703,8 +703,6 @@ sub check_needs()
print "Unknown OS\n\n"; print "Unknown OS\n\n";
} }
print "To upgrade Sphinx, use:\n\n" if ($rec_sphinx_upgrade);
# Check python command line, trying first python3 # Check python command line, trying first python3
$python_cmd = findprog("python3"); $python_cmd = findprog("python3");
$python_cmd = check_program("python", 0) if (!$python_cmd); $python_cmd = check_program("python", 0) if (!$python_cmd);
@ -786,24 +784,36 @@ sub check_needs()
@activates = sort {$b cmp $a} @activates; @activates = sort {$b cmp $a} @activates;
my ($activate, $ver); my ($activate, $ver);
foreach my $f (@activates) { foreach my $f (@activates) {
$activate = $f; next if ($f lt $min_activate);
next if ($activate lt $min_activate);
my $sphinx_cmd = $activate; my $sphinx_cmd = $f;
$sphinx_cmd =~ s/activate/sphinx-build/; $sphinx_cmd =~ s/activate/sphinx-build/;
next if (! -f $sphinx_cmd); next if (! -f $sphinx_cmd);
$ver = get_sphinx_version($sphinx_cmd); $ver = get_sphinx_version($sphinx_cmd);
last if ($ver ge $min_version); if ($need_sphinx && ($ver ge $min_version)) {
$activate = $f;
last;
} elsif ($ver gt $cur_version) {
$activate = $f;
last;
}
} }
if ($need_sphinx && ($activate ne "")) { if ($activate ne "") {
printf "\nNeed to activate Sphinx (version $ver) on virtualenv with:\n"; if ($need_sphinx) {
printf "\t. $activate\n"; printf "\nNeed to activate Sphinx (version $ver) on virtualenv with:\n";
deactivate_help(); printf "\t. $activate\n";
exit (1); deactivate_help();
exit (1);
} else {
printf "\nYou may also use a newer Sphinx (version $ver) with:\n";
printf "\tdeactivate && . $activate\n";
}
} else { } else {
my $rec_activate = "$virtenv_dir/bin/activate"; my $rec_activate = "$virtenv_dir/bin/activate";
print "To upgrade Sphinx, use:\n\n" if ($rec_sphinx_upgrade);
if ($need_venv) { if ($need_venv) {
printf "\t$python_cmd -m venv $virtenv_dir\n"; printf "\t$python_cmd -m venv $virtenv_dir\n";
} else { } else {