[[PageOutline]]
||[[Image(wiki:WikiStart:nepmd-icon.png, left)]]||

= netlabs.org EPM Distribution (NEPMD) =

NEPMD is an add-on for EPM, the Enhanced Editor of OS/2. NEPMD

- adds the EPM loader to start EPM in a special environment
- adds a library DLL
- replaces all of the original macro files.

The installation copies the EPM loader to a path, which comes before the
original EPM path in the PATH statement. That makes it replace the original
EPM for the WPS and CMD, without physically replacing it.

The advantages of NEPMD over EPM are:

- easier usage
- better configuration
- more features
- many fixes.

----
[[Image(wiki:WikiStart:nepmd-listtags.png, 372px, right)]]
== 1. Features ==

It comes with countless features and bug fixes for both programmers and
standard users, e.g.:

- user-friendly default configuration
- improved keyword highlighting
- configurable color schemes and info bars
- new menu, toolbar and additional keyset
- mode-dependent configuration including syntax expansion with
  coding styles and expression matching
- many new formatting options
- improved command shell features
- easier configuration to avoid macro recompilation
- advanced amount of configuration items.

The utility of EPM was greatly improved.

----
== 2. Changes ==

See the [./Changes] page.

----
== 3. Installation, update and prerequisites ==

EPM 6.03b should be installed by your OS/2 or eComStation installation program.
As an (not recommended) alternative, you can also install the ''EPM package for Warp 3 users''.

WarpIN should be installed, preferably the latest version.

Any newer version can be installed over an already installed one without uninstallation.

----
== 4. Downloads ==


[[Image(wiki:WikiStart:warpin.png, right)]]
=== ''Latest version'' ===

Version 1.21 (2020-03-16):
- ftp://ftp.netlabs.org/pub/nepmd/nepmd121_eng.wpi
- https://hobbes.nmsu.edu/download/pub/os2/apps/editors/epm/nepmd121_eng.wpi
- ftp://hobbes.nmsu.edu/pub/os2/apps/editors/epm/nepmd121_eng.wpi
It can be considered as a beta version of 2.00. The only reason, why it's not named 2.00, is that it lacks updated documentation.


[[Image(wiki:WikiStart:nepmd-selectdownloaddict.png, 300px, right)]]
=== ''Spell-check dictionaries'' ===


These Netscape dictionaries work with EPM and oslexam.dll:
- ftp://ftp.netlabs.org/pub/nepmd/dicts/
To download and install dictionaries, execute ''Format'' -> ''Spell check'' -> ''Configure dictionaries...'' Press ''Edit...'', followed by ''Download...'' Then select a language. wget is required for that.

Other dictionaries either don't find a word or make EPM crash.

With older NEPMD versions, download dictionaries and unzip them to ''myepm\spellchk''. Then open the ''Configure dictionaries...'' dialog to add a language.

Original, outdated links for Netscape dictionaries:
- http://service.boulder.ibm.com/asd-bin/doc/en_us/nsdicts/f-server.htm
- http://ftp.leo.org/historic/comp/os/os2/boulder/netscape/nsdicts/

Link for !XyWrite dictionaries:
- http://www.xywrite.com/dics/index.htm

With oslexam.dll, IBM Works and most Netscape dictionaries work. Most !XyWrite dictionaries don't work.


=== ''Outdated versions'' ===

Version 1.20 (2019-03-21):
- ftp://ftp.netlabs.org/pub/nepmd/nepmd120_eng.wpi

Version 1.19 (2018-10-19):
- ftp://ftp.netlabs.org/pub/nepmd/nepmd119_eng.wpi

Version 1.18 (2018-02-20):
- ftp://ftp.netlabs.org/pub/nepmd/nepmd118_eng.wpi

Version 1.00 (2002-11-05):
- ftp://ftp.netlabs.org/pub/nepmd/nepmd100_eng.wpi

=== ''Future releases'' ===

NEPMD has changed extremely, compared to the first release version 1.00.

Updated documentation is needed to find how to take advantage of the many new features. Some are self-explaining (e.g. by the menu items), but some are not. Therefore the version 2.00 is planned to ship with a usable set of documentation files.

For people who like to try out new features without any existing documentation, the versions from 1.18 on were released.

The version 2.00 beta will be released when everything except a recent documentation is included. This will include also a major change of the macro filenames, where macro code is placed and how files are assigned to WarpIN packages.


=== ''EPM package for Warp 3 users'' ===
[[Image(wiki:WikiStart:os2-warp-3-logo.png, 100px, right)]]

