Re: [gentoo-dev] multilib amd64 news item for review

[Ulrich Mueller]

>>>>> On Sun, 15 Mar 2015, Michał Górny wrote:

> Hello, everyone. Here's the first draft of news item for
> gx86-multilib. I tried to cover all the important aspects. Please
> review and let me know what you think.

> Title: True multilib support on amd64
> Author: Michał Górny <mgorny@g.o>
> Content-Type: text/plain
> Posted: 2015-01-28
> Revision: 1
> News-Item-Format: 1.0
> Display-If-Keyword: amd64
> Display-If-Keyword: ~amd64

Users of no-multilib profiles won't be affected, so maybe
Display-If-Profile should be used (in addition, or instead of
Display-If-Keyword)?

> Starting with 2015-03-29, we are enabling the true multilib support
> on amd64 and masking the old emul-linux-x86 package sets for removal.
> This change provides

I'm not a native speaker, but shouldn't a future tense be used here?

>                      our users with the opportunity to build 32-bit
> libraries from source with all the flexibility given by ebuilds, rather
> than relying on pre-packaged binary versions of them.

> The switch to the new system is likely to require a specific action from
> the users of our multilib profiles. Since the new system collides with
> the old one, the Package Manager must be able to clearly satisfy all
> the dependencies using the new system in order to proceed. This may
> require unmerging packages installed from third-party repositories that
> have not been updated to support the new system.

> In order to enable building necessary 32-bit libraries, users will be
> required to enable the abi_x86_32 USE flag on respective packages.

How? Maybe add a hint that this should be done in package.accept_keywords?

> In most of the cases, Portage will be able to deliver correct
> suggestions for that when using the --autounmask feature. However, some
> users may prefer setting ABI_X86 globally to enable 32-bit libraries
> in all packages supporting building them.

Again, add a hint how to do this?

> In case of issues, blockers especially, the users users

s/the users users/users/

>                                                         are recommended
> to manually uninstall any emul-linux-x86 packages that may have been
> installed on their systems. This will aid the Package Manager
> in choosing the correct dependency resolution path. If using Portage,
> this can be done using the following command:

>     $ emerge -C 'app-emulation/emul-linux-x86*'

> Note that after performing this step, 32-bit applications on your system

So far you have used third person throughout, so avoid the "your"
here.

> may become temporarily broken. Therefore, this step should be followed
> by a @world upgrade immediately.

Maybe a pointer to the wiki could be added? How about this:
https://wiki.gentoo.org/wiki/Multilib_System_without_emul-linux_Packages
(with that page being updated if necessary).

Ulrich