.. comment: 
    :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 :ref:`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 