This WarpIN package was assembled from the EPMBBS files. The latest
available version is older than EPM 6.03b of Warp 4.
- ftp://ftp.netlabs.org/pub/nepmd/nepmd_oldbins.wpi
- http://hobbes.nmsu.edu/download/pub/os2/apps/editors/epm/nepmd_oldbins.wpi
- ftp://hobbes.nmsu.edu/pub/os2/apps/editors/epm/nepmd_oldbins.wpi
To install it, copy it to the directory of the main WPI file before starting the installation.


=== ''Symmetric Multiprocessing'' ===

To avoid crashes during scrolling on SMP systems, the EPM.EXE executable needs to be marked as single-processor type. That executable is usually located in \OS2\APPS. Other executables, distributed by NEPMD, are not affected.

Starting with version 1.22, the NEPMD does that on installation. For other cases, it's possible to download [http://svn.netlabs.org/repos/nepmd/trunk/src/netlabs/install/epmsp.cmd this CMD file] and execute it manually.

----
== 5. Source code ==

=== ''Browse files'' ===

Trac browser:
- http://trac.netlabs.org/nepmd/browser
Current revision:
- http://svn.netlabs.org/repos/nepmd/trunk/
Any other revision, here r3165:
- http://svn.netlabs.org/repos/nepmd/!svn/bc/3165/trunk/

=== ''Get all files'' ===

Check out the trunk. That suffices in most cases:
{{{
md nepmd
cd nepmd
svn checkout http://svn.netlabs.org/repos/nepmd/trunk
}}}

If you really want to check out the entire archive (trunk, tags and branches):
{{{
md nepmd
cd nepmd
svn checkout http://svn.netlabs.org/repos/nepmd
}}}

=== ''Branches and tags'' ===

In the past it was avoided to create branches. Additionally, with the change from CVS to SVN, it doesn't make much sense to create tags copied from the trunk anymore. A special version can always be checked out by adding the `-r <rev_num>` option.

||= Revision number =||= Version number =||= Build date time (local) =||
||  3918             ||  1.21            ||  2020-03-16 08:30:00      ||
||  3543             ||  1.20            ||  2019-03-21 08:30:00      ||
||  3209             ||  1.19            ||  2018-10-19 21:30:00      ||
||  2948             ||  1.18            ||  2018-02-20 21:00:00      ||

----
== 6. Status of the current repository ==

The trunk contains the most recent files. It should always be kept compilable and installable. In the past, the trunk version was always of much more value than any outdated version.

=== ''Documentation'' ===

The NEPMD help files are outdated. The same applies to the EPM help, where much of its content refers to the old 16-bit version for EPM 5.

Adding recent help files to NEPMD is planned, but will take much time.

=== ''National language support'' ===

The current version of the NEPMD is not prepared for translation. Output strings are not separated from source code, so it makes no sense to translate it now.

----
== 7. Help and information ==

=== ''Bug tracker'' ===

You're welcome to [http://trac.netlabs.org/nepmd/newticket post] your bugs on the [http://trac.netlabs.org/nepmd/report/6 bug tracker].

Before posting bugs, you must log in with your netlabs.org account. If you do not have a login id, you can request one at [http://www.netlabs.org/en/site/member/member.xml].

The decision was made to use [http://svn.netlabs.org/nepmd/report trac's bug tracker] instead of [http://xtracker.netlabs.org/index.php?project=16 xTracker]. If you want to receive email notifications when your bugs were changed, first login and then ensure that your email address on your account's [http://trac.netlabs.org/nepmd/prefs Preferences page] was added.

=== ''Newsgroups and mailing lists'' ===

For questions, you could use the user newsgroup on:
- news.gmane.org.netlabs.nepmd.user

If you compile NEPMD yourself, you could use the developer newsgroup on:
- news.gmane.org.netlabs.nepmd.devel

For more infos about the lists and for the newsgroup or mailing list interfaces, see here:
- http://wiki.netlabs.org/index.php/Mailinglists
The NEPMD list names are ''nepmd-user'' and ''nepmd-dev''.

=== ''Presentations and review'' ===

- [ftp://ftp.netlabs.org/pub/nepmd/presentations/nepmd_wse2002.zip Warpstock Europe 2002, Arnhem]
- [ftp://ftp.netlabs.org/pub/nepmd/presentations/nepmd_wse2006.zip Warpstock Europe 2006, Cologne]
- [ftp://ftp.netlabs.org/pub/nepmd/presentations/nepmd_wse2008.zip Warpstock Europe 2008, Dusseldorf]
- [http://www.os2ezine.com/20030216/page_3.html Douglas Clark's review about NEPMD 1.00]

----