readme

nedit 是一款linux下的开发源码的功能强大的编辑器

app-defaults file (/usr/lib/X11/app-defaults/NEdit) which overrides the
default settings in any new nedit version that you install, and may result in
missing accelerator keys or cosmetic appearance glitches.  If you are
re-installing NEdit for the entire system, just remove the existing app-
defaults file.  If you want to run a newer copy individually, get a copy of
the app-defaults file for this version the contrib sub-directory of the
distribution directory for this version on ftp.nedit.org (/pub/<version>/
contrib/nedit.app-defaults), and install it in your home directory or set
the environment variables XAPPLRESDIR or XUSERFILESEARCHPATH to point
to a directory and install it there.  In all cases, the file should be
named simply 'NEdit'.

No additional installation or resource settings are necessary on IRIX systems
before 6.3


HP-UX Systems

If you are using HPVUE and have trouble setting colors, for example part
of the menu bar stubornly remains at whatever HPVUE's default is, try setting:

   nedit*useColorObj: False

   
IBM AIX Systems

Due to an optimizer bug in IBM's C compiler, the file, textDisp.c, must be
compiled without optimization on some AIX systems.


Solaris (SunOS 5.3 and beyond) Systems

The nedit_solaris executable may require the environment variable OPENWINHOME
to be set to the directory where Open Windows is installed.  If this is not set
properly, NEdit will spew screenfulls of messages about translation table
syntax errors.

Solaris 2.4 -- Add -DDONT_HAVE_GLOB to the CFLAGS line in Makefile.solaris.

Solaris 2.5 -- Solaris 2.5 systems were shipped with a bad shared Motif
library, in which the file selection dialog (Open, Save, Save As, Include,
etc.) shows long path names in the file list, but no horizontal scroll bar,
and no way to read the actual file names.  Depending on your system, the
patch is one of ID# 103461-07, # 102226-19, or # 103186-21.  It affects all
Motif based programs which use the library.  If you can't patch your system,
you might want to just try the nedit_sunos executable (from ftp.nedit.org
/pub/<version>), which is statically linked with a good Motif.  You can also
set the X resource: nedit.stdOpenDialog to True, which at least gives you a
text field where you can enter file names by hand.

Solaris 2.6 -- If you're experiencing performance problems (windows come up
slowly), the patch for Sun's shared Motif library is ID# 105284-04.  Installing
the patch alone will improve nedit's performance dramatically.  The patch also
enables a resource, *XmMenuReduceGrabs. Setting this to True will eliminate the
delay completely.

SunOS 4.x Systems

On some SunOS systems, NEdit will also complain about translation table syntax
errors.  This happens when Motif can't access the keysym database, usually
located in the file /usr/lib/X11/XKeysymDB.  If this file exists on your
system, but NEdit fails to locate it properly, you can set the environment
variable XKEYSYMDB to point to the file.  If you can't find the file, or if
some of the errors persist despite setting XKEYSYMDB, there is a XKeysymDB
which you can use to update or replace your /usr/lib/X11/XKeysymDB file
available in the contrib sub-directory of the NEdit distribution directory.
If you don't want to change your existing XKeysymDB file, make a local copy
and set XKEYSYMDB to point to it.

If you find that some of the labeled keys on your keyboard are not properly
bound to the corresponding action in NEdit, try the following:

  1) Get a copy of motifbind.sun (for Sun standard keyboards), or
     motifbind.sun_at (for Sun PC style keyboards) from the NEdit contrib
     directory on ftp.nedit.org:/pub/<version>/contrib.
  2) Copy it to a file called .motifbind in your home directory.
  3) Shutdown and restart your X server.


COMPATIBILITY WITH PREVIOUS VERSIONS

Existing .nedit Files

