Bug 58875

Summary:	needs a warning about obsolete translations for manpages
Product:	[Frameworks and Libraries] kio	Reporter:	gerard
Component:	man	Assignee:	Stephan Kulow <coolo>
Status:	RESOLVED FIXED
Severity:	wishlist	CC:	nicolasg, niek.vandenberg
Priority:	LO
Version:	unspecified
Target Milestone:	---
Platform:	Compiled Sources
OS:	Linux
Latest Commit:		Version Fixed In:

Description gerard 2003-05-24 09:25:19 UTC

Version:           4.0 (using KDE 3.1.1)
Installed from:    compiled sources
Compiler:          gcc version 3.2 (Mandrake Linux 9.0 3.2-1mdk)
OS:          Linux (i686) release 2.4.19-16mdk

When I want to read a manpage in Konqueror, I can choose the english version or my language version.
For non aware users, it is not obvious that the translations are perhaps wrong or obsolete.

It would be useful if there would be a warning message when the list of matching manpages is displayed.

This message could be something like :

The original manpage is usually written in english.
If you read a manpage in your language, be aware it can contain some mistakes or be obsolete.
In case of doubt, you should have a look at the the english version.

Many thanks

Gerard

Comment 1 Nicolas Goutte 2005-05-16 18:25:21 UTC

SVN commit 414669 by goutte:

Add a note in the selection page that translated man page are not as good
as originals.
(I suppose that it is there that it was wanted.)
(The text is from Gerard Delafond)
BUG:58875


 M  +9 -3      trunk/KDE/kdebase/kioslave/man/kio_man.cpp  


--- trunk/KDE/kdebase/kioslave/man/kio_man.cpp #414668:414669
@@ -560,7 +560,7 @@
 
     os << "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">" << endl;
     os << "<title>" << i18n("Man output") << "</title></head>" << endl;
-    os << i18n("<body bgcolor=#ffffff><h1>KDE Man Viewer Error</h1>") << errmsg << "</body>" << endl;
+    os << i18n("<body bgcolor=\"#ffffff\"><h1>KDE Man Viewer Error</h1>") << errmsg << "</body>" << endl;
     os << "</html>" << endl;
 
     data(array);
@@ -578,9 +578,15 @@
     os << i18n("There is more than one matching man page.");
     os << "</h1>\n<ul>\n";
     for (QStringList::ConstIterator it = matchingPages.begin(); it != matchingPages.end(); ++it)
-       os<<"<li><a href=man:"<< *it <<">"<< *it <<"</a></li>\n";
-    os<< "</ul>\n</body>\n</html>"<<endl;
+       os<<"<li><a href=\"man:"<< *it <<"\">"<< *it <<"</a></li>\n";
+    os << "</ul>\n";
+    os << "<hr>\n";
+    os << "<p>" << i18n("Note: if you read a man page in your language,"
+       " be aware it can contain some mistakes or be obsolete."
+       " In case of doubt, you should have a look at the the english version. ") << "</p>";
 
+    os << "</body>\n</html>"<<endl;
+
     data(array);
     finished();
 }

Comment 2 gerard 2005-05-16 18:46:54 UTC

Le Lundi 16 Mai 2005 16:25, Nicolas Goutte a écrit :

>
> Add a note in the selection page that translated man page are not as good
> as originals.
> (I suppose that it is there that it was wanted.)
> (The text is from Gerard Delafond)
> BUG:58875
>
>
>  M  +9 -3      trunk/KDE/kdebase/kioslave/man/kio_man.cpp
>
>
> --- trunk/KDE/kdebase/kioslave/man/kio_man.cpp #414668:414669
>  @ -560,7 +560,7  @
>
>      os << "<html><head><meta http-equiv=\"Content-Type\"
> content=\"text/html; charset=utf-8\">" << endl; os << "<title>" <<
> i18n("Man output") << "</title></head>" << endl; -    os << i18n("<body
> bgcolor=#ffffff><h1>KDE Man Viewer Error</h1>") << errmsg << "</body>" <<
> endl; +    os << i18n("<body bgcolor=\"#ffffff\"><h1>KDE Man Viewer
> Error</h1>") << errmsg << "</body>" << endl; os << "</html>" << endl;
>
>      data(array);
>  @ -578,9 +578,15  @
>      os << i18n("There is more than one matching man page.");
>      os << "</h1>\n<ul>\n";
>      for (QStringList::ConstIterator it = matchingPages.begin(); it !=
> matchingPages.end(); ++it) -       os<<"<li><a href=man:"<< *it <<">"<< *it
> <<"</a></li>\n";
> -    os<< "</ul>\n</body>\n</html>"<<endl;
> +       os<<"<li><a href=\"man:"<< *it <<"\">"<< *it <<"</a></li>\n";
> +    os << "</ul>\n";
> +    os << "<hr>\n";
> +    os << "<p>" << i18n("Note: if you read a man page in your language,"
> +       " be aware it can contain some mistakes or be obsolete."
> +       " In case of doubt, you should have a look at the the english
> version. ") << "</p>";

I like this.
Many thanks.
>
> +    os << "</body>\n</html>"<<endl;
> +
>      data(array);
>      finished();
>  }

This wish can be closed.