blob: ad595c5a67c671f9d4528d407d305a94ae77793b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
# Copyright 1999-2024 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2
# @ECLASS: vim-doc.eclass
# @MAINTAINER:
# vim@gentoo.org
# @SUPPORTED_EAPIS: 7 8
# @BLURB: Eclass for vim{,-plugin}.eclass to update documentation tags.
# @DESCRIPTION:
# This eclass is used by vim.eclass and vim-plugin.eclass to update
# the documentation tags. This is necessary since vim doesn't look in
# /usr/share/vim/vimfiles/doc for documentation; it only uses the
# versioned directory, for example /usr/share/vim/vim62/doc
#
# We depend on vim being installed, which is satisfied by either the
# DEPEND in vim-plugin or by whatever version of vim is being
# installed by the eclass.
if [[ -z ${_VIM_DOC_ECLASS} ]]; then
_VIM_DOC_ECLASS=1
case ${EAPI} in
7|8) ;;
*) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;;
esac
# @FUNCTION: update_vim_helptags
# @USAGE:
# @DESCRIPTION:
# Update the documentation tags in the versioned Vim directory.
update_vim_helptags() {
debug-print-function ${FUNCNAME} "$@"
local vimfiles helpfile files vim d
# This is where vim plugins are installed
vimfiles="${EROOT}"/usr/share/vim/vimfiles
if [[ ${PN} != vim-core ]]; then
# Find a suitable vim binary for updating tags :helptags
vim=$(type -P vim 2>/dev/null)
[[ -z "${vim}" ]] && vim=$(type -P gvim 2>/dev/null)
[[ -z "${vim}" ]] && vim=$(type -P kvim 2>/dev/null)
if [[ -z "${vim}" ]]; then
ewarn "No suitable vim binary to rebuild documentation tags"
fi
fi
# Make vim not try to connect to X. See :help gui-x11-start
# in vim for how this evil trickery works.
if [[ -n "${vim}" ]] ; then
ln -s "${vim}" "${T}/tagvim" || die
vim="${T}/tagvim"
fi
# Install the documentation symlinks into the versioned vim
# directory and run :helptags
for d in "${EROOT}"/usr/share/vim/vim[0-9]*; do
[[ -d "${d}/doc" ]] || continue # catch a failed glob
# Remove links
readarray -d '' files < <(find "${d}"/doc -name "*.txt" -type l -print0 || die "cannot traverse ${d}/doc" )
for helpfile in "${files[@]}"; do
if [[ $(readlink -f "${helpfile}") == "${vimfiles}"/* ]]; then
rm "${helpfile}" || die
fi
done
# Remove stale dirs, if possible
readarray -d '' files < <(find "${d}" -print0 || die "cannot traverse ${d}")
if [[ -f "${d}/doc/tags" && ${#files[@]} -eq 3 ]]; then
# /usr/share/vim/vim61
# /usr/share/vim/vim61/doc
# /usr/share/vim/vim61/doc/tags
einfo "Removing ${d}"
rm -r "${d}" || die
continue
fi
# Re-create / install new links
if [[ -d "${vimfiles}"/doc ]]; then
for helpfile in "${vimfiles}"/doc/*.txt; do
if [[ ! -e "${d}/doc/$(basename "${helpfile}")" ]]; then
ln -s "${helpfile}" "${d}/doc" || die
fi
done
fi
# Update tags; need a vim binary for this
if [[ -n "${vim}" ]]; then
einfo "Updating documentation tags in ${d}"
DISPLAY= "${vim}" -u NONE -U NONE -T xterm -X -n -f \
'+set nobackup nomore' \
"+helptags ${d}/doc" \
'+qa!' </dev/null &>/dev/null || die
fi
done
if [[ -n "${vim}" && -f "${vim}" ]]; then
rm "${vim}" || die
fi
}
fi
|
