fortune-mod-gentoo-doc

1. Introduction

This is the home of fortune-mod-gentoo-doc, a growing collection of quotes from the #gentoo-doc channel on irc.freenode.net. We in the GDP always have a party going on in our channel, so I figured throwing together a collection of memorable moments is a good way of sharing the madness.

Note: This package is still under heavy development. As such, I'm not responsible for broken, destroyed, or otherwise mangled systems as a result of installing this package. That said, it has been tested and runs perfectly on x86 and amd64 systems. It installs properly and displays quotes when asked -- it's not supposed to do much else, anyway.

If you'd like to contribute to the development of this package, please see the chapter on Contributing.

2. Installation

Setup

First, you have to setup your local Portage overlay. This is where the ebuild will be stored. Make sure you have defined this overlay in /etc/make.conf in the PORTDIR_OVERLAY variable.

Code Listing 2.1: Creating the overlay

# mkdir -p /usr/local/portage/games-misc/fortune-mod-gentoo-doc

Next, download the ebuild to the newly created directory:

Code Listing 2.2: Fetching the ebuild

# wget http://dev.gentoo.org/~nightmorph/gentoo-doc/fortune-mod-gentoo-doc-20061102.ebuild

As this package isn't found in the main tree, you must create the digest yourself. Fortunately, Portage makes this very easy.

Code Listing 2.3: Digesting the package

# ebuild fortune-mod-gentoo-doc-20061102.ebuild digest

Emerging

Before fortune-mod-gentoo-doc can be installed, you must add it to /etc/portage/package.keywords:

Code Listing 2.4: Keywording

# echo "games-misc/fortune-mod-gentoo-doc" >> /etc/portage/package.keywords

Note: fortune-mod-gentoo-doc is known to work on x86 and amd64 systems. For bug reports and support for other architectures, please see the Contributing chapter.

Next, install it:

Code Listing 2.5: Emerging the package

# emerge -avt fortune-mod-gentoo-doc

Once it's installed, you can browse the quotes by typing:

Code Listing 2.6: Reading a quote

$ fortune gentoo-doc
<rane> i hate gentoo because i'm out of beer

Presto! You know have your own collection of amusing and/or weird #gentoo-doc quotes.

3. Contributing

Contributions to this package are always welcome. If you run into any bugs, email me; do not report them on Gentoo's bugzilla. If you have tested this package on other architectures, let me know and I'll gladly keyword the ebuild.

I'd like to have a nice-sized collection of quotes, so if you hang out in #gentoo-doc and have quotes to share, feel free to email me! Just make sure that you've obtained permission from the original speaker(s).

Sure, #gentoo-doc isn't as busy as #gentoo-dev, but we have a pretty good time in there anyway. So drop by, have fun, and enjoy yourself. Maybe fix some documentation bugs while you're in there.

4. Acknowledgments

First, thanks to former Gentoo Linux developer Jon Portnoy (avenj), who has maintained the excellent fortune-mod-gentoo-dev ebuild for a number of years. His work was an ideal starting ground for my project.

And, of course, thanks to all the docs guys (and even the non-docs guys) who hang out in #gentoo-doc and make it the crazy fun place that it is . . . it's always a quotable channel. :)

The contents of this document, unless otherwise expressly stated, are licensed under the CC-BY-SA-2.5 license. The Gentoo Name and Logo Usage Guidelines apply.

Page updated November 8, 2006

Summary: This guide shows you how to install and use fortune-mod-gentoo-doc.

Joshua Saddler
Author

Donate to support our development efforts.