"Glossary of Windows terms" link doesn't work

Bug #144796 reported by Matthew Paul Thomas
8
Affects Status Importance Assigned to Milestone
ubuntu-docs (Ubuntu)
Fix Released
Medium
Unassigned

Bug Description

Binary package hint: ubuntu-docs

Ubuntu Gutsy, all updates installed

1. Choose "System" > "Help and Support".
2. Choose "New to Ubuntu?".
3. Choose "If you've been using Windows".
4. Choose "Glossary of Windows terms".

What happens: "Page not found - The requested page was not found in the document /usr/share/gnome/help/windows/C/windows.xml."

(And if that page is still the same as when I wrote it, it is *not* a glossary of Windows terms. It is a list of Ubuntu equivalents to things found in Windows.)

Related branches

Revision history for this message
Phil Bull (philbull) wrote :

The 'Glossary of Windows Terms' link in the TOC for 'If you’ve been using Windows' links to "file:////usr/share/gnome/help/windows/C/windows.xml#_auto-gen-id-1", which does not exist. It *might* be possible to fix this issue by changing the following in glossary.xml:

-<glossary lang="&language;">
+<glossary id="glossary" lang="&language;">

Changed in ubuntu-docs:
importance: Undecided → Medium
status: New → Confirmed
Revision history for this message
Matthew East (mdke) wrote :

I don't know why this link isn't working: Don - can you help?

Revision history for this message
Ivaylo Ivanov (icefox) wrote :

I change line 14 (<glossary lang="&language;">) to <glossary id="glossary" lang="&language;"> and now everything is fine.
Thank's for Phil Bull

Revision history for this message
Matthew East (mdke) wrote :

Still, this shouldn't be happening - the file is perfectly valid xml and the link works if it is opened in yelp individually, as opposed to navigating from the front page. I'd like to find out the cause before we push the fix.

Revision history for this message
Ivaylo Ivanov (icefox) wrote :

I agree with you.the reason must be understood.

Revision history for this message
Eero Salokannel (epatic) wrote :

I think (I'm just a newbie) that this comes from the glossary not having an id. I had problems opening the page even through the previous page of the template. Normally it uses the "#autogen-id-x" where x is a random number, but after I fixed it like Phil suggested, it gets allways the right address:

file:///usr/share/gnome/help/windows/C/windows.xml#glossary

Might this be the reason Ivaylo and others are looking for?

Revision history for this message
Matthew East (mdke) wrote :

I still think that yelp should work with this document.

Anyway, I've pushed the simple fix to the repository at https://docteam.ubuntu.com/repos/branches/gutsy and there is a package there waiting to be uploaded (ubuntu-main-sponsors subscribed).

My build is still going and I'm late for work so I'm afraid I can't submit a debdiff. If no one else can do one, then I'll submit one tomorrow. It should be very straightforward, this is the only change since version 7.10.3 and it is text only.

Thanks

Revision history for this message
Daniel Holbach (dholbach) wrote :
Revision history for this message
Matthew East (mdke) wrote :

Thanks very much Daniel. The debdiff looks exactly right to me.

Revision history for this message
Daniel Holbach (dholbach) wrote :

Matthew: please check the debdiff - is everything alright? Quite a bunch of files move around...

Revision history for this message
Matthew East (mdke) wrote :

That looks really weird. Daniel - the first diff looks correct, but the second diff you have posted is odd. Are you sure you're comparing the correct package? This line confuses me too:

Comparing ./ubuntu-docs_7.10.3_all.deb and /var/cache/pbuilder/result/ubuntu-docs_7.10.3_all.deb

The new version should be 7.10.4, apart from anything else, and since 7.10.3 I definitely haven't done anything to make files move around.

Revision history for this message
Martin Pitt (pitti) wrote :

Approved.

Revision history for this message
Daniel Holbach (dholbach) wrote :

You are right, this is the new debdiff. There's still something weird in it.

Revision history for this message
Matthew East (mdke) wrote :

Definitely weird. None of that has been touched at all in svn since the last upload. I've checked and the only commit that has been done to the *gutsy* branch since 7.10.3 is the one fixing this bug (https://lists.ubuntu.com/archives/ubuntu-doc-commits/2007-October/003933.html)

Did you get the 7.10.3 source that you are using in the diff from the archive, or is it something you had hanging around from a previous build? It looks suspiciously like it doesn't include this change:

  * Restore symlink-dupes script to eliminate duplicate files (LP: 149040)

(from the changelog in version 7.10.1)

If we can't figure out what is causing this problem, please don't upload and I'll try and take a look myself later.

Revision history for this message
Matthew East (mdke) wrote :

Daniel - I've tried this myself and get totally different results. I've taken 7.10.3 from the archive, and 7.10.4 as a svn export. The debdiffs look fine. I'll attach both the one on the source package (on the .dsc files) and the one on the binaries (on the .deb files). My builds were done on gutsy, up to date as of yesterday.

I think this is something to do with how to symlink script is working, from the output you gave.

Revision history for this message
Matthew East (mdke) wrote :

Here's the other debdiff I get.

Revision history for this message
Matthew East (mdke) wrote :

ubuntu-docs (7.10.4) gutsy; urgency=low

  * Fix broken link in "windows" document (LP: #144796)

 -- Matthew East <email address hidden> Fri, 12 Oct 2007 08:36:57 +0100

Changed in ubuntu-docs:
status: Confirmed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.