==================================================================
Snippet-title:		get_posts_for_month v2.0
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		18th August, 2005   London, UK
==================================================================


Content of zipped file:
-----------------------
snippet_get_posts_for_month.php
readme_get_posts_for_month.txt (this file)


Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[get_posts_for_month]] tag in any post which you make, or any or of your template files (e.g frontpage_template.html).
3) rebuild the FrontPage(s).
   

Description:
------------
* Outputs HMTL for a list of posts in the given month as URLs with the post 
* title as the URL text and the post's permalink as its destination. 
* The URLs are separated by a user defined string which si passed as a parameter.
*
* If parameters are invalid or no posts are found, then the string
* given in parameter noMatchString is returned (may be an empty string).
*
* Note to other snippet authors: I call this one from several of my other
* snippets; feel free to use it as a building block for some of yours.
* 

Parameters:
-----------
*
* If parameters are invalid or no posts are found, then the string
* given in parameter noMatchString is returned (may be an empty string).
*
* @param  string  weblog        - pass '.'for the current blog, '*' for
*                                 all blogs, or a blog title like 'my_blog'.
* @param  string  category      - name of category to which posts must belong
*                                 Can be passed as '*' to mean all.
* @param  string  author        - pass an author's name to restrict 
*                                 selection, or '*' for all authors,
*                                 or '.' for 'author of current entry' (for
*                                 use in your entrypage_template.html
* @param  int     monthYear     - month (1 to 12) and year (4 digits), sperated
*                                 by |  e.g  4|2006
* @param  string  formatString  - each line will be preceded by the entry
*                                 date formatted by this string (passed to
*                                 the PHPdate() function. e.g. y-m-d
*                                 Leave blank (default) for none. 
* @param  string  noMatchString - This will be returned if there are no
*                                 posts for the given month 
*                                 (default = empty string).
* @param  string  separator     - This will be output between each URL. For 
*                                 instance, passing '<br />' will put each URL
*                                 on a separate line, for a more formal 
*                                 appearance, whereas ' ~ ', will run them 
*                                 together, sepearted by ' ~ '. 
*                                 Why not experiment? (default = '<br />')
* @param  int     showCommentCount - if 0, then the number of comments will not
*                                    be shown.  If 1 (default), then the number
*                                    of comments will be shown after the title,
*                                    but only if non-zero
*                                        e.g, 'Boring entry (13 comments)'
*                                    if 2, then the number of comments will
*                                    always be shown, even if zero
*                                        e.g, 'I won the lottery (no comments)'
*                                    The texts are taken from your language file
*                                         e.g "Anschluss des Sudetenlands (4 Kommentare)"
* @access public
* @return string HTML as specified by the parameters.
*


* v 2.0 2006/10/19 Singapore
*  - d'oh! how could I have been so dumb. The snippet used to get all entries,
*    then