ppl 3.0.0 → 4.0.3

data/gh-pages/_posts/2012-12-20-1.0.0.md

@@ -0,0 +1,19 @@
+---
+title: 1.0.0
+summary: First public version
+date: 2012-12-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.0.0.html
+---
+
+This is the first publicly-announced release. Since none of the previous
+releases have been publicised in any way, it's assumed that nobody out there has
+been using them.
+
+This being the case, the changelog entry for `1.0.0` is effectively the set of
+all changes since the non-existence of the program until this version. So let's
+put that in list form as seems to be customary in changelogs:
+
+* ppl now exists

data/gh-pages/_posts/2012-12-20-1.1.0.md

@@ -0,0 +1,28 @@
+---
+title: 1.1.0
+summary: Hacker News feature requests and bugfixes
+date: 2012-12-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.1.0.html
+---
+
+These are some very quickly added changes resulting from this morning's exposure
+on [Hacker News](http://news.ycombinator.com/item?id=4947047). A few real
+show-stopping bugs have been fixed, and a new feature has been added for mutt
+users.
+
+Many thanks to [@storge](https://github.com/storge) on GitHub for all the help
+fixing the long series of issues in [Issue #1](https://github.com/hnrysmth/ppl/issues/1). You absolute legend.
+
+Also, thanks to [7h0ma5](http://news.ycombinator.com/user?id=7h0ma5) on HN for
+the [mutt integration suggestion](http://news.ycombinator.com/item?id=4947256)
+and the helpful documentation link. Support for usage as the backend to mutt's
+`query_command` option has been added in the form of [ppl
+mutt](/documentation/commands/mutt).
+
+* Fixed missing dependency declaration in gemspec
+* Fixed missing minimum ruby version in gemspec
+* Fixed completely broken and useless `ppl init` command
+* Added `ppl mutt` command

data/gh-pages/_posts/2012-12-20-1.2.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.2.0
+summary: ppl post
+date: 2012-12-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.2.0.html
+---
+
+A relatively small release in terms of new functionality, `1.2.0` simply adds
+the [ppl post](/documentation/commands/post) command. This command was always in
+the pipeline, but thanks anways to
+[nicky0](http://news.ycombinator.com/user?id=nicky0) on Hacker News for
+[prompting me](http://news.ycombinator.com/item?id=4947468) to prioritise it
+slightly.
+
+* Added `ppl post` command

data/gh-pages/_posts/2012-12-21-1.3.0.md

@@ -0,0 +1,20 @@
+---
+title: 1.3.0
+summary: XDG-compatible configuration
+date: 2012-12-21
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.3.0.html
+---
+
+Adds support for XDG-compatible configuration. Many thanks to
+[@tijn](https://github.com/hnrysmth/ppl/issues/4) on GitHub for [recommending this
+functionality](https://github.com/hnrysmth/ppl/issues/4).
+
+This means ppl can now be alternatively configured using a file at
+`~/.config/ppl/config`. If you like keeping your `~/` free of dotfile clutter
+then this is good news. If not, don't worry, `~/.pplconfig` continues working as
+normal.
+
+* Add support for XDG-compatible configuration file location

data/gh-pages/_posts/2012-12-21-thank-you-for-your-all-your-feedback.md

@@ -0,0 +1,26 @@
+---
+title: Thanks For All Your Feedback
+date: 2012-12-21
+layout: news
+section: news
+categories: [news]
+---
+
+Yesterday I worked up the courage to submit this project to Hacker News under
+the usual [Show HN](http://news.ycombinator.com/item?id=4947047) format. I was
+pleasantly surprised by how positive the feedback was overall. It was especially
+heartening to confirm that I'm not the only person out there who would be
+interested in using a command line address book!
+
+As a result of all the attention that came flooding in, questions were asked and
+answered, bugs were reported and fixed, and features were suggested and
+implemented. It was a really fun day.
+
+The elephant in the room is obviously sync functionality at this point.  Lots
+and lots of people have made it very clear that even though they think this
+project is a great idea it is useless in the extreme to them unless it can sync
+with their GMail or iCloud. Rest assured that [this has not gone
+unnoticed](https://github.com/hnrysmth/ppl/issues/5).
+
+Stay tuned!
+

data/gh-pages/_posts/2012-12-22-1.4.1.md

@@ -0,0 +1,21 @@
+---
+title: 1.4.1
+summary: Multiple email addresses per contact
+date: 2012-12-22
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.4.1.html
+---
+
+This version is a first step towards removing the annoying limitation of one
+email address, postal address and so on per contact. This isn't glamorous work
+but it's vital functionality.
+
+The ability to add more than one email address to a contact has been added. This
+is not 100% complete: email addresses cannot yet be deleted, for example. And
+[ppl show](/documentation/commands/show) does not yet show all the addresses
+(only [ppl email](/documentation/commands/email) does for now). But at least
+it's now possible to store the data
+
+* Contacts can now have more than one email address

data/gh-pages/_posts/2012-12-22-1.5.0.md

@@ -0,0 +1,17 @@
+---
+title: 1.5.0
+summary: ppl shell
+date: 2012-12-22
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.0.html
+---
+
+The addition of "interactive mode" in the form of [ppl
+shell](/documentation/commands/shell). Thanks to
+[@axelGschaider](https://github.com/axelGschaider) on GitHub for [the
+suggestion](https://github.com/hnrysmth/ppl/issues/7). This ought to make life a lot
+easier for people entering lots of commands at once!
+
+* Added `ppl shell` command

data/gh-pages/_posts/2012-12-23-1.5.1.md

@@ -0,0 +1,13 @@
+---
+title: 1.5.1
+summary: ppl post bugfix
+date: 2012-12-23
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.1.html
+---
+
+This is a very small release to fix one very small bug.
+
+* Fix fatal error in `ppl post <contact>` when contact has no address

data/gh-pages/_posts/2012-12-23-1.5.2.md

@@ -0,0 +1,15 @@
+---
+title: 1.5.2
+summary: ppl shell usability tweaks
+date: 2012-12-23
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.2.html
+---
+
+Another very small, very minor release addressing a usability issue with [ppl
+shell](/documentation/commands/shell).
+
+* Add "welcome" message to `ppl shell` explaining how to quit
+* Don't show "ppl>" prompt in `ppl shell` if stdin isn't a tty

data/gh-pages/_posts/2012-12-26-1.5.3.md

@@ -0,0 +1,19 @@
+---
+title: 1.5.3
+summary: Better 'no such contact' error message
+date: 2012-12-26
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.3.html
+---
+
+There have been a lot of internal changes in this release, and one user-facing
+change to improve the error message when a non-existent contact is specified in
+a command.
+
+Before this change, non-existent contacts resulted in a fairly cryptic error
+message consisting only of the given non-existent contact ID. From now on the
+problem is actually explained to the user.
+
+* Added a proper error message when a non-existent contact is specified

data/gh-pages/_posts/2012-12-27-1.6.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.6.0
+summary: ppl email --delete and bugfix
+date: 2012-12-27
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.6.0.html
+---
+
+This release contains a bugfix and the means for users to undo the minor damage
+caused by the bug. The bug was causing every new email address added by users to
+be saved against the contact *twice*. The fix stops that from happening. And a
+new feature has been added in the form of a `--delete` flag for [ppl
+email](/documentation/commands/email) so that dupliate addresses can be removed.
+
+* Fixed a bug causing duplicate email addresses to be saved
+* Added `--delete` flag to `ppl email`

data/gh-pages/_posts/2012-12-29-1.7.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.7.0
+summary: ppl show output overhaul
+date: 2012-12-29
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.7.0.html
+---
+
+This version contains some fairly substantial changes to the way the [ppl
+show](/documentation/commands/show) command formats its output. The need for
+this change was unearthed by a [question from
+@storge](https://github.com/hnrysmth/ppl/issues/14) on GitHub. In short, the command
+was only showing one of the given contact's email addresses, giving the
+impression that this was all that ppl supported storing.
+
+* Improved the output format of `ppl show`

data/gh-pages/_posts/2013-01-05-1.8.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.8.0
+summary: ppl url
+date: 2013-01-05
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.8.0.html
+---
+
+Added another attribute that contacts often have: URLs. For example, a given
+contact may have a profile page on some social network, a personal website, or
+any number of different possibilities. The new comand, [ppl
+url](/documentation/commands/url), works similarly to [ppl
+email](/documentation/commands/email) and allows you to store these URLs in your
+address book.
+
+* Added `ppl url` command

data/gh-pages/_posts/2013-01-06-1.9.0.md

@@ -0,0 +1,20 @@
+---
+title: 1.9.0
+summary: Aliases and ppl version
+date: 2013-01-06
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.9.0.html
+---
+
+This release adds two new features: the [version
+command](/documentation/commands/version), and support for
+[aliases](/documentation/configuration/alias). Both features function similarly
+to their git counterparts, albeit in a less complete way. For now the aliasing
+only supports simple aliasing of plain command names, and doesn't allow things
+like aliasing long chains of arguments or git's `!f() {}` style commands. These
+things will come in time.
+
+* Added `ppl version` command
+* Added rudimentary alias support

data/gh-pages/_posts/2013-01-10-1.10.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.10.0
+summary: Multiple organizations and phone numbers
+date: 2013-01-10
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.10.0.html
+---
+
+A lot of the work in this release went into some much-needed refactoring as a
+precautionary measure against accumulating too much technical debt early on. The
+code reuse enabled by this refactor facilitated the addition of some key
+functionality, too.
+
+* Added support for storing multiple organizations with `ppl org` command
+* Added support for storing multiple phone numbers with `ppl phone` command
+* Added support for deleting phone numbers with `ppl phone` command

data/gh-pages/_posts/2013-01-20-1.11.0.md

@@ -0,0 +1,14 @@
+---
+title: 1.11.0
+summary: ppl nick
+date: 2013-01-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.11.0.html
+---
+
+This is a simple release that just adds new functionality in the form of support
+for another vCard property: [nicknames](/documentation/commands/nick).
+
+* Added `ppl nick` command

data/gh-pages/_posts/2013-02-16-1.12.0.md

@@ -0,0 +1,14 @@
+---
+title: 1.12.0
+summary: ppl age
+date: 2013-02-16
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.12.0.html
+---
+
+This release adds the [age](/documentation/commands/age) command, which provides
+easy access to the ages of all contacts based on their dates of birth.
+
+* Added `ppl age` command

data/gh-pages/_posts/2013-02-17-1.13.0.md

@@ -0,0 +1,29 @@
+---
+title: 1.13.0
+summary: ppl push, pull and remote
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.13.0.html
+---
+
+The result of a lot of thought, this is the long-awaited git synchronisation
+functionality. What's been added are three new commands,
+[pull](/documentation/commands/pull), [push](/documentation/commands/push), and
+[remote](/documentation/commands/remote). These commands have no behaviour of
+their own, and are effectively aliases that execute their git counterparts
+inside the address book's directory.
+
+I think that this functionality is a good compromise: synchronising address book
+data can be accomplished using simple, familiar commands such as `ppl pull
+origin master`, and ppl itself is not unduly burdened with duplicating any git
+functionality.
+
+Another positive outcome of this work is that it brings proper git-style "bang"
+aliases closer to being a reality. The code changes required for these three
+commands lay a lot of the foundations necessary for bang aliases.
+
+* Added `ppl pull` command
+* Added `ppl push` command
+* Added `ppl remote` command

data/gh-pages/_posts/2013-02-17-1.14.0.md

@@ -0,0 +1,15 @@
+---
+title: 1.14.0
+summary: Bang aliases
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.14.0.html
+---
+
+Hot on the heels of `1.13.0`, this release brings the git-style bang alias
+functionality facilitated by the previous release's code changes. This allows
+the creation of aliases which execute a shell command.
+
+* Add bang alias support

data/gh-pages/_posts/2013-02-17-1.14.1.md

@@ -0,0 +1,18 @@
+---
+title: 1.14.1
+summary: Removes discrepancy with documentation
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.14.1.html
+---
+
+The release of `1.14.0` exposed a small screw-up in ppl's alias support. The
+`[alias]` section of the `~/.pplconfig` file was not being picked up at all.
+Instead it was looking for a section called `[aliases]`, which was insconsistent
+with the documentation and with git, on which the functionality is based. This
+release, therefore, is a fix for this issue: an `[alias]` section in
+`.pplconfig` should now work as described.
+
+* Fixed `[alias]` configuration

data/gh-pages/_posts/2013-02-17-two-months-in.md

@@ -0,0 +1,27 @@
+---
+title: Two Months In
+date: 2013-02-17
+layout: news
+section: news
+categories: [news]
+---
+
+It's been almost two months now since the big day of [ppl's public
+release](news/thank-you-for-your-all-your-feedback/). In that time, development
+has continued at a more steady, sustainable pace than during the period leading
+up to the release itself. New functionality has been added, and a few bugs have
+been fixed, as [the changelog](/development/changelog) will attest.
+
+One particularly nasty bug has been reported whose solution eludes me for the
+moment. It seems ppl does not cope well with [non-ASCII
+characters](https://github.com/hnrysmth/ppl/issues/17). The error itself is coming
+from within vpim - although it is almost certainly not a vpim bug - and is
+proving a tough nut to crack. Encodings in Ruby 1.9 are [fraught with
+complexity](http://yehudakatz.com/2010/05/05/ruby-1-9-encodings-a-primer-and-the-solution-for-rails/),
+but I'm optimistic about the existence of a simple solution.
+
+On a more positive note, it's worth mentioning that the overall health of the
+project seems to be good. I continue to enjoy building and maintaining ppl, and
+public interest in a command-line address book is as strong as could be expected
+for such a niche piece of software. Thanks for all your patience and support!
+