Skip to content
Browse files

22587: update some distribution docs

  • Loading branch information...
1 parent 596d38f commit f5f90da9c0126f9a87e88b80845442ffd9ff1578 Peter Stephenson committed Aug 4, 2006
Showing with 45 additions and 36 deletions.
  1. +3 −0 ChangeLog
  2. +16 −21 INSTALL
  3. +1 −3 MACHINES
  4. +23 −11 NEWS
  5. +2 −1 README
View
3 ChangeLog
@@ -1,5 +1,8 @@
2006-08-04 Peter Stephenson <pws@csr.com>
+ * 22587: INSTALL, MACHINES, NEWS< README: update notes on
+ multibyte support and add references to news.
+
* 22586: Src/parse.c, Src/utils.c: minor warnings spotted
on Cygwin: unnecessary static declaration in parse.c, typo in
set_widearray, also comments on other warnings that are harder
View
37 INSTALL
@@ -264,37 +264,32 @@ Multibyte Character Support
---------------------------
Support for multibyte character sets that extend ASCII, such as UTF-8, is
-under development but the code in the line editor is sufficiently stable to
-be turned on by default in environments that provide full ISO 10646 support
-including the preprocessor definition __STDC_ISO_10646__. In principle
-this definition does not guarantee the full environment, but in practice
-systems with this defined also provide suitable library support. The shell
-does not probe for all the features, so on other systems use of multibyte
-support must be explicitly enabled when it is available.
+now reasonably close to complete, except that combining characters are not
+handled properly (some assistance with this problem would be appreciated).
+The configuration script should turn on multibyte support on all systems
+where it can be compiled successfully.
The support can be explicitly enabled or disable with --enable-multibyte or
---disable-multibyte. Reports of systems where multibyte support was not
-enabled by default but --enable-multibyte resulted in a usable shell would
-be appreciated. The developers are not aware of any need to use
+--disable-multibyte. The developers are not aware of any need to use
--disable-multibyte and this should be reported as a bug. Currently
-multibyte mode is believed to work automatically on:
+multibyte mode is believed to work on at least the following:
- All(?) current GNU/Linux distributions
-
-and to work when configured with --enable-multibyte on:
-
- OS X 10.4.3 (problems have been reported with multibyte characters
in HFS file names)
- NetBSD 2.0.2
- Solaris 8+ (inputting multibyte characters from the keyboard doesn't
work in some installations).
-
-The main shell is not yet aware of multibyte characters, so for example the
-length of a scalar parameter will return the number of bytes, not
-characters, and pattern tests likewise treat single bytes as if they were
-characters. This means that pattern tests such as ? and [[:alpha:]] do not
-work correctly with characters in multibyte character sets beyond the ASCII
-subset.
+ - Cygwin (though use of multibyte characters is somewhat non-standard).
+
+The corresponding shell option MULTIBYTE is now on by default in all
+emulation modes when multibyte support is enabled. Turning it off is not
+recommended unless there is a particular need to examine single bytes
+regardless of the locale. As the line editor bases its behaviour on the
+locale regardless of the option (in order to correspond to the displayed
+character set), the option should be left on during the execution of
+user-defined editor and completion widgets so that the behaviour
+corresponds to that of builtin widgets.
See chapter 5 in the FAQ for some notes on multibyte input.
View
4 MACHINES
@@ -180,9 +180,7 @@ SGI: IRIX 6.2, 6.3
SGI: IRIX 6.5
Should build `out-of-the-box'; however, if using the native
compiler, "cc" rather than "c99" is recommended. Compilation
- with gcc is also reported to work. Multibyte is supported,
- for example:
- CC=cc ./configure --enable-multibyte
+ with gcc is also reported to work. Multibyte is supported.
On 6.5.2, zsh malloc routines are reported not to work; also
full optimization (cc -O3 -OPT:Olimit=0) causes problems.
View
34 NEWS
@@ -5,27 +5,31 @@ CHANGES FROM PREVIOUS VERSIONS OF ZSH
Major changes between versions 4.2 and 4.3
------------------------------------------
-- There is support for multibyte character sets in the line editor,
- though not the main shell. See Multibyte Character Support in INSTALL.
+- There is support for multibyte character sets. This is now reasonably
+ close to complete, although Unicode combining characters don't work
+ properly. See Multibyte Character Support in INSTALL.
- The shell can now run an installation function for a new user
- (one with no .zshrc, .zshenv, .zprofile or .zlogin file) without
- any additional setting up by the administrator.
+ (a user with no .zshrc, .zshenv, .zprofile or .zlogin file) without
+ any additional setting up by the administrator. See "THE ZSH/NEWUSER
+ MODULE" in the zshmodules manual page.
- The manual now has a Roadmap section (manual page zshroadmap) to
give new users an indication of the most interesting parts of the
manual.
-- New option PROMPT_SP, on by default, to work around the problem that the
- line editor can overwrite output with no newline at the end.
+- New option PROMPT_SP (on by default): works around the problem that the
+ line editor can overwrite output with no newline at the end. See the
+ zshoptions manual page.
- New option HIST_SAVE_BY_COPY (on by default): history is saved by
- copying and renaming instead of directly overwriting.
+ copying and renaming instead of directly overwriting. See the
+ zshoptions manual page.
- New redirection syntax e.g. {myfd}>file opens a new file descriptor
and stores the number in $myfd, so that >&$myfd will work. Chosen
not to break existing code (and to be compatible with proposals for the
- Korn shell).
+ Korn shell). See the section REDIRECTION in the zshmisc manual page.
- Substitutions of the form ${var:-"$@"}, ${var:+"$@"} and similar where
word-splitting is applied to the text after the :- or :+ (in particular,
@@ -36,20 +40,28 @@ Major changes between versions 4.2 and 4.3
- New Posix-style zsh-specific tests [[:IDENT:]], [[:IFS:]],
[[:IFSSPACE:]], [[:WORD:]] test if character can appear in identifier,
is an IFS character, is an IFS whitespace character, or is considered
- as part of a word (is alphanumeric or appears in $WORDCHARS). Note
- the pattern code doesn't yet handle multibyte characters.
+ as part of a word (is alphanumeric or appears in $WORDCHARS). These
+ works correctly on multibyte characters if the appropriate support
+ is present. See the section FILENAME GENERATION in the zshexpn
+ manual page.
- The idiom =(<<<...) is optimised so that the shell internally turns
the ... into the contents of a file whose name is then substituted.
+ The syntax has always been usable by means of the NULLCMD feature,
+ but previously it generated an intermediate process; it has now
+ been rewritten along the same lines as the optimisation for $(<...)
+ that inserts a file into the command line without the use of an
+ external programme.
- Supplied functions catch and throw provide limited support for
exception handling using the `{ ... } always { ... }' syntax.
+ See the section EXCEPTION HANDLING in the zshcontrib manual page.
- Signals now accept the SIG as part of the name for compatibility with
other shells.
- Editor function argument-base allows non-decimal arguments for
- editor widgets.
+ editor widgets. See the entry in the zshzle manual page.
- As always, there are many enhancements to completion functions.
View
3 README
@@ -54,7 +54,8 @@ top bit set to be part of a shell identifier. Older versions of the shell
assumed all such octets were allowed in identifiers, however the POSIX
standard does not allow such characters in identifiers. The older
behaviour is still obtained with --disable-multibyte in effect.
-With --enable-multibyte set there are three possible cases:
+With --enable-multibyte in effect (this is now the default anywhere
+it is supported) there are three possible cases:
MULTIBYTE option unset: only ASCII characters are allowed; the
shell does not attempt to identify non-ASCII characters at all.
MULTIBYTE option set, POSIX_IDENTIFIERS option unset: in addition

0 comments on commit f5f90da

Please sign in to comment.
Something went wrong with that request. Please try again.