BLAZE-LIST(1)						    BlazeBlogger Documentation						     BLAZE-LIST(1)

NAME

       blaze-list - lists blog posts or pages in the BlazeBlogger repository

SYNOPSIS

       blaze-list [-cpqrsCPSV] [-b directory] [-I id] [-a author] [-t title] [-T tag] [-d day] [-m month] [-y year] [-n number]

       blaze-list -h|-v

DESCRIPTION

       blaze-list lists existing blog posts or pages in the BlazeBlogger repository. Additionally, it can also display basic repository
       statistics.

OPTIONS

       -b directory, --blogdir directory
	   Allows you to specify a directory in which the BlazeBlogger repository is placed. The default option is a current working directory.

       -I id, --id id
	   Allows you to display a single blog post or a page with the specified id.

       -a author, --author author
	   Allows you to list blog posts or pages by the selected author.

       -t title, --title title
	   Allows you to list blog posts or pages with matching title.

       -T tag, --tag tag
	   Allows you to list blog posts or pages with matching tag.

       -d day, --day day
	   Allows you to list blog posts or pages from the specified day of a month. The value has to be in the "DD" form.

       -m month, --month month
	   Allows you to list blog posts or pages from the specified month. The value has to be in the "MM" form.

       -y year, --year year
	   Allows you to list blog posts or pages from the specified year. The value has to be in the "YYYY" form.

       -n number, --number number
	   Allows you to specify a number of blog posts or pages to be listed.

       -p, --page
	   Tells blaze-list to list pages.

       -P, --post
	   Tells blaze-list to list blog posts. This is the default option.

       -S, --stats
	   Tells blaze-list to display statistics.

       -s, --short
	   Tells blaze-list to display each blog post or page information on a single line.

       -r, --reverse
	   Tells blaze-list to display blog posts or pages in reverse order.

       -c, --color
	   Enables colored output. When supplied, this option overrides the relevant configuration option.

       -C, --no-color
	   Disables colored output. When supplied, this option overrides the relevant configuration option.

       -q, --quiet
	   Disables displaying of unnecessary messages.

       -V, --verbose
	   Enables displaying of all messages. This is the default option.

       -h, --help
	   Displays usage information and exits.

       -v, --version
	   Displays version information and exits.

EXAMPLE USAGE

       List all blog post:

	 ~]$ blaze-list
	 ID: 11 | 2010-07-05 | Jaromir Hradilek

	     Title: Join #blazeblogger on IRC
	     Tags:  announcement

	 ID: 10 | 2009-12-16 | Jaromir Hradilek

	     Title: Debian and Fedora Packages
	     Tags:  announcement

	 etc.

       List all blog post in reverse order:

	 ~]$ blaze-list -r
	 ID: 1 | 2009-02-10 | Jaromir Hradilek

	     Title: BlazeBlogger 0.7.0
	     Tags:  release

	 ID: 2 | 2009-02-11 | Jaromir Hradilek

	     Title: BlazeBlogger 0.7.1
	     Tags:  release

	 etc.

       List all pages:

	 ~]$ blaze-list -p
	 ID: 5 | 2009-02-10 | Jaromir Hradilek

	     Title: Downloads

	 ID: 4 | 2009-02-10 | Jaromir Hradilek

	     Title: Themes

	 etc.

       List each blog post on a single line:

	 ~]$ blaze-list -s
	 ID: 11 | 2010-07-05 | Join #blazeblogger on IRC
	 ID: 10 | 2009-12-16 | Debian and Fedora Packages
	 etc.

       Display a short version of blog statistics:

	 ~]$ blaze-list -Ss
	 There is a total number of 11 blog posts and 5 pages in the repository.

SEE ALSO

       blaze-config(1), blaze-add(1)

BUGS

       To report a bug or to send a patch, please, add a new issue to the bug tracker at <http://code.google.com/p/blazeblogger/issues/>, or visit
       the discussion group at <http://groups.google.com/group/blazeblogger/>.

COPYRIGHT

       Copyright (C) 2009-2011 Jaromir Hradilek

       This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY
       WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Version 1.2.0							    2012-03-05							     BLAZE-LIST(1)