This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 17876 - I18N - It is unclear what the "Encoding" property of Java and Form files means
Summary: I18N - It is unclear what the "Encoding" property of Java and Form files means
Status: CLOSED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: Code (show other bugs)
Version: 3.x
Hardware: PC Windows ME/2000
: P3 blocker (vote)
Assignee: John Jullion-ceccarelli
URL:
Keywords: I18N
Depends on:
Blocks:
 
Reported: 2001-11-20 11:49 UTC by iformanek
Modified: 2003-07-01 15:25 UTC (History)
3 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description iformanek 2001-11-20 11:49:42 UTC
The tooltip says "Encoding of the text file. Leave blank for default one".
The property editor is normal String editor.
The help system does not provide any explanation either.
Comment 1 Svata Dedic 2001-11-20 13:34:49 UTC
It's not possible to determine possible encodings actually supported
by the platform (or I didn't found a way). We can only provide a fixed
list of encodings, which may or may not work (and there may be more of
them unlisted) ==> such list is pretty useless. 
I will make the encoding property check whether the given encoding
spec is supported by the platform + display a reasonable message.
IMHO, this fall into an "ENHANCEMENT" category rather than defect -
except for lacking documentation.

John, would you please mention the property in the online docs ?
Comment 2 John Jullion-ceccarelli 2001-11-20 15:40:25 UTC
The encoding property is documented in the compiler pages, although 
the help page doesn't give a list of available formats. IF you have a 
list we'll be happy to put it in. I'm not sure where this info would 
fit in in the Java pages.
Comment 3 Svata Dedic 2001-11-22 06:38:50 UTC
John, the encoding property on the file works together with encoding
on the compiler: compiler's setting only controls how the compiler
will operate on the file. The property on the file itself controls how
the IDE will try to open, save the file. There's one another encoding
property in Tools - Options - Editing - Java sources, which
establishes a default for all java files.
If someone needs to read the file, the file's property is queried
first; if not set, the default is used. If the default is not set as
well, platform-default encoding is used. Compiler can override this
setting with its own encoding property value - but only for
compilation purposes.

BTW - it's a surprise that this is an I18N issue, what's the criteria
for marking it so ?
Comment 4 John Jullion-ceccarelli 2001-11-22 11:22:02 UTC
I think this shows the general need to write a Help page for property 
sheets of Java objects. I'll write it up for 3.3.1 but it's not going 
to fit in 3.3 as this is the last day to add new pages.
Comment 5 John Jullion-ceccarelli 2001-11-22 11:23:01 UTC
Reassigning to myself/usersguide
Comment 6 Jan Chalupa 2001-11-27 17:24:26 UTC
Target milestone -> 3.3.1.
Comment 7 Ken Frank 2002-03-10 21:46:03 UTC
It could be very helpful to explain how netbeans handles encodings,
where in the product encodings are used, and list 
of encodings supported if different than that of jdk.

ken.frank@sun.com
03/10/2002
Comment 8 John Jullion-ceccarelli 2002-03-11 19:27:07 UTC
added a page to 3.3.1 help called "Setting Character Encoding for 
Java Files". Svata, could you please add a Help ID to the Text tab of 
java object property sheets so I can hook it to this page via CSH?  
Please add help id to the trunk and we'll mark it 3.3.2 candidate.
Comment 9 John Jullion-ceccarelli 2002-04-30 13:29:19 UTC
closing since the property is documented, i was only 
leaving it open so we could add a help id to the property 
sheet, we'll do that later.
Comment 10 Ken Frank 2002-09-03 23:32:34 UTC
verified
Comment 11 Jesse Glick 2002-12-23 16:37:34 UTC
Consistent use of the I18N keyword.
Comment 12 Quality Engineering 2003-07-01 15:25:10 UTC
Resolved for 3.4.x or earlier, no new info since then -> closing.