mpedit.1

debug source code under unix platform.

MPEDIT(1)                mpatrol library                MPEDIT(1)


NNAAMMEE
       mpedit  - edits a text file at a specific line number in a
       new window

SSYYNNOOPPSSIISS
       mmppeeddiitt [_o_p_t_i_o_n_s] [_s_o_u_r_c_e_f_i_l_e [_l_i_n_e_n_u_m_b_e_r]]

DDEESSCCRRIIPPTTIIOONN
       The mmppeeddiitt command is used to invoke a text  editor  on  a
       given  source  file and optionally jump to a specific line
       number.  It is used as a support command  by  the  mpatrol
       library  when the EEDDIITT or LLIISSTT options are used but it can
       quite easily be used as a command  in  its  own  right  if
       properly  configured.  Because it is a shell script it can
       be easily configured to support other  editors,  but  this
       unfortunately limits it to UNIX platforms at the moment.

       The _s_o_u_r_c_e_f_i_l_e argument must be the filename of the source
       file to be edited or listed.  If the source file does  not
       exist then the contents of the MMPPAATTRROOLL__SSOOUURRCCEEPPAATTHH environ-
       ment variable will be used to help locate the source file,
       even  if  the  filename  contained an absolute or relative
       path component.  This environment variable should  consist
       of  a  colon-separated  list  of directory names which may
       contain absolute paths  or  be  relative  to  the  current
       directory;  the  first  directory  in  the  list  will  be
       searched first.   If  the  MMPPAATTRROOLL__SSOOUURRCCEEPPAATTHH  environment
       variable  is  not set then only the current directory will
       be searched.

       If the _l_i_n_e_n_u_m_b_e_r argument is omitted then it  is  assumed
       to  be  _1.   The  text  editor will attempt to jump to the
       specified line after opening the source  file.   The  text
       editor  that mmppeeddiitt uses is controlled by setting the EEDDII--
       TTOORR environment variable.  This can be  set  to  the  full
       pathname of the text editor to use or it can be set to the
       command that would normally be used  to  invoke  the  text
       editor, but it cannot also contain command line options.

       The currently supported editors are vvii, vviimm, eellvviiss, eemmaaccss,
       xxeemmaaccss, ppiiccoo and nnaannoo, and if the EEDDIITTOORR environment vari-
       able is not set then the default will be vvii.  Selecting an
       unsupported text editor will result in an error.  However,
       you  can  edit the mmppeeddiitt file to add support for your own
       favourite text editor as long as  it  supports  a  way  to
       immediately  jump  to  a  specific  line number when it is
       first started up.  Note that the  text  editor  must  also
       open  a new window to edit the source file so that it does
       not obscure any mpatrol diagnostic  messages,  and  if  it
       does  not  support this then a new terminal window must be
       opened for it to use.

       If the ----lliissttiinngg option is given on the command line  then
       the  mmppeeddiitt  command will display a context listing of the
       source file at the specified line number to  the  standard
       error  output  stream instead of invoking the text editor.
       The listing will be annotated with line numbers  and  will
       also  show the contents of the five lines before and after
       the specified line if possible.

OOPPTTIIOONNSS
       ----eeddiittoorr <_f_i_l_e_n_a_m_e> [--ee]
              Specifies the text editor to use.   This  overrides
              the contents of the EEDDIITTOORR environment variable.

       ----hheellpp [--hh]
              Displays a quick-reference option summary.

       ----lliissttiinngg [--ll]
              Displays  a  context  listing  of  the  source line
              instead of invoking the text editor.

       ----ssoouurrccee--ddiirr <_d_i_r_e_c_t_o_r_y> [--II]
              Adds a directory to the search path used to  locate
              the source file.  Multiple ----ssoouurrccee--ddiirr options may
              be given, and each will be prepended  to  the  MMPPAA--
              TTRROOLL__SSOOUURRCCEEPPAATTHH  environment  variable in the order
              given on the command line.

       ----vveerrssiioonn [--VV]
              Displays the version number of the mmppeeddiitt  command.

SSEEEE AALLSSOO
       mmppaattrrooll(1), mmpprrooff(1), mmppttrraaccee(1), mmlleeaakk(1), mmppssyymm(1), hheexx--
       wwoorrddss(1), vvii(1), vviimm(1),  eellvviiss(1),  eemmaaccss(1),  xxeemmaaccss(1),
       ppiiccoo(1), nnaannoo(1), lliibbmmppaattrrooll(3), lliibbmmppaalllloocc(3).

       The mpatrol manual and reference card.

       http://www.cbmamiga.demon.co.uk/mpatrol/

AAUUTTHHOORR
       Graeme S. Roy <[e-mail]>

CCOOPPYYRRIIGGHHTT
       Copyright  (C)  1997-2002  Graeme  S. Roy <graeme.roy@ana-
       log.com>

       This library is free software;  you  can  redistribute  it
       and/or  modify  it under the terms of the GNU Library Gen-
       eral Public License as  published  by  the  Free  Software
       Foundation;  either  version 2 of the License, or (at your
       option) any later version.

       This library is distributed in the hope that  it  will  be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
       PURPOSE.   See  the GNU Library General Public License for
       more details.

       You should have received a copy of the GNU Library General
       Public  License  along with this library; if not, write to
       the Free Software Foundation, Inc., 59 Temple Place, Suite
       330, Boston, MA 02111-1307, USA.



Release 1.4               8 January 2002                        1