cil(1)
NAME
cil - the command-line issue list
SYNOPSIS
$ cil init $ cil summary $ cil list $ cil list --status=New $ cil list --label=Release-v0.1 $ cil list --is-open
$ cil add ... added issue 'cafebabe' ... $ cil show cafebabe $ cil edit cafebabe $ cil status cafebabe InProgress
$ cil comment cafebabe ... added comment 'deadbeef' ...
$ cil attach cafebabe filename.txt ... added attachment 'decaf7ea' ...
$ cil extract decaf7ea $ cil extract decaf7ea --filename=other_filename.txt
$ cil am email.txt
$ cil track $ cil fsck
DESCRIPTION
Cil is a small but useful command-line issue list. It saves issues,
comments and attachments as local files which you can check in to your
repository.
- init [--path=PATH] [--bare]
- Creates a local '.cil' file and an 'issues' directory. If PATH is
specified, the config file and directory will be created in the
destination directory. - Usually, cil will write a small ".cil" file such that you can use
various filter commands immediately and can also serve as an
example config file. Using "--bare" just touches the ".cil" config file ready for your own manipulation. - summary [filters]
- Displays a one line summary for each issue. You may filter on both the Status and Label fields.
- list [filters]
- Shows each issue with more information. You may filter on both the Status and Label fields.
- add Adds an issues after you have edited the input.
- show ISSUE
- Shows the issue name with more detail.
- status ISSUE NEW_STATUS
- Shortcut so that you can set a new status on an issue without
having to edit it. - depends-on ISSUE1 ISSUE2
- Shortcut so that cil will add a 'DependsOn' from issue 1 to issue
2. Conversley, issue 2 will also then contain a 'Precedes' pointer to issue 1. - precedes ISSUE1 ISSUE2
This is the exact opposite of "depends-on" and is here for
convenience and completeness. ie. issue 1 has to be completed
before issue 2. - status ISSUE NEW_STATUS
Shortcut so that you can set a new status on an issue without
having to edit it. - steal ISSUE
Shortcut to assign this issue to yourself. It reads your "~/.cilrc" file for your UserName and UserEmail and uses this to populate the "AssignedTo" field in the issue. - edit ISSUE
Edits the issue. If it changes, set the updates time to now. - comment ISSUE
Adds a comment to an issues after you have edited the input. - attach ISSUE FILENAME
Adds that particular filename to an existing issue. - extract ATTACHMENT [--filename=FILENAME]
Extracts the file from the attachment number. If filename if given uses that, otherwise it will use the original one saved along with the attachment. - am Applies an email message to the issue list. It tries to figure out
the type of email it is, whether it is a new issue or a comment on
an already existing issue. For example, if it can find valid issue
names in the subject or body of the message, it adds it as a
comment to that issue. If it can't find any valid issue names, it
presumes it's a new issue and adds that. - Note: this command will deal with Mailbox format files later on.
- track ISSUE
This command outputs one or more command which you should run so
that your VCS knows about your issue. It makes sure all the
comments and attachments are done too. - fsck
Tries to help you organise your issues if any aren't valid or have broken relationships.
FILTERS
Filters can be used on both the "summary" and "list" commands. Most can
be combined. See each individual filter for details.
ArrayThe ".cil" file is used to configure bits and pieces within cil for
this particular issue list. The following options are available and
where stated, may be declared multiple times:
- ArrayThe "~/.cilrc" file is read to configure the user's preferences for all
cil lists they're using. It is of the same format as the ".cil" file
and contains the following options: - UserName: Andrew Chilton
UserEmail: andychilton@gmail.com - UserName
Default: 'Name', Type: String - This is used as a default in the "CreatedBy" and "AssignedTo"
fields in any issues/comments/attachments you add. - UserEmail
Default: 'Email', Type: String - This is used as a default in the "CreatedBy" and "AssignedTo"
fields in any issues/comments/attachments you add.
BUGS
Probably. Let me know :-)
TODO
- To get a ToDo list for cil, clone the repo, find the issues/ dir and
type: - $ cil --is-open
- This gives the current outstanding issues in cil.
AUTHOR
Andrew Chilton <andychilton@gmail.com>
COPYRIGHT
Copyright (C) 2008 by Andrew Chilton
Cil is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version.
This program 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. See the GNU
General Public License for more details.
- You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/> or write
to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.