|
From: Brenda L. <asp...@us...> - 2003-05-13 22:31:12
|
Update of /cvsroot/squeak/squeak/platforms/unix/doc In directory sc8-pr-cvs1:/tmp/cvs-serv23266 Modified Files: squeak.1 Added Files: 3.5-1devel.RELEASE_NOTES Log Message: Ian Piumarta's release 3.5-1devel --- NEW FILE: 3.5-1devel.RELEASE_NOTES --- Major departures from 3.4: - MacOSX is now fully supported (Quartz window, audio input/output, drag&drop, etc.). X11 is also supported (if installed on the host machine). - Display and sound support code has been moved out of the main executable into runtime modules. The choice of display method (Quartz, X11, no display at all) and sound (MacOSX CoreAudio, OSS, NAS, Sun, no sound at all) can be changed via command-line options when staring the VM. - A new option `-nodisplay' has been added. It differs from `-headless' in that the former disables display entirely (making the memory footprint of the VM smaller) while the latter loads the display code but does not open the Window (but allowing the possibility of retroactively opening the window at a some later time). - A new option `-nosound' has been added and does for sound what `-nodisplay' does for the display. - Memory allocation for the heap is now dynamic, based on mmap(). The heap will grow and shrink as the image's memory requirements change over time. This can be disabled by giving the option `-memory <N>[nk]' which tells the VM to use a fixed-size heap. A new option `-mmap <N>[mk]' is provided to limit the size to which mmap() will dynamically grow the heap (the default is 1Gbyte or 75% of your available virtual memory, whichever is smaller). If both options are given then `-memory' has precedence (disabling the mmap()-based memory allocator). - The configure option `--with-audio=...' has been removed. configure will arrange to build as many sound modules for which it can find the required headers/libraries. - configure will also build as many window system support modules for which it can find headers/libraries. The options `--without-x' and `--without-quartz' are available to explicitly disable one or both. Index: squeak.1 =================================================================== RCS file: /cvsroot/squeak/squeak/platforms/unix/doc/squeak.1,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** squeak.1 12 May 2003 07:26:15 -0000 1.1 --- squeak.1 13 May 2003 22:31:09 -0000 1.2 *************** *** 5,8 **** --- 5,12 ---- .\" All rights reserved. .\" + .\" You are NOT ALLOWED to distribute modified versions of this file + .\" under its original name. If you want to modify it and then make + .\" your modifications available publicly, rename the file first. + .\" .\" This file is part of Unix Squeak. .\" *************** *** 13,17 **** .\" You may use and/or distribute this file ONLY as part of Squeak, under .\" the terms of the Squeak License as described in `LICENSE' in the base of ! .\" this distribution, subject to the following restrictions: .\" .\" 1. The origin of this software must not be misrepresented; you must not --- 17,21 ---- .\" You may use and/or distribute this file ONLY as part of Squeak, under .\" the terms of the Squeak License as described in `LICENSE' in the base of ! .\" this distribution, subject to the following additional restrictions: .\" .\" 1. The origin of this software must not be misrepresented; you must not *************** *** 21,25 **** .\" would be appreciated but is not required. .\" ! .\" 2. This notice must not be removed or altered in any source distribution. .\" .\" Using (or modifying this file for use) in any context other than Squeak --- 25,32 ---- .\" would be appreciated but is not required. .\" ! .\" 2. You must not distribute (or make publicly available by any ! .\" means) a modified copy of this file unless you first rename it. ! .\" ! .\" 3. This notice must not be removed or altered in any source distribution. .\" .\" Using (or modifying this file for use) in any context other than Squeak *************** *** 27,35 **** .\" directory `platforms/unix/doc' before proceeding with any such use. .\" ! .\" You are not allowed to distribute a modified version of this file ! .\" under its original name without explicit permission to do so. If ! .\" you change it, rename it. ! .\" ! .\" Last edited: 2002-10-16 15:23:18 by piumarta on emilia.inria.fr .\" .if @@\*(lq@ \{\ --- 34,38 ---- .\" directory `platforms/unix/doc' before proceeding with any such use. .\" ! .\" Last edited: 2003-03-02 22:22:14 by piumarta on emilia.inria.fr .\" .if @@\*(lq@ \{\ *************** *** 176,179 **** --- 179,196 ---- (the default behaviour) to find the name of the server to use. .TP + .BI "\-encoding " "enc" + specifies the internal character encoding to be used by Squeak. The correct value depends on + the way Squeak's internal fonts are encoded. Older images use + .B MacRoman + encoding within the image, newer images should use + .B ISO-8859-15 + (aka + .B Latin9\c + ). The correct value is + .B MacRoman + for image versions prior to 3.5, + .B ISO-8859-15 + for image versions 3.5 and later. + .TP .B \-fullscreen causes the Squeak window to occupy as much of the screen area as possible. *************** *** 240,243 **** --- 257,277 ---- \'. .TP + .BI "\-pathenc " "enc" + specifies the external character encoding to be used by Squeak when accessing the filesystem + (file and directory pathnames). The correct value depends on the local platform's characteristics. + If no encoding conversion should be performed then this should be set to the same encoding + as Squeak uses internally (see the + .I \-encoding + option). Otherwise + .B ISO-8859-15 + (aka + .B Latin9\c + ) might make sense on a filesystem with 8-bit names and + .B UTF-8 + for a filesystem that uses Unicode-based pathnames. The default is + .B UTF-8 + for version 3.5 and later of the VM (which is correct for at least MacOSX and RedHat 8, and + which in an ideal world will eventually be adopted by all Unix variants). + .TP .BI "-plugins " "path" specifies an alternative location for external plugins (collections *************** *** 274,277 **** --- 308,336 ---- buttons.) .TP + .BI "\-textenc " "enc" + specifies the external character encoding to be used by Squeak when exchanging clipboard + text with other applications that request/provide the selection converted to + .B STRING + data. The default is + .B UTF-8 + on MacOSX, and + .B ISO-8859-15 + (aka + .B Latin9\c + ) on other Unix systems. + Note that X11 applications requesting the selection converted to + .B STRING_UTF8 + data will (correctly) receive the clipboard text encoded as + .B UTF-8\c + , regardless of this setting. + + Squeak recognises a subset of the character set names defined by the IANA. + (If you prefer to use the international currency symbol + rather than the Euro symbol in external text then you might want to set this to + .B ISO-8859-1\c + , aka + .B Latin1\c + \&.) + .TP .B \-version prints three or more lines of version information, as follows: *************** *** 319,322 **** --- 378,386 ---- \' flag. (The value is ignored.) .TP + .B SQUEAK_ENCODING + the name of the internal character encoding used by Squeak. Equivalent to giving the \`\c + .B \-encoding\c + \' command-line option if set. + .TP .B SQUEAK_FULLSCREEN equivalent to \`\c *************** *** 370,373 **** --- 434,443 ---- \'. .TP + .B SQUEAK_PATHENC + the name of the character encoding used to construct file and directory names. + Equivalent to giving the \`\c + .B \-pathenc\c + \' command-line option if set. + .TP .B SQUEAK_PLUGINS see \`\c *************** *** 380,383 **** --- 450,459 ---- \' if set. .TP + .B SQUEAK_TEXTENC + the name of the character encoding used to copy/paste text from/to external applications. + Equivalent to giving the \`\c + .B \-textenc\c + \' command-line option if set. + .TP .B SQUEAK_XSHM equivalent to \`\c *************** *** 591,596 **** .RE .PP ! The latest version of Unix Squeak: .RS .B http://www-sor.inria.fr/~piumarta/squeak .RE --- 667,677 ---- .RE .PP ! The latest source and binary distributions of Unix Squeak: .RS .B http://www-sor.inria.fr/~piumarta/squeak + .RE + .PP + The list of IANA-registered character encoding names, of which a proper subset is recognised by Squeak: + .RS + .B http://www.iana.org/assignments/character-sets .RE |