From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 73257139694 for ; Sat, 22 Jul 2017 21:44:42 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A157DE0CBF; Sat, 22 Jul 2017 21:44:36 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 45EB1E0CAE for ; Sat, 22 Jul 2017 21:44:36 +0000 (UTC) Received: from [46.246.62.198] (anon-62-198.vpn.ipredator.se [46.246.62.198]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: zlg) by smtp.gentoo.org (Postfix) with ESMTPSA id 373A73416F6; Sat, 22 Jul 2017 21:44:33 +0000 (UTC) Subject: Re: [gentoo-dev] vim-syntax USE flag To: gentoo-dev@lists.gentoo.org References: From: Daniel Campbell Cc: vim@gentoo.org Message-ID: Date: Sat, 22 Jul 2017 14:44:29 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="5OffKs1c2wc1CpFUJL6oL4Gnod82EO1sU" X-Archives-Salt: 7e131137-be9d-40cf-9c83-24a6b47a6d80 X-Archives-Hash: b71433603914647a840cb74d19edd64b This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --5OffKs1c2wc1CpFUJL6oL4Gnod82EO1sU Content-Type: multipart/mixed; boundary="33EimWf4RB6Od4bCc88v7qdoT24OCAQMv"; protected-headers="v1" From: Daniel Campbell To: gentoo-dev@lists.gentoo.org Cc: vim@gentoo.org Message-ID: Subject: Re: [gentoo-dev] vim-syntax USE flag References: In-Reply-To: --33EimWf4RB6Od4bCc88v7qdoT24OCAQMv Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable 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. >=20 > 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. >=20 > 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? >=20 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 =3D 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) --=20 Daniel Campbell - Gentoo Developer OpenPGP Key: 0x1EA055D6 @ hkp://keys.gnupg.net fpr: AE03 9064 AE00 053C 270C 1DE4 6F7A 9091 1EA0 55D6 --33EimWf4RB6Od4bCc88v7qdoT24OCAQMv-- --5OffKs1c2wc1CpFUJL6oL4Gnod82EO1sU Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEgIn+0tMDW9PQWDLnASQOlFA54XAFAllzxz0ACgkQASQOlFA5 4XCGRA//Vw2RHPKCPPdHYmf44qkayUl8gc4NsTz4iBgv0Hj0AnGe/FV7gCESHvoS R8W255oU75FBZNYOsosq1qbE9LRbTJtIS7jaFb1E1kpNAxXFf6nJ4cbfnJr6usk2 Qm5+OK/WkA8jZRs6yeSBAO/G+OSSTgtB2o6ZE/uioStntbqvvN/vLMBvtb0T7oiv gFHWBtGJf9b9ZFViSAGdVZZHsVgFqK80KrnK4BWbDvLaqRUyKltRK9d8sv9jhdKm 50auUzGxYLdtfC+RtawxufEJGCIDQs9PF9u51sRt4lqA4+KTqCjwSTjv1XPVUc+h z4UliMlpK8wnIuQPazj5cRDVvB+S+iKUBi0aZdHfCovJPR/jgqrWthqTfPGybnl3 4t8lTeKa0wAG+boI+QmLMcayAc1JOzO0cNbbjwufegSyH+lzTSt5BI5I8Kn00DLZ +5Lq7ayR09YTBS1R3U6qoZKUQE/x5EtNOJq48JVK4XhpY1peUSetYmnhYstQqwxR DiRjbvYDkZhWXn4VHVgoD5d/YBFFKY9AhpafWkiq/ixJESyHrD9KiCv69awDJkax Ry2eU1ZVZfuL9LEniRqQnMMdhlNhY3pSGJDQmd5AurDyRm85rm1yAz/79nUIFSyK uVbS1pk4UGUQnnVtnBhia+zf8l9zXDbyOvEm/vwarVAroX/f9fo= =SWIn -----END PGP SIGNATURE----- --5OffKs1c2wc1CpFUJL6oL4Gnod82EO1sU--