As of version 5.1, NEdit employs a built-in upgrade mechanism which will
automatically detects .nedit files of older versions. In general, NEdit
will try to convert and insert entries to match the latest version.
However, in certain cases where the user has customized the default entries,
NEdit will leave them untouched (except for possible syntactic conversions).
As a result, the latest syntax highlighting patterns for certain languages may
not get activated, for instance, if the user has customized the entries. The
latest default patterns can always be activated through the
Preferences->Syntax Highlighting->Recognition Patterns menu, though.

Next, some version specific upgrading issues are listed. Note that 
non-incremental upgrading (eg., from 5.0 to 5.2) is supported too.

* Upgrading from 5.3 to 5.4

  - Resource syntax
  
    Basic colors, like the text foreground and background, are now true
    preferences.  A new dialog (Preferences > Default Settings > Colors) is
    provided to change them, previously only changeable from X resources. 
    Upon starting, NEdit will migrate any custom colors you have set from
    the old X resources.  Most users will not need to do anything.
    
    However, if you used X resources to dynamically change the colors on
    different invocations, you will need to use the new application-level
    resources instead.  See the .nedit file for details.
      
    In 5.3, color resources needed to be qualified by "nedit*" in order to
    prevent problems when the deepest color visual was not the default. 
    This is no longer necessary, and the qualification may be removed.
    
  - New location of configuration files
  
    The default location and name of NEdit's resource files has been changed.
    The most important change is the fact that they can now be stored in a
    custom directory, defined by the NEDIT_HOME environment variable. If the
    variable is not set, the directory defaults to ~/.nedit.
    The files have been renamed as follows:
    
       ~/.nedit        -> $NEDIT_HOME/nedit.rc
       ~/.neditmacro   -> $NEDIT_HOME/autoload.nm
       ~/.neditdb      -> $NEDIT_HOME/nedit.history
       
    For backward compatibility reasons, NEdit continues to use the old 
    convention when these files are already present. No attempt is made
    to force the user to adopt the new convention. 

    Users that would like to migrate to the new setup can do so manually 
    by moving and renaming the files.
    
  - Changed regular expression word boundary semantics and its effect
    on the syntax highlighting patterns.
  
    During the 5.4 development cycle, it was noted that the implementation 
    of NEdit's regular expression word boundary matching was rather
    unconventional. More in particular, the '<', '>', and '\B' patterns
    interpreted the boundary between any two characters of which at least
    one was not a word character as a word boundary. A striking effect of this
    was that the boundary between two spaces was considered to be a word
    boundary, which is obviously rather unintuitive. This has been corrected 
    in 5.4: the boundary between two characters is a word boundary, only if
    exactly one of them is a word character.

    Several of the built-in syntax highlighting patterns (implicitly) relied 
    on the old word boundary interpretation and they have been corrected too.
    
    However, if the user has customized some of these buggy built-in
    highlighting patterns, the automatic upgrading routines will NOT upgrade
    them in order not to loose any customizations. It is left up to the user
    to correct his/her customized patterns manually (using the corrected 
    built-in patterns as a guideline). 

    The following is a list of all language modes and patterns that have been
    corrected:
    
      Ada:         Based Numeric Literals
      Awk:         Numeric constant
      C++:         numeric constant
      C:           numeric constant
      CSS:         property, selector pseudo class
      Java:        decimal const, case numeric const
      JavaScript:  Numeric
      Lex:         numeric constant, markers
      Matlab:      Numeric const
      NEdit Macro: Built-in Vars, Numeric Const
      Pascal:      TP Numeric Values:
      Perl:        dq string, sq string, bq string, subroutine call, 
                   numerics, re match
      PostScript:  Number, Operator1
      Python:      Number
      SQL:         data types, keywords2
      Sh Ksh Bash: keywords, built ins 
      Tcl:         Keywords
      VHDL:        Numeric Literals
      Verilog:     Reserved WordsA, Numeric Literals, Delay Word, 
                   Pins Declaration
      XML:         element declaration keyword
      Yacc:        numeric constant, percent keyword, markers

    So, if the user has customized the highlighting definitions for any of 
    these language modes (not restricted to the listed patterns), (s)he is 
    strongly advised to restore the default patterns in the syntax 
    highlighting dialog and to re-apply his/her customizations.
    
    Moreover, it is advised to check any custom language modes for potential
    boundary matching problems as described above.

