NAME

vpick - visual pick, mark a message sequence by eye


SYNOPSIS

vpick [+folder] [-sequence name] [-newsequence [name]] [-cull] [-zero] [-reverse] [sequence]


SCREENSHOT


DOWNLOAD

The script source. vpick
A binary (PARchive) created with Perl 5.8.8 on i686 Linux vpick.gz

For testing the software without installing the REQUIREMENTS.


DESCRIPTION

A nifty little tool for those dyed-in-the-wool MH users whom occasionally envy those pine/elm/mutt users. For those times when you'll know what you want when you see it and mark just won't cut it. vpick allows you to check boxes for individual messages to save them in a sequence.

If you're lucky and your local curses library has mouse support you might even be the envy of your friends.

INTERFACE

Navigation


OPTIONS

Like MH commands, vpick options can be abbreviated to a shortest unique string, and any option that does not take an argument can be prefixed by no to override earlier options.

+folder

The name of the folder to edit a sequence for. Defaults to the current folder.

-sequence name

The name of the sequence to edit. Defaults to vpick.

sequence

Only display the messages in the specified sequence. You probably want -cull instead.

-cull, -nocull

Only display the messages currently in -sequence. Shorthand for:

 -seq foo foo
-reverse, -noreverse

View the folder in reverse order.

-newsequence name

Save the altered message sequence as this new name, rather than clobber the existing sequence. The sequence name is otpional, and defaults to vpick.

This is useful for catching up on a backlog of unread messages like so:

  -seq unseen -new -cull

This preserves your unseen sequence, so that when you rmm the chaff in vpick, unseen contains only wheat.

-zero, -nozero

Zeroing loads an empty sequence, -nozero flags existing messages from the sequence. Default is -nozero unless -sequence defaults to vpick. See REQUIREMENTS.


REQUIREMENTS

Curses::UI

To provide the nifty visual interface.

scan

Required to summarize folder contents. But then you use MH, you knew that.

mark OR Mail::Box::MH::Resource + Number::Range

Required to preserve sequences. The latter is preferred, without it some functionality will be disabled i.e; vpick will be forced to run as if -zero were given.

Strictly speaking, you can also use vpick with MBMHR and not Number::Range.


CAVEATS

If using mark instead of MBMHR and Number::Range with large sequences you may loose; blame the shell.

You should not do anything to alter message ordering/numbering while vpick is running e.g; sortm(1), folder(1) -pack Other operations are fine.


RESTRICTIONS

The scan format is embedded in the program, it doesn't seem worthwhile to abstract it to a user configurable setting.


SEE ALSO

mark(1), pick(1), scan(1)


AUTHOR

Jerrad Pierce <jpierce@cpan.org>.


LICENSE


CHANGES

0.14

Removed warning under modern perls

5.12 introduced a warning about prototypes that Curses::UI has not yet fixed

0.13

Fix inclusion of year in scan format.
Documentation clean-up.
Check profile for default switches, using the name we're invoked as.
Added display of -cull and -newsequence to the status line
Fixed exit status message, which didn't account for -newsequence.
Removed closing reverse tag from status
      Curses::UI implies support for that feature but it doesn't offer it yet :-/

0.12

Added -cull & -newsquence options

0.11

Fixed status bar, it always showed -zero

0.10

Fixed paging behavior, it only DWIMd if you were on the first item of a page.

0.09

Changed paging behavior to more closely Do What I Mean

0.08

Added support for ^Z

0.07

Added message viewing


TODO

shift for self or root to kill use vars
switch scan from qx to pipe read to minimize delay?
M-< / M-> for end/begin?
Add back </reverse> to status once Curses::UI better supports htmltext