php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #29941 Online documentation contains mixed languages
Submitted: 2004-09-02 00:23 UTC Modified: 2004-09-02 14:47 UTC
From: tilspaam at hotmail dot com Assigned:
Status: Not a bug Package: Documentation problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
 [2004-09-02 00:23 UTC] tilspaam at hotmail dot com
Description:
------------
Hello

I recently found out that the online documentation contains a mixture of english and (in my case) danish. Some of the headlines and warnings are in danish while the rest is still in english.

Translating the documentation into local languages might be a good idea for those not accustomed to english, but I would very much like to have the option of selecting english and nothing but english.

Having to switch languages while reading is very annoying so please provide this functionality.

I thank you in advance and for the great work that you put into continuously developing PHP.

/AP


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2004-09-02 08:30 UTC] aidan@php.net
I believe this has to do with the content-negotiation we use for displaying the manual. Based on your browser accept langauge, a selected version of the manual is displayed.

This bug will need to be looked into further, as I've experienced it myself - Pages a mix between english and another langauge, often after I've just visited the manual in another language.

But, could you tell me if the problem still happens when you use the explicit manual path?
http://www.php.net/manual/en/

Or in Danish,
http://www.php.net/manual/da/

 [2004-09-02 11:34 UTC] tilspaam at hotmail dot com
Using the explicit manual path http://www.php.net/manual/en/ref.session.php provides a page all in english.

Using http://www.php.net/session or http://www.php.net/manual/da/ref.session.php provides a page in mixed languages.

I guess I'll just use the explicit path from now on :)

/AP
 [2004-09-02 12:03 UTC] tularis@php.net
It is actually much simpler. If the page that you're trying to view in a language other than english has not yet been translated, as is the case with the Danish session chapter, you will recieve the same page in English. If we would not do that, we'd be stuck with dozens of broken manuals where half of the content was missing. So, until someone translates it and adds it to CVS, it will appear in English.
 [2004-09-02 12:04 UTC] tularis@php.net
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php


 [2004-09-02 12:20 UTC] goba@php.net
BTW this is a feature, not a bug. If you have cookies turned on, the last language you have seen is remembered, so next time, the URL shortcuts will lead to that language (no need to select the language in every page view).

If you would like to directly specify the language in your shortcut, you can do so. See http://php.net/urlhowto This page also links the My PHP.net page, which will explain you the language selection mechanism (http://php.net/my).
 [2004-09-02 14:34 UTC] tilspaam at hotmail dot com
tularis@php.net wrote:

"If the page that you're trying to view in a
language other than english has not yet been translated, as is the case
with the Danish session chapter, you will recieve the same page in
English."

No - I recieve a page in both danish and english. This is the case with http://www.php.net/session - all general content such as headers and warnings are in danish while the main content is in english.

goba@php.net wrote:

"If you have cookies turned on, the
last language you have seen is remembered..."

I have allowed cookies for php.net and this seems to work. All previous mentioned URLs now display english and english only.

goba@php.net wrote: 

"BTW this is a feature, not a bug"

I strongly disagree. Making assumptions about your users preferences is bad usability, but this discussion I believe belongs elsewhere.

I know this problem is hardly a 'bug' but I didn't know where else to write. I'm sorry if I have posted the wrong place.

/AP
 [2004-09-02 14:37 UTC] goba@php.net
If you provide no language code, we need to make assumptions. Whether it is good practice or not, we need to do it. If you provide the langauge code, than it is used.
 [2004-09-02 14:41 UTC] tularis@php.net
back to the point, 
Those pages are written using a lot of entities (eg. &title; etc.). These entities are stored in a seperate file. If these entities are translated, but the actual page is not, then what you see is precisely that. I know it looks strange, but that's just the way it is...
 [2004-09-02 14:47 UTC] tilspaam at hotmail dot com
Enabling cookies for php.net solved the problem. You may close this thread.

I thank you for the fast reply and your generous help.

/AP
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Tue Apr 30 02:01:31 2024 UTC