* Upgrading from 5.2 to 5.3

  There are no major changes in the format of the .nedit file for version
  5.2. Users that have customized the X Resources syntax highlighting 
  pattern may consider restoring the default patterns, as they resolve
  a performance issue when editing the .nedit file itself, for instance.
  
* Upgrading from 5.1 to 5.2

  There are no major changes in the format of the .nedit file for version
  5.2. NEdit will try to insert additional entries for the newly supported
  language modes and syntax highlighting patterns (CSS, Regex, and XML) and
  highlight styles (Pointer, Regex, Warning).

  Moreover, the formerly boolean 'showMatching' option will silently be
  converted to a tri-state value.

  Users that have customized some of the syntax highlighting patterns may
  consider restoring the default patterns, as many of them have been improved
  considerably.
  
* Upgrading from 5.0 to 5.1
  
  NEdit 5.1 makes significant changes to the syntax of regular expressions.
  Mostly, these are upward compatible, but two changes; introducing the brace
  operator, and changing the meaning of \0; are not. Brace characters must now
  be escaped with backslash, and & must be used in place of \0 in
  substitutions.

  NEdit 5.1 employs a built-in upgrade mechanism which will automatically
  detect pre-5.1 .nedit files and fix regular expressions which appear in
  user-defined highlight patterns. The automatic upgrade mechanism, however,
  can not fix regular expression problems within user-defined macros. If you
  have a macro which is failing under NEdit 5.1, you will have to fix it by
  hand.
  
* Upgrading from pre-5.0

  If you are upgrading from a pre-5.0 version of NEdit, there are significant
  changes to the macro language, and you are best off simply editing out the
  nedit.macroCommands section of your .nedit file, generating a new .nedit
  file, and then re-introducing your user-written commands into the new file.
  Most macros written for previous versions will function properly under the
  new macro language. The most common problems with old macros is lack of a
  terminating newline on the last line of the macro, and the addition of "<",
  ">", and now "{" to the regular expression syntax. These characters must now
  be escaped with \ (backslash). Also, if you have been using a font other
  than the default for the text portion of your NEdit windows, be sure to
  check the Preferences -> Default Settings -> Text Font dialog, and select
  highlighting fonts which match your primary font in size. Matching in height
  is desirable, but not essential, and sometimes impossible to achive on some
  systems. When fonts don't match in height, turning on syntax highlighting
  will cause the window size to change slightly. NEdit can handle unmatched
  font sizes (width), but leaving them unmatched means sometimes columns and
  indentation don't line up (as with proportional fonts).

FURTHER INFORMATION

More information is available in the file nedit.doc in this kit, from NEdit's
on-line help system, the man-pages and from the enclosed FAQ file. 
There is also a web page for NEdit at: http://nedit.org.  For discussion with
other NEdit users, or to receive notification of new releases you can
subscribe to one or more of the NEdit mailing lists, [e-mail],
[e-mail] or [e-mail].  The NEdit on-line help has information
on subscribing under Help -> Mailing Lists.


REPORTING BUGS


The preferred way to report bugs is to submit an entry on our web-based
bug tracker at:

  http://sourceforge.net/projects/nedit/

The NEdit developers subscribe to both [e-mail] and [e-mail],
either of which may be used for reporting bugs.  If you're not sure, or you
think the report might be of interest to the general NEdit user community,
send the report to [e-mail].  If it's something obvious and boring,
like we misspelled "anemometer" in the on-line help, send it to develop.  If
you don't want to subscribe to these lists, please add a note to your mail
about cc'ing you on responses.