Bug 7652

Summary: Error dialog box received when trying to access URL in "Help" dialog box of "Keyboard" install screen
Product: Mageia Reporter: Jeffrey Bruton <jeffreybruton>
Component: InstallerAssignee: Documentation Team <doc-bugs>
Status: RESOLVED WONTFIX QA Contact:
Severity: normal    
Priority: Normal CC: doc-bugs, gruescubogdan, marja11, thierry.vignaud
Version: Cauldron   
Target Milestone: ---   
Hardware: All   
OS: Linux   
Whiteboard: NEEDINFO
Source RPM: drakx-installer-stage2 drakx-installer-help CVE:
Status comment:

Description Jeffrey Bruton 2012-09-30 23:38:00 CEST
Description of problem:
If the system has a known working Ethernet connection with DHCP and Internet connectivity and the user attempts to access the URL listed in the "Help" dialog box of the "Keyboard" install screen by highlighting the URL and then hitting the Enter key (or by clicking on it with the mouse), the dialog box text changes to an error message:  "Cannot resolve hostname (en.wikipedia.org)"
Not only is there no way to close this dialog box with the keyboard (bug #7645), but if the system does not have the ability to access the URL at this point in the install then this URL should not be a hyperlink.  It should be changed to plain text and text should be added to the dialog box telling the user to note the URL for future use.  If the hyperlink is changed to plain text then the error is no longer needed.  Not professional to have something not work. 


Version-Release number of selected component (if applicable):


How reproducible:
Always

Steps to Reproduce:
1.  Ensure system has a known working Ethernet connection with DHCP and Internet connectivity. 
2.  Boot off install DVD.
3.  Look at the "Keyboard" install screen.
4.  Access the "Help" selection using keyboard or mouse, which will bring up
the Help dialog box.
5.  Select the listed URL by hitting the Tab key twice (bug #7651) and then hitting the Enter key, or by clicking on it with the mouse.
6.  Dialog box text replaced with error "Cannot resolve hostname (en.wikipedia.org)".
Comment 1 Manuel Hiebel 2012-10-01 11:28:08 CEST
doc-team, maybe you can remove any external url from the xml file ?

(as the function that show help or release notes is not a real brower)

CC: (none) => doc-bugs
Source RPM: Mageia 3 Alpha 1 DVD-ROM 32-bit from Mageia-3-alpha1-i586-DVD.iso => drakx-installer-stage2 drakx-installer help

Comment 2 Marja Van Waes 2012-10-01 11:51:47 CEST
(In reply to comment #1)
> doc-team, maybe you can remove any external url from the xml file ?
> 
> (as the function that show help or release notes is not a real brower)

We'll try to figure out how to keep the link in the online documentation http://doc.mageia.org/installer/2/en/content/selectKeyboard.html, where the link is functional, 
and to not let it look like a click-able link in installer. 

(The online help and the help files in installer are generated from the same xml files)

The link should still be in the installer help as plain text, though, for people who have a 2nd system where they can check the link, if needed.

It might take awhile, we have a very long todo list with many more urgent things on it.

@ Jeffrey

Thanks for your report :)
We are volunteers, some of us do the same work as a professional, most of us don't. If you happen to know a lot about xml and docbook xsl, or have time to figure out how to solve this bug: we'd be happy to welcome you in documentation team.

Priority: Normal => Low
Status: NEW => ASSIGNED
CC: (none) => marja11
Hardware: i586 => All
Assignee: bugsquad => doc-bugs
Severity: normal => minor

Comment 3 Manuel Hiebel 2012-10-01 12:09:16 CEST
maybe you could remove all href="http://www (like what is done in the release notes for other info [1]) when you export it to the svn 

1: http://svnweb.mageia.org/packages/cauldron/mageia-release/current/SOURCES/Makefile?revision=223332&view=markup

Source RPM: drakx-installer-stage2 drakx-installer help => drakx-installer-stage2 drakx-installer-help

Comment 4 Jeffrey Bruton 2012-10-02 21:30:46 CEST
Marja:

You are most welcome.  I'm hoping to have a good deal more time to devote in the coming weeks as the new home my company is building will be finished and for sale.  I know I'm "preaching to the choir" but I really think the way Mageia is set up (non-profit org, actual board, etc.) is the right way to go and I want to help as much as possible.

I too used to be on staff in the software industry including 5 years on staff at the big software company in Redmond, WA USA (as I live in Washington State).  I have indeed done documentation work including writing a couple of user manuals in the past, but unfortunately I don't know alot about xml or docbook xls.

As mentioned in the bug report I agree the link should stay in the dialog box as plain text.  And I also understand the benefit of generating the help and installer files from the same XML.

Wish I could help more, but at this point I am a humble tester.  Please let me know if there is anything else I can do.

Thanks
Jeffrey Bruton
Comment 5 Marja Van Waes 2012-10-20 10:50:27 CEST
Thanks Jeffrey

We really need testers, so thanks a lot for helping with that!

Beginning this months some new Greek and Spanish help files had to be committed, I made the link unclickable for those languages. Unfortunately, next time something is changed in the Greek or Spanish help, the link becomes clickable again. So we'll need to find a permanent fix.
Comment 6 Marja Van Waes 2012-10-20 12:24:41 CEST
(In reply to comment #3)
> maybe you could remove all href="http://www (like what is done in the release
> notes for other info [1]) when you export it to the svn 
> 
> 1:
> http://svnweb.mageia.org/packages/cauldron/mageia-release/current/SOURCES/Makefile?revision=223332&view=markup

yes, something like that would be great.... but here more needs to be removed, and it is not the same for every language
Comment 7 Jeffrey Bruton 2012-10-20 21:49:23 CEST
Marja:

You are again most welcome!  Thanks for the fix and hope a permanent fix can be arranged sometime.

I'm hoping to have more time in the very near future to continue testing.

Thanks
Jeffrey Bruton
Comment 8 Manuel Hiebel 2013-02-19 20:05:03 CET
*** Bug 9124 has been marked as a duplicate of this bug. ***

CC: (none) => gruescubogdan

Comment 9 Marja Van Waes 2013-02-19 20:27:27 CET
(In reply to comment #8)
> *** Bug 9124 has been marked as a duplicate of this bug. ***

Ah, it is the same bug, but with network install (so when the hostname can be resolved) the effect is much more serious: it breaks the install. 

We can be happy that at this point no changes have yet been saved to any disk.

increasing both severity and priority.

Anyone who wants to help fix this, either on the Calenco/Docbook side or on the drakx-installer-help side: please add a comment

Priority: Low => Normal
Whiteboard: (none) => NEEDHELP
Severity: minor => normal

Manuel Hiebel 2013-02-19 20:57:03 CET

CC: (none) => thierry.vignaud

Comment 10 Bogdan Gruescu 2013-02-19 20:58:58 CET
Manuel, Marja (about Bug 9124, marked as duplicate of this one):

Strange ... I confirm that I had no problem to access that URL in the "Help"
section, the opened page looked similar to a web page ... just that it's more
harder to read it on small monitors because the window is not full screen (more
exactly, the window is full screen inside the installer screen which doesn't
occupy the entire screen).

But as soon as I close that window (to continue the installation) I got a
segmentation fault.
Comment 11 Manuel Hiebel 2013-02-26 11:48:00 CET
I will reopen the bug, as it's really crash too much :/
Comment 12 Thierry Vignaud 2013-02-26 17:53:09 CET
Can you check with today's installer? There's been fixed in perl-Glib.
Thierry Vignaud 2013-02-26 17:53:16 CET

Whiteboard: NEEDHELP => NEEDHELP NEEDINFO

Comment 13 Manuel Hiebel 2013-03-08 02:16:04 CET
so we are back to initial situation. (better than something segfaulting)

Whiteboard: NEEDHELP NEEDINFO => NEEDHELP

Comment 14 Bogdan Gruescu 2013-03-08 08:22:25 CET
(In reply to Manuel Hiebel from comment #13)
> so we are back to initial situation. (better than something segfaulting)

The situation described by the bug reporter no longer occurred for me (tested on 19.02.2013, but Thierry and maybe others did some changes since then). I was able to access that URL with ease and the Wikipedia page opened fine.
Is this bug still valid?
Comment 15 Marja Van Waes 2013-03-22 13:54:04 CET
(In reply to Marja van Waes from comment #2)
> (In reply to comment #1)
> > doc-team, maybe you can remove any external url from the xml file ?
> > 
> > (as the function that show help or release notes is not a real brower)
> 
> We'll try to figure out how to keep the link in the online documentation
> http://doc.mageia.org/installer/2/en/content/selectKeyboard.html, where the
> link is functional, 
> and to not let it look like a click-able link in installer. 
> 

(In reply to Thierry Vignaud from comment #12)
> Can you check with today's installer? There's been fixed in perl-Glib.

The link opened (and closed) fine when doing a boot.iso install this morning. 
The link working with a network install means it'll work with a traditional DVD install, too, once the network has been set up. The wikipedia information is really useful, so making the link un-clickable isn't a good option anymore.

We could add a message to the link:

********************************************************************

During install this link will only work if you have a working network, for instance if you do a network install or if, after your network has been set up, you choose to configure your keyboard in the Summary screen .

********************************************************************

But to me that looks more confusing than helpful.. does anybody have better words, or should we leave everything as it is?

@ Jeffrey
WDYT?

Whiteboard: NEEDHELP => NEEDINFO

Comment 16 Marja Van Waes 2013-04-04 17:39:18 CEST
No reply

Leaving everything as it seems the best option: 

The link does work when there is a network available:
* While installing from the DVD: when you access this screen again in the Summary step (after setting up the network)
* already at the beginning of the installation when doing a network install.

Closing as wontfix

Status: ASSIGNED => RESOLVED
Resolution: (none) => WONTFIX