On Mon 18 Aug 2014 at 23:07:11 +0200, Holger Wansing wrote:

> I have prepared a patch for this (attached) and I would like to receive some 
> thoughts on it. 
> I have added Samuel Thibault in CC, since he has also some knowledge and
> interest on the d-i manual.
> 
> Basically I moved the chapter "Appendix D.6. The Graphical Installer" to
> 5.1.8 (at the end of "Booting the installer on 32-bit PC"), leaving the
> content unchanged.

Defaulting to a graphical (gtk) frontend on i386 and amd64 would mean
that it becomes the regular frontend, unless it is desired to credit the
"newt" frontend with some special status.

In the context of Section 5.3.2. there is a difference between the
"text" and "newt" frontends. But for many users the distinction is lost
and the present "regular" frontend as presented in the user interface is
a text one.

> And I moved chapter "Appendix D.6.1. Using the graphical installer" to
> 6.1.1 (at the end of "How the Installer Works"), leaving the content
> mostly unchanged (only the first line differs).

Section 6.1 uses "character-based" instead of "text". It would be nice
to have some consistency in referring to the alternative to the default
graphical installation.

>  For a normal installation, select either the <quote>Install</quote> or
>  the <quote>Graphical install</quote> entry  &mdash; using either the
>  arrow keys on your keyboard or by typing the first (highlighted) letter, the
> -<quote>Install</quote> entry is already selected by default &mdash; and press
> +<quote>Graphical install</quote> entry is already selected by default 
> &mdash; and press
>  &enterkey; to boot the installer.

I'd restructure that to draw attention to the default highlighting and
to have it read better.

  For a normal installation, select either the “Install” or the “Graphical 
install”
  entry — using either the arrow keys on your keyboard or by typing the first
  (highlighted) letter — and press Enter to boot the installer. The entry 
"Graphical
  install" is already selected by default.
  
> +The graphical version of the installer is only available for a limited
> +number of architectures, including &arch-title;. The functionality of
> +the graphical installer is essentially the same as that of the regular
> +installer as it basically uses the same programs, but with a different
> +frontend.

Replace "regular" with "text"?

> +Although the functionality is identical, the graphical installer still has
> +a few significant advantages. The main advantage is that it supports more
> +languages, namely those that use a character set that cannot be displayed
> +with the regular <quote>newt</quote> frontend. It also has a few usability
> +advantages such as the option to use a mouse, and in some cases several
> +questions can be displayed on a single screen.

Replace "regular "newt" frontend" with "text installer"?

> +Just as with the regular installer it is possible to add boot parameters
> +when starting the graphical installer.

Replace "regular" with "text"?

> +If the amount of memory in your system is below &minimum-memory;,
> +the graphical installer may fail to boot at all while booting the
> +regular installer would still work. Using the regular installer is
> +recommended for systems with little available memory.

Replace both "regular"s with "text"s?

> +The graphical installer basically works the same as
> +the regular installer and thus the rest of this manual can be used to guide
> +you through the installation process.

Replace "regular" with "text"?

> +To switch to another console, you will also need to use the
> +<keycap>Ctrl</keycap> key, just as with the X Window System. For example,
> +to switch to VT2 (the first debug shell) you would use: <keycombo>
> +<keycap>Ctrl</keycap> <keycap>Left Alt</keycap> <keycap>F2</keycap>
> +</keycombo>. The graphical installer itself runs on VT5, so you can use
> +<keycombo> <keycap>Left Alt</keycap> <keycap>F5</keycap> </keycombo>
> +to switch back.

I'm unsure whether a reference to the X Window System is useful, even
for those who know what it is.

In Section 6,1 the paragraph beginning "For this architecture the ...."
would need the default user interface and the link altering. There are
also a few other links in the manual to Sections D.6. and D.6.1..

In Section 5.3.2. should the default frontend reference become "gtk"?

Regards,

Brian.


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to