On 07/22/2017 01:27 PM, Mike Gilbert wrote: > Packages currently handle installation of vim syntax support files > inconsistently. Some builds install the files if the "vim-syntax" USE > flag is enabled, while others install them unconditionally. > > Do these files fall into the "small text files" category for > unconditional installation? If so, we should probably phase out the > vim-syntax USE flag. > > If we want to keep the USE flag, I would suggest documenting a global > policy regarding its use. Should that live in the devmanual? Or maybe > the Vim project page? >
I agree, a global policy should be established; whether it's "install unconditionally" like we do with systemd units, openrc daemons, etc, or a global USE. I'm unaware of any way to misinterpret what "vim-syntax" means, and Vim itself already has a place it expects such files to go. Installing a package without this USE flag requires a rebuild to get the syntax file(s), so that's another reason to go unconditional. I have the USE flag set globally and it hasn't created any blockers, so maybe it's safe. As for where documentation goes, I would expect a brief paragraph in the devmanual mentioning the USE flag and linking to the Vim project page that better explains usage and expectations. That way, changes in the Vim project's way of development wouldn't require big rewrites in the devmanual. If we're shipping syntax for other editors as well, perhaps it's deserving of its own devmanual page. Do we have a problem with developers not shipping syntax files? (vim or otherwise) --semi-offtopic-- When I first began using Gentoo in 2012, I was annoyed that Vim remembered my cursor position for every file I opened. It took some hunting to locate where this was set (/etc/vim/vimrc, owned by app-editors/vim-core for the curious) and correct it with g:leave_my_cursor_position_alone = 1 in my vimrc. If we could document Gentoo-added Vim features like that, it'd be less trouble for our newer users to configure Vim to their tastes. I understand we're not a newbie distro, but unexpected behavior can be a PITA to track down without documentation or trawling through `:script` output. Searching the Web, our wiki, and even our GitHub account turned up zero helpful results for this particular thing. If the Vim team needs the help, I'd be glad to lend a hand where needed. (also cc'ing vim@ to get an official opinion) -- Daniel Campbell - Gentoo Developer OpenPGP Key: 0x1EA055D6 @ hkp://keys.gnupg.net fpr: AE03 9064 AE00 053C 270C 1DE4 6F7A 9091 1EA0 55D6
signature.asc
Description: OpenPGP digital signature
