5 -- project workspaces for emacs --
7 A project in this sense is:
8 * A set of files that you wish to operate with, and
9 * A set of commands bound to key shorcuts and menu entries
11 In particular eproject lets you switch between projects as easily as
21 F5 : Toggle project setup
22 Ctrl-F5 : Browse project directory in dired
23 Alt-Left : Previous file
29 Return : Open project, file, tool
30 <letter> : Quick search
31 Alt-<letter> : Activate link
32 Spacebar : Enter edit mode
33 Escape : Quit edit mode
37 a : Add file(s) to the project
47 This is the global project list. You can open and close projects,
48 and add new or already existing ones to the list.
54 Files are added to the project simply when they are first
55 visited. Similar they are removed then they get killed. New files
56 are inserted after the one that was last viewed.
62 Here you can enter some shell command lines with tools that you wish
63 to have at hand, and optionally bind them to key shortcuts. The
64 tools will show up in the menu also.
66 There are two options that can be put in front of commands:
68 -e <emacs-command> run lisp command or sexp
69 -in <directory> ... run command in specified directory.
70 (Relative paths refer to the project directory)
72 A new project is initialized with default tool commands. If you wish
73 to have a different default set, please edit 'prj-default-config' in
74 'eproject.el' near the top.
80 Currently there is only 'project-name'. If you add a new project,
81 the name is initialized to the directory name, but you can change it
88 In the project setup, hit the the spacebar to enter edit mode. You
89 can edit pretty much everything except it has little effect to
90 change the name of a project other than the current one.
92 Hit escape to quit the edit mode. Any changes to the configuration
93 are saved automatically when the project is closed.
100 To load eproject, add this line to your ~/.emacs:
102 (load "/path/to/eproject.el")
104 eproject will automatically start up with the last recently used
105 project. It will also restore the frame size and position. You can
106 start emacs with a specific project from the command line using:
108 'emacs -project <projectname>'.
129 eproject-prevfile (M-left)
130 eproject-nextfile (M-right)
135 eproject-setup-toggle (f5)
142 eproject-grep : run grep on the project files)
143 eproject-dired (C-F5) : dired project (add files with 'a')
144 eproject-killtool : kill compiler etc.
145 eproject-killbuffers : kill all buffers except project files
153 Copyright (C) 2008 grischka@users.sourceforge.net
155 This program is free software, released under the GNU General Public
156 License (GPL), Version 2. For details see:
158 http://www.fsf.org/licenses/gpl.html
160 This program is distributed in the hope that it will be useful, but
161 WITHOUT ANY WARRANTY; without even the implied warranty of
162 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
163 General Public License for more details.
165 Jan 17, 2008 -- grischka