mirror/gcc
2
0
Fork 0
mirror of git://gcc.gnu.org/git/gcc.git synced 2025-01-11 08:54:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

cp-hacking.texinfo: Fix some typos.

Browse Source 
libjava/classpath/

	* doc/cp-hacking.texinfo: Fix some typos.
	* doc/cp-tools.texinfo: Likewise.
	* doc/cp-vmintegration.texinfo: Likewise.

From-SVN: r133057
This commit is contained in:
Ralf Wildenhues 2008-03-09 17:29:49 +00:00 committed by Ralf Wildenhues
parent eafaa35bc2
commit d95c087c36
4 changed files with 23 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
libjava/classpath/ChangeLog
View File

@ -1,3 +1,9 @@
2008-03-09 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* doc/cp-hacking.texinfo: Fix some typos.
* doc/cp-tools.texinfo: Likewise.
* doc/cp-vmintegration.texinfo: Likewise.
2008-01-27 Bernhard Fischer <rep.dot.nop@gmail.com>
* java/util/SimpleTimeZone.java (SimpleTimeZone): Fix typo in comment.

12
libjava/classpath/doc/cp-hacking.texinfo
View File

@ -484,7 +484,7 @@ specify @option{--enable-qt-peer} and need the following library:
@table @b
@item Qt
@uref{http://www.trolltech.com/products/qt,Qt} version 4.0.1 or higher.
The Qt library is a cros-platform graphics toolkit.
The Qt library is a cross-platform graphics toolkit.
@end table
@ -558,7 +558,7 @@ library headers:
@table @b
@item GConf
@uref{http://www.gnome.org/projects/gconf/,GConf} version 2.11.2
(or higher). GConf is used for storing dektop and application
(or higher). GConf is used for storing desktop and application
configuration settings in GNOME.
@end table
@ -853,7 +853,7 @@ for ``^method_def'' is mostly gone already. Since it is customary for
almost everybody who writes java source code to put modifiers, return
value and method name on the same line, we do too.
@c fixme Another rational for always indenting the method definition is that itmakes it a bit easier to distinguish methods in inner and anonymousclasses from code in their enclosing context. NEED EXAMPLE.
@c fixme Another rational for always indenting the method definition is that it makes it a bit easier to distinguish methods in inner and anonymous classes from code in their enclosing context. NEED EXAMPLE.
@item
Implements and extends on separate lines, throws too. Indent extends,
@ -1252,7 +1252,7 @@ Just as with the normal code style guide, don't make lines longer then
@item
Just as with comments in the code. The ChangeLog entry should be a
full sentence, starting with a captital and ending with a period.
full sentence, starting with a capital and ending with a period.
@item
Be precise in what changed, not the effect of the change (which should
@ -1742,7 +1742,7 @@ Unicode characters and vice versa.
In Classpath, @code{InputStreamReader} and @code{OutputStreamWriter}
rely on an internal class called @code{gnu.java.io.EncodingManager} to load
translaters that perform the actual conversion. There are two types of
translators that perform the actual conversion. There are two types of
converters, encoders and decoders. Encoders are subclasses of
@code{gnu.java.io.encoder.Encoder}. This type of converter takes a Java
(Unicode) character stream or buffer and converts it to bytes using
@ -1974,7 +1974,7 @@ that this functional area is supported.
@item weekdays - A @code{String} array of weekday names.
@item shortWeekdays - A @code{String} array of abbreviated weekday names.
@item ampms - A @code{String} array containing AM/PM names.
@item eras - A @code{String} array containing era (ie, BC/AD) names.
@item eras - A @code{String} array containing era (i.e., BC/AD) names.
@item zoneStrings - An array of information about valid timezones for this
locale.
@item localPatternChars - A @code{String} defining date/time pattern symbols.

6
libjava/classpath/doc/cp-tools.texinfo
View File

@ -1792,7 +1792,7 @@ java(1), @dots{}
@comment node-name, next, previous, up
@chapter I18N Issues
Some tools --@pxref{Security Tools}-- allow using other than the English language when prompting the User for input, and outputing messages. This chapter describes the elements used to offer this support and how they can be adapted for use with specific languages.
Some tools --@pxref{Security Tools}-- allow using other than the English language when prompting the User for input, and outputting messages. This chapter describes the elements used to offer this support and how they can be adapted for use with specific languages.
@menu
* Language Resources:: Where resources are located
@ -1807,7 +1807,7 @@ Some tools --@pxref{Security Tools}-- allow using other than the English languag
The Tools use Java @code{ResourceBundle}s to store messages, and message templates they use at runtime to generate the message text itself, depending on the locale in use at the time.
The @i{Resource Bundles} these tools use are essentially Java @i{Properties} files consisting of a set of @i{Name/Value} pairs. The @i{Name} is the @i{Propery Name} and the @i{Value} is a substitution string that is used when the code references the associated @i{Name}. For example the following is a line in a @i{Resource Bundle} used by the @code{keytool} Tool:
The @i{Resource Bundles} these tools use are essentially Java @i{Properties} files consisting of a set of @i{Name/Value} pairs. The @i{Name} is the @i{Property Name} and the @i{Value} is a substitution string that is used when the code references the associated @i{Name}. For example the following is a line in a @i{Resource Bundle} used by the @code{keytool} Tool:
@example
Command.23=A correct key password MUST be provided
@ -1847,7 +1847,7 @@ The collection of @i{Resource Bundles} in a location act as an inverted tree wit
In the above example, bundle #1 will act as the parent of bundle #2, which in turn will act as the parent for bundle #3. This ordering is used by the Java runtime to choose which file to load based on the set Locale. For example if the Locale is @code{fr_CH}, @code{messages_fr.properties} will be used because (a) @code{messages_fr_CH.properties} does not exist, but (b) @code{messages_fr.properties} is the parent for the required bundle, and it exists. As another example, suppose the Locale was set to @code{en_AU}; then the tool will end up using @code{messages.properties} because (a) @code{messages_en_AU.properties} does not exist, (b) @code{messages_en.properties} which is the parent for the required bundle does not exist, but (c) @code{messages.properties} exists and is the root of the hierarchy.
You can see from the examples above that @file{messages.properties} is the safety net that the Java runtime falls back to when failing to find a specific bunlde and its parent(s). This file is always provided with the Tool. In time, more localized versions will be included to cater for other languages.
You can see from the examples above that @file{messages.properties} is the safety net that the Java runtime falls back to when failing to find a specific bundle and its parent(s). This file is always provided with the Tool. In time, more localized versions will be included to cater for other languages.
In the meantime, if you are willing to contribute localized versions of these resources, grab the @file{messages.properties} for a specific tool; translate it; save it with the appropriate language and region suffix and mail it to @code{classpath@@gnu.org}.

16
libjava/classpath/doc/cp-vmintegration.texinfo
View File

@ -419,7 +419,7 @@ The method should return a map converting package names to boolean status
values. The stub implementation provides an empty map.
@item @code{classAssertionStatus()} -- Same as the last, but for classes.
@item @code{getSystemClassLoader()} -- The default calls @code{ClassLoader}
to create a new auxillary class loader with a system and extension class
to create a new auxiliary class loader with a system and extension class
loader. The VM may wish to replace it if it wishes to supply its own custom
system class loader.
@end itemize
@ -701,7 +701,7 @@ throw an appropriate exception.
@item @code{suspend()} -- The thread should be suspended until resumed.
@item @code{resume()} -- The thread should be resumed from its suspended state.
This pair of methods are deprecated, due to the possibility of a deadlock
occuring when a thread with locks is suspended.
occurring when a thread with locks is suspended.
@item @code{nativeSetPriority(int)} -- Called by @code{setPriority}
to allow the setting to flow down to the native thread.
@item @code{nativeStop(Throwable)} -- The VM should stop the thread abnormally
@ -736,7 +736,7 @@ The @code{VMMath} class provides a series of native methods
for some of the mathematical functions present in @code{java.lang.Math}.
Classpath provides a default implementation of these which maps the
functions to those provided by @code{fdlibm}. VM implementors are welcome
to replace this with more efficent implementations, as long as the accuracy
to replace this with more efficient implementations, as long as the accuracy
contract of these methods, specified in @code{java.lang.Math}, is maintained.
@itemize @bullet
@ -1540,7 +1540,7 @@ interface, and is supported by VM functionality in the form of
@code{gnu.java.lang.management.VMMemoryPoolMXBeanImpl}. Providing
this interface requires implementing a number of methods for each supported
pool. These return statistics on memory usage, and, optionally, allows
monitoring of when memory usage exceedes a preset threshold.
monitoring of when memory usage exceeds a preset threshold.
Optional support is determined by the following properties:
@ -1913,7 +1913,7 @@ mechanism.
@i{Green threads 1}: Green threads are threads scheduled by the VM,
typically by switching swapping registers. In early VMs green threads
were seen as advantageous as they didn't require the operating system
to resechedule, save and swap all of a threads registers. The green
to reschedule, save and swap all of a threads registers. The green
thread 1 model switches thread on an externally created event, such as
a timer interrupt. An example of a VM using this approach is Kaffe
configured with its jthreads model.
@ -1937,7 +1937,7 @@ model.
An example of the problem of mixing threading models is:
@itemize @bullet
@item
A Java thread calls a native method. The native method aquires a lock.
A Java thread calls a native method. The native method acquires a lock.
@item
The native method calls back into the VM.
@item
@ -1946,7 +1946,7 @@ An event triggers the VM to reschedule the currently running thread.
A new VM thread, executing on the same underlying native thread, calls
a native method.
@item
The native method tries to aquire the lock already aquired earlier. As
The native method tries to acquire the lock already acquired earlier. As
the lock is busy the thread waits and allows the operating system to
reschedule native threads.
@item
@ -1976,7 +1976,7 @@ and swap Java threads off of that native thread. The VM can't,
however, swap two blocked native threads that are potentially
deadlocking each other on a lock. The lock will be associated with the
native thread. To prevent this from happening the VM must hijack
functions that operate on locks. This is done by redifining the lock
functions that operate on locks. This is done by redefining the lock
functions inside the VM and configuring the linker so that it uses the
VMs symbol in preference to that of the external thread support
library. The VM's lock function can then reschedule Java threads if it