// vim: set et sw=4 ts=8 ft=asciidoc tw=80: port-edit(1) ============ $Id: port-edit.1.txt 123948 2014-08-16 13:45:03Z cal@macports.org $ NAME ---- port-edit - Open the Portfile in an editor SYNOPSIS -------- [cmdsynopsis] *port* [*-D* 'portdir'] *edit* [--editor ] [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']] DESCRIPTION ----------- *port edit* will open the associated 'Portfile' in an editor. It will try to determine your favorite editor by respecting the environment variables *$VISUAL* or *$EDITOR* in this order. If none has been set it will fallback to '/usr/bin/vi'. Your shell will be blocked until the editor returns. The path to the 'Portfile' is passed as one single argument to the editor. If you specify multiple ports, the editor is executed multiple times for each of them one after another. [NOTE] If you edit a 'Portfile', your changes might be lost on the next sync. If you want to permanently use a changed 'Portfile', copy it to a local ports tree and edit it there. See also guide:development.local-repositories[The MacPorts Guide]. OPTIONS ------- *--editor *:: Use the specified 'editor', overriding environment variables. ENVIRONMENT ----------- *EDITOR*, *VISUAL*:: Specifies the editor to be launched. SEE ALSO -------- man:port[1], man:port-file[1], man:port-cat[1] AUTHORS ------- (C) 2009 The MacPorts Project Rainer Mueller