[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#992034: installation-guide: Include a note on how to change init system during install



Holger Wansing <hwansing@mailbox.org> writes:

> Hi,
>
> Justin Rye <justin.byam.rye@gmail.com> wrote (Fri, 27 Aug 2021 07:38:17 +0100):
>> Holger Wansing <hwansing@mailbox.org> wrote:
>> > I wonder if "the easiest time to select an alternative init system is during the
>> > installation process" is correct English.
>> >
>> > Maybe better "the best time ... " ?
>> >
>> > Asking debian-l10n-english for advise.
>> >
>> > @debian-l10n-english:
>> > Hi all, could someone please comment on the merge request
>> > mentioned above?
>> 
>> There's nothing wrong with the English of "the easiest time to do X is
>> during Y"; "best" is also okay but asserts something different (which
>> is slightly more a matter of subjective opinion).
>
> Ok.
>
>
> Moreover, when thinking about this implementation, I'm quite uncomfortable with 
> adding such paragraph into the "Using individual components" section, since this 
> "change-init-system part" is no "installer component" like the others in this 
> section (say: there is no 'change-init-system udeb').
>
> Therefore, I would be in favor of adding a separate section for such things as
> section 6.5 after the "Loading missing firmware" section, like this:
>
>
>
> ====snip==================================
> diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent
> index dd3e8d273..81702c32d 100644
> --- a/build/templates/docstruct.ent
> +++ b/build/templates/docstruct.ent
> @@ -126,6 +126,8 @@
>    <!ENTITY module-pkgsel.xml             SYSTEM "##SRCPATH##/using-d-i/modules/pkgsel.xml">
>    <!ENTITY loading-firmware.xml          SYSTEM "##SRCPATH##/using-d-i/loading-firmware.xml">
>  
> +  <!ENTITY misc-adaptions.xml            SYSTEM "##SRCPATH##/using-d-i/misc-adaptions.xml">
> +
>    <!-- No longer used; should be removed after translation updates -->
>    <!ENTITY module-mips-arcboot-installer.xml  SYSTEM "##SRCPATH##/using-d-i/modules/mips/arcboot-installer.xml">
>    <!ENTITY module-mipsel-colo-installer.xml  SYSTEM "##SRCPATH##/using-d-i/modules/mipsel/colo-installer.xml">
> diff --git a/en/using-d-i/using-d-i.xml b/en/using-d-i/using-d-i.xml
> index 3561ced2d..fe9c4628e 100644
> --- a/en/using-d-i/using-d-i.xml
> +++ b/en/using-d-i/using-d-i.xml
> @@ -446,6 +446,7 @@ report installer software problems to &debian; developers later.
>  
>  &using-d-i-components.xml;
>  &loading-firmware.xml;
> +&misc-adaptions.xml;
>  
>  </chapter>
>
> ====snap==================================
>
>
> Plus adding a new file en/using-d-i/misc-adaptions.xml:
>
> +<!-- retain these comments for translator revision tracking -->
> +<!-- $Id$ -->
> +
> + <sect1 id="misc-adaptions">
> + <title>Miscellaneous adaptions</title>

"adaptions" strikes me as slightly odd english -- I think
"customisations" or "adjustments" would be a better choice.

On the other hand the preceding sections are about how we accommodate
people's preferences via debconf settings, so this is actually quite a
departure from that, because it's something that people want to change
that has to be done outside debconf, so the section heading should
probably refer to that difference somehow.

How about "Variations requiring manual intervention"?

Cheers, Phil.
-- 
|)|  Philip Hands  [+44 (0)20 8530 9560]  HANDS.COM Ltd.
|-|  http://www.hands.com/    http://ftp.uk.debian.org/
|(|  Hugo-Klemm-Strasse 34,   21075 Hamburg,    GERMANY

Attachment: signature.asc
Description: PGP signature


Reply to: