It’s high time I posted a new set of instructions about how to build Pan Newsreader (for complete n00bz)!!!

First, fire up your terminal and install pan newsreader:

$ sudo apt-get install pan

So, why install pan, only to upgrade it?  Simply put, you don’t have to.  I like to, because then Ubuntu does nice things like makes the menu items so I can run this from Dash, installs icons, etc.

Next, we need to install the requirements needed to build pan.  These are the exact requirements that I needed from  fresh installs of Ubuntu 11.04 and 11.10.  Your mileage may vary!

$ sudo apt-get install git libgtk2.0-dev libgmime-2.4-dev gnome-common

This takes a while, and downloads over 100 MB of stuff…so it’s a good time to go read a goodnight story to your kids, or whatever it is you do in your spare time.  Note that I’m installing git, because it worked.  Previously I had to install kgit…again, YMMV.

Next, we need to clone the git source directory for pan.  We’ve installed git up above, so all we need to do is change to a convenient directory.  I like using my home directory, but you might choose another…

$ cd <<INSERT YOUR DIRECTORY HERE>>
$ git clone git://git.gnome.org/pan2

Let that run, and you’ll find a new directory entry called pan2.  Move into that, and let’s start the build process:  (Oh, by the way, if you want to make any alterations to pan like, for instance, changing the maximum number of concurrent  connections per server…now would be the time to do it!)

$ cd pan2
$ ./autogen.sh

You’ll see a bunch of things scroll past, as the compiler makes sure that you have all of the requirements, both in the compiler and the ancillary libraries, available and ready for use.  You will likely see a few complaints, but as long as no errors take place, you should be ok, and will be greeted with a cheery

Now type `make’ to compile Pan

So, let’s do just that, and actually build our binary with:

$ make

Now it’s time to go brew a cuppa your favorite caffeinated  beverage.  Once again, I might suggest a nice chai.  When everything calms down and your machine has flipped all the right bits, you should have a working binary file!  But, where is it?  And where should we put it?

Lets find out where your CURRENT pan binary is located:

$ which pan

This will probably return something like /usr/bin/pan – which is EXACTLY what it returned for me!  Make note of this, as you will need it … well, we’ll need it right now!  Let’s back up our current binary:

$ sudo mv /usr/bin/pan /usr/bin/pan_OLD

And let’s move the new binary into the old binary’s place, then set the correct owner.  Assuming you’re still in the pan2 directory from which we ran the autogen & make, you will find the pan binary hiding as:  ./pan/gui/pan
We’re in the final steps, now!

$ sudo cp ./pan/gui/pan /usr/bin/pan
$ sudo chown root:root /usr/bin/pan

You should now be able to run pan without any issues!  Let me know what you think of my tutorial, and how it worked out for you!

• Maudlin Mantis
• Morose Manatee
• Mellow Manatee
• Mossy Manatee
• Marauding Mongoose
• Marauding Mudskipper
• Magnanimous Moose
• Morose Moose
• Maternal Macaque
• Miffed Meerkat
• Majestic Mammoth
• Moody Martin

Also seen on the Ubuntu Blog: Masturbating Monkey!  :-)

Post your original creations (or links to your favorites found elsewhere) below!

For years, I have been a big fan of the usenet newsgroups. I think it’s one of the best little niches left on the internet, and it has one of the best ranges in content…  On usenet, you can have civilized, academic conversation, or unruly flame-wars between fanatics. You can also find some of the coolest binaries available on the net…hard-to-find music, out of print books in e-text, and pictures ranging from serene wallpapers to…well just about anything.

When Ubuntu’s newest version, Karmic Koala, came out, I was very dismayed to find that the distribution of the Pan newsreader available via the Synaptic package manager was broken.  Basically, any image that was posted as multi-part refused to load in the default window.

With some help from the folks on the pan-users mailing list, I was finally able to compile the code from a source repository being kept up by K.Haley, pan’s volunteer coder.  But I thought it might be nice to provide a step-by-step guide for newer linux users, as the whole process of downloading source from a github repository, the tracking down of the necessary development libraries, and the entire compilation process can be daunting.  Therefore, I came up with the following list of commands to run to get a patched version of Pan running from a normal install of Ubuntu 9.10 (Karmic Koala).

$ sudo apt-get install pan git git-core gnome-common libgtk2.0-dev libpcre3-dev libgmime-2.4-dev

This command is meant to be typed on a single line.  It will download quite a few libraries and a bunch of necessary programs & components.  It also installs the version of Pan included in Koala’s distribution streams, so that you will have the Ubuntu menu items already in place to run it easily.  When you’re done you should have everything you need to proceed.  Continue with the following:

$ cd ~
$ mkdir src
$ cd src
$ git clone git://github.com/lostcoder/pan2.git
$ cd pan2
$ sh ./autogen.sh --prefix=$HOME

You shouldn’t have any error messages during the autogen.  If you do, they’re likely due to missing programs or libraries needed to build the application.  Please post your error messages here!  If you didn’t receive any errors, type:

$ make

This will take a while…so go treat yourself to a coffee, soda or your preferred method of caffeine distribution.  (I might recommend a nice chai!) If the compile completes without incident, continue with:

$ make install
$ cd /usr/bin
$ ls pan

For safety’s sake, let’s back up pan so that we can restore the package maintainer’s version later…:

$ sudo mv pan pan.OLD

Now let’s keep on going:

$ sudo mv $HOME/bin/pan .
$ sudo chown root: pan

And you’re done! You should now be able to use the Pan icon located in the “Internet” section of your main Ubuntu menus to run your newly-compiled application.

Have fun!