:orphan:

.. _popy_edit:

popy_edit
###########

Opens a text file in an editor from the command line.

.. _popy_edit_single_script:

Edit a script
==================

To edit a script in a text editor, :ref:`open_a_popy_command_prompt` and call:-

.. code-block:: console

    $ popy_edit my_script.pyml

The editor invoked by :command:`popy_edit` is defined in the :ref:`popy_config_pyml` file. 
    
.. _popy_edit_multi_scripts:

Edit multiple scripts
=========================

Note you can also open all scripts in a directory using:-

.. code-block:: console

    $ popy_edit *.pyml

This opens all files with the '.pyml' extension in your default editor.
    
.. _popy_edit_specify_editor:
    
Specify text editor
=====================
    
By default this uses the entry **text_editor_path** in this file:-

.. code-block:: console

    c:\PoPy\popy_config.pyml
    
If the default editor does not exist then the chosen editor is the first binary found in this list:-

* C:\\Program Files\\Notepad++\\notepad++.exe
* C:\\Program Files (x86)\\Notepad++\\notepad++.exe
* C:\\Windows\\notepad.exe

Also see :ref:`configure_editor`.
        
.. _popy_edit_command_line_options:
  
Command line options
======================

.. literalinclude:: /_autogen/tool_help/popy_edit_help.inc
    :language: console 
