NEdit Version 5.0.2, March 11, 1998 NEdit is a standard GUI (Graphical User Interface) style text editor for programs and plain-text files. Users of Macintosh and MS Windows based text editors should find NEdit a familiar and comfortable environment. NEdit provides all of the standard menu, dialog, editing, and mouse support, as well as all of the standard shortcuts to which the users of modern GUI based environments are accustomed. For users of older style Unix editors, welcome to the world of mouse-based editing! This directory contains unbundled executables and documentation. The section, INSTALLATION, below has instructions for copying and installing these files. Please be sure to check the platform specific README files, i.e. README.sun and README.ibm, for additional information about your particular system. ---------------------------------------------------------------------------- TERMS AND CONDITIONS ==================== This software has been made freely available with a request for collaborative input subject to standard Fermitools Terms and Conditions given in full below. ---------------------------------------------------------------------------- AUTHORS Mark Edel, Joy Kyriakopulos, Arnulfo Zepeda-Navratil, Suresh Ravoor, Donna Reid, Jeff Kallenbach Fermi National Accelerator Laboratory - Mail Station 234 P.O Box 500 Batavia, IL 60510 Internet: nedit_support@fnal.fnal.gov Fermilab Standard Government Sponsorship Notice This work was performed at Fermi National Accelerator Laboratory, which is operated by Universities Research Association, Inc., under contract DE-AC02-76CHO3000 with the U.S. Department of Energy. ACKNOWLEDGEMENTS Syntax highlighting patterns were contributed by: Simon T. MacDonald, Maurice Leysens, Matt Majka, Alfred Smeenk, Alain Fargues, Christopher Conrad, Scott Markinson, Konrad Bernloehr, Ivan Herman, Patrice Venant, Christian Denat, Philippe Couton, Max Vohlken, and Markus Schwarzenberg. Regular expression code by Henry Spencer Nedit incorporates an altered version of Henry Spencer's regcomp and regexec code adapted for NEdit. Original copyright notice: Copyright (c) 1986 by University of Toronto. Written by Henry Spencer. Not derived from licensed software. Permission is granted to anyone to use this software for any purpose on any computer system, and to redistribute it freely, subject to the following restrictions: 1. The author is not responsible for the consequences of use of this software, no matter how awful, even if they arise from defects in it. 2. The origin of this software must not be misrepresented, either by explicit claim or by omission. 3. Altered versions must be plainly marked as such, and must not be misrepresented as being the original software. VERSION 5.0.2 5.0.2 is a bug fix release with very little new functionality (double-click selection of ranges of delimiters, $line, $column and $modified macro variables, smart-indent for Python). The full list of changes and fixes can be found in the ReleaseNotes file in the distribution directory. Version 5.0 was significant upgrade to NEdit, completing the macro language and adding, syntax highlighting, smart-indent, continuous wrap mode, language sensitive preferences, and many other new features. Please note that syntax highlighting patterns are mostly user-contributed, and that syntax highlighting is relatively new to NEdit. If you don't like the way your particular language is being highlighted, the patterns are quite easy to change. We would like to make the default patterns as robust and correct as possible, so if you see something wrong, please don't just grumble quietly to yourself, send mail to nedit_support@fnal.gov. As of this writing, there are no known bugs in this software, except for the few noted in the Problems/Bugs section of the on-line help, or the FAQ file and the ReleaseNotes file in the distribution directory. Please report any problems, even if you think they are trivial. INSTALLATION NEdit consists of a single, stand-alone executable file which does not require any special installation beyond copying it to your system and making it accessible to users. To install NEdit on Unix systems: 1) Copy the appropriate executable to your system using ftp in binary mode, changing the name to remove the _sgi, _ibm, etc. suffix. If you might want to run NEdit in client/server mode, also fetch the corresponding nc executable for your system type. 2) Check that the file(s) have execute permission. If not, use the chmod command to make them executable. 3) Add the directory containing the file to your path. To install NEdit on VMS systems: 1) Copy nedit_vms.exe or nedit_vms_axp.exe to your system using ftp in binary mode, changing the name to nedit.exe. If you might want to run NEdit in client/server mode, also fetch nc_vms.exe. 2) Define a foreign command called nedit to invoke the nedit executable (and equivalently for nc). For example, if nedit.exe were in the directory mydir on the disk called mydev, adding the following line to your login.com file would define the nedit command: $ ned*it :== $mydev:[mydir]nedit.exe Also check the platform specific README files, i.e. README.sun and README.ibm, for additional information about your particular system. RUNNING NEDIT If you are accessing a host Unix system from a remote workstation or X terminal, you need to set the Unix environment variable for your display: % setenv DISPLAY devicename:0 where devicename is the network node name of the workstation or X terminal where you are typing. On VMS systems, the equivalent command is: $ set display/create/node=devicename To run NEdit, simply type "nedit", optionally followed by the name of a file or files to edit. On-line help is available from the pulldown menu on the far right of the menu bar. For more information on the syntax of the nedit command line, look under the heading of "NEdit Command Line." COMPATIBILITY WITH PREVIOUS VERSIONS Existing .nedit Files NEdit 5.0.2 is backward-compatible with .nedit files from older versions (unless you wrote a .nedit file from the 5.0 beta-test version, or the experimental syntax highlighting version, as discussed below). However, if you are upgrading from a pre-5.0 version, you should check your font settings, and consider upgrading the original default macro menu entries as discussed below. 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). Most macros written for previous versions will function properly under 5.0's 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 ">" to the regular expression syntax. These characters must now be escaped with \ (backslash). The default macros written from 4.0 versions all work under 5.0, with the exception of "Unquote Mail Reply", which will fail because it uses the ">" character in a regular expression, which now must be escaped with "\". If you wrote a .nedit file from 4.0, you will have the old version of the macro, which needs to be updated. The 5.0 defaults for macro menu entries also contain some worthwhile new commands, and improvements to existing macros. To see what these new macros look like, you can temporarily re-name your existing .nedit file and run NEdit without one. There are several ways to integrate macros from the new version into an old .nedit file. If you have not added new macros of your own, simply remove the line beginning "nedit.macroCommands" and all of the indented lines which follow it from your existing .nedit file, and NEdit will re-generate the Macro menu from its stored defaults. If you have added macros of your own: 1) Temporarily re-name your existing .nedit file 2) Generate a new .nedit file by choosing Save Defaults from the Preferences menu. 3) Copy and paste the new macros from the newly generated .nedit file into the "nedit.macroCommands" resource in your old .nedit file. Beta 5.0 .nedit Files If you wrote a .nedit file from the beta-test version of 5.0, you will be missing one or two highlight styles used by default highlight patterns for Perl, Verilog, and NEdit Macro, and you will get an error on the FORTRAN highlight patterns, because the name has changed to "Fortran". If you want to preserve your existing .nedit file, you can edit it by hand to change the two occurences of "FORTRAN" to "Fortran", and either remove the section beginning "nedit.styles", or if you have made changes to styles that you want to preserve, re-name your .nedit file, write a new one, and integrate the new styles into your existing file. Experimental Syntax Highlighting Version .nedit Files If you wrote a .nedit file using the experimental syntax highlighting version (color_nedit.tar), the syntax of the languageModes resource has changed, and is not readable with 5.0. If you want to preserve the .nedit file, you will have to edit it by hand to remove the line beginning "nedit.languageModes", and all of the indented lines that follow. If you made significant changes to language mode information which you don't want to re-enter via the Language Modes dialog, you can edit each line of the resource by hand to conform to the new spec by adding colons to the end). FURTHER INFORMATION More information is available in the file nedit.doc in this kit, from NEdit's on-line help system, and from the enclosed FAQ file. There is also a web page for NEdit at: http://www-pat.fnal.gov/nirvana/nedit.html, or find out more about Fermilab: http://www.fnal.gov, or information on other publicly available Fermilab software: http://www.fnal.gov/fermitools. For discussion with other NEdit users, or to receive notification of new releases and news about news, you can subscribe to one or both of the official nedit mailing lists. You'll find information on subscribing in the NEdit on-line help under Mailing Lists. SUPPORT Help with the installation or use of NEdit is available by sending mail to nedit_support@fnal.fnal.gov which is auto-forwarded to the group in charge of NEdit support at Fermilab. This software is furnished by Fermilab on an "as is" basis as a service to the wider community with the goal of stimulating collaborative use and further development. Provision of the software implies no commitment of support by Fermilab. The Fermilab Computing Division is open to discussing other levels of support for use of the software with responsible and committed users and collaborators. Use of the software in experiments at Fermilab will be assured of a level of support as agreed to through the standard Memorandum Of Understanding process. Users may send mail to the mail address given above, with the expectation that it will be read and noted. Fermitools Special Products Because of the special support needed for a few selected products Fermilab is only able to support the software under special agreement. The support offered will be discussed and negotiated on an individual basis and may be different for different users. To initiate discussions send mail to the mail address given above. ---------------------------------------------------------------------------- TERMS AND CONDITIONS IN FULL ============================ ---------------------------------------------------------------------------- Fermitools Software Legal Information - October 16, 1997 ---------------------------------------------------------------------------- COPYRIGHT STATUS: Fermi National Accelerator Laboratory (FNAL) documents are sponsored by the U.S. Department of Energy under Contract No. DE-AC02-76CH03000. Therefore, the U.S. Government retains a non-exclusive, royalty-free license to publish or reproduce these documents or software for U.S. Government purposes. All documents and software available from this server are protected under the U.S. and Foreign Copyright Laws, and FNAL reserves all rights. Terms and Conditions -------------------- When a User distributes or otherwise obtains a software package included in the Fermilab Software Tools Program, the user agrees to abide by the Terms and Conditions of the Program below: o Any redistribution of the software shall be accompanied by this INFORMATION/LICENSE file and the product's ORIGIN file. o The User shall acknowledge the origin of the software as set forth below: "This work was performed at Fermi National Accelerator Laboratory, operated by Universities Research Association, Inc., under contract DE-AC02-76CH03000 with the U.S. Department of Energy." o The user is asked to feed back problems, benefits, and/or suggestions about the software to the Fermilab Software Providers and/or Fermitools management. o Any distribution of the software available from this server shall be at no charge, except for nominal media and distribution costs. To obtain a license to commercialize any of the software programs available from this server, contact FNAL's Office of Research and Technology Applications, P.O. Box 500, MS-200, Batavia, IL 60510-0500. Indemnification by User of Third Party Claims and Disclaimer of Liability ------------------------------------------------------------------------- The User, his/her directors, officers, employees, and agents hereby release and waive all claims against Universities Research Association, Inc. (URA) operator of Fermi National Accelerator Laboratory, its trustees, overseers, directors, officers, employees, agents, subcontractors, successors and assigns, for any and all liability and damages arising from the reproduction, use or other disposition of the software. The User shall indemnify URA and the U.S. Government for all damages, costs or expenses, including attorney's fees, arising from the utilization of the software, including, but not limited to, the making, using, selling or exporting of products, processes or services derived from the Software. The User agrees to indemnify, hold harmless and defend URA, its trustees, overseers, directors, officers, employees, agents, subcontractors, successors and assigns, against any and all liability, damage, loss, cost, charge, claim, demand, fee or expense of every nature and kind which may at any time hereafter, be sustained by URA by reason of claims of third parties arising out of alleged acts or omissions of the User in the reproduction, use or other disposition of the Software. The User agrees that URA, its trustees, overseers, directors, officers, employees, agents, subcontractors, successors and assigns shall not be liable under any claim, charge, or demand, whether in contract, tort, criminal law, or otherwise, for any and all loss, cost, charge, claim, demand, fee, expense, or damage of every nature and kind arising out of, connected with, resulting from or sustained as a result of the use of the software programs available from this server. In no event shall URA be liable for special, direct, indirect or consequential damages, losses, costs, charges, claims, demands, fees or expenses of any nature or kind. Disclaimer of Warranties ------------------------ The software is provided on an "as is" basis only. URA makes no representations, express or implied. URA MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product or process disclosed, or represents that the Software will not infringe any privately held patent, copyright, or trademark. The entire risk as to the results and the performance of this software is assumed by the User. Disclaimer of Endorsement ------------------------- Reference herein to any specific commercial products, process, or service by tradename, trademark, manufacturer or otherwise, does not constitute or imply its endorsement, recommendation, or favoring by the United States Government, U.S. Department of Energy or URA. The views and opinions of individuals expressed herein do not necessarily state or reflect those of the United States Government, U.S. Department of Energy or URA and shall not be used for advertising or product endorsement purposes. Liabilities of the Government ----------------------------- This software is provided by URA, independent from its Prime Contract with the U.S. Department of Energy. URA is acting independently from the Government and in its own private capacity and is not acting on behalf of the U.S. Government, nor as its contractor nor its agent. Correspondingly, it is understood and agreed that the U.S. Government has no connection to this software and in no manner whatsoever shall be liable for nor assume any responsibility or obligation for any claim, cost, or damages arising out of or resulting from the use of the software available from this server.