Abeni Logo

Abeni Quickstart


1. Configuring Abeni

You Must Be root

You must run Abeni as root. Previous versions of Abeni required you run as regular user and execute the emerge and ebuild commands with sudo.

Note: After discussion on the gentoo-dev mailing list, I've decided to hold off on incorporating sudo because upcoming versions of portage will not be depending on root except for the actual emerge process. When they relax the requirements of root, I'll add an option for using sudo from within Abeni.


Make sure you have read/write permissions for your PORTDIR_OVERLAY directory. If you haven't done so, edit /etc/make.conf and set the PORTDIR_OVERLAY variable.

Note: All ebuilds are saved in the PORTDIR_OVERLAY directory, therefore there is no 'Save as' menu option.

Miscellaneous Options

Under the 'Options' menu, click on 'Global Preferences'. Choose your external web browser (for help files), favorite editor, xterm program etc. The email address should be set to the address you use to log in to Bugzilla at bugs.gentoo.org. This is used in the Project Manager to download the status of ebuilds.

2. Creating a New Ebuild


When creating a new ebuild, you are first prompted for the package's URI. The ebuild name and package name are derived from this.

If you are creating an ebuild with a Source Forge URI, Abeni will convert it to the mirror:// format. This is a special format that lets portage check multiple Source Forge mirrors.

If you are creating an ebuild based on a live CVS version, enter 'CVS' instead of a URI. Abeni will then add the proper eclass inherit statement and CVS variables for you to fill in.

When you save your ebuild, you can look in the 'Output' tab and see what it looks like or press the F7 key to view or continue editing it in your favorite editor.

There is no file dialog when you save your ebuild. You can change the actual ebuild name in the field 'Ebuild File'.

Keyboard Shortcuts

  • F1 - Help (Launch web browser)
  • F2 - New Variable
  • F3 - New Function
  • F4 - Run 'ebuild' command
  • F5 - Run 'emerge' command
  • F7 - Edit this ebuild in external editor
  • F9 - Log window at bottom
  • F10 - Log window in separate tab
  • F11- Clear log window
  • Alt-x - Exit

This work is licensed under the Creative Commons - Attribution / Share Alike license.

Updated 29 August 2003
Rob Cakebread

Summary: This guide will get you started with Abeni if you're already familiar with creating ebuilds.
Copyright 2003 Rob Cakebread. Bugs/Comments -> Email robc At myrealbox Dot com.