From ecca345f3ea63dfe85759311cea90227bdc4384a Mon Sep 17 00:00:00 2001
From: "Dmitrij D. Czarkoff" <czarkoff@gmail.com>
Date: Tue, 12 Jan 2016 21:01:30 +0100
Subject: Loading image data from standard input

This commit changes processing of arguments:

* When called without arguments (with or without flags), imv reads list of files
  from standard input.
* When called with "-" among arguments, read image data from standard input.
---
 doc/imv.1 | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

(limited to 'doc')

diff --git a/doc/imv.1 b/doc/imv.1
index cbd5c68..d883611 100644
--- a/doc/imv.1
+++ b/doc/imv.1
@@ -21,12 +21,8 @@ It supports a wide variety of image file formats, including animated gif files.
 .Nm
 reloads the current image if it detects changes to the file.
 .Pp
-When run with argument
-.Sq - ,
 .Nm
-reads the list of images from standard input.
-.Pp
-The options are as follows:
+accepts following flags:
 .Bl -tag -width Ds
 .It Fl a
 Default to showing images at actual size.
@@ -66,6 +62,17 @@ Setting this to zero disables slideshow mode, which is the default.
 .It Fl u
 Use nearest neighbour resampling. Recommended for pixel art.
 .El
+.Ss Reading from standard input
+When run with argument
+.Sq - ,
+.Nm
+reads image from standard input.
+Argument
+.Sq -
+may occur among other arguments, but only once.
+.Pp
+If no arguments supplied, reads list of files from standard input.
+.Pp
 .Sh CONTROLS
 .Bl -tag -width Ds
 .It Aq Cm left mouse button
@@ -111,6 +118,13 @@ Increase slideshow delay by one second
 .It Cm T
 Decrease slideshow delay by one second.
 When delay is zero, slideshow mode is disabled.
+.Sh EXAMPLES
+Load all files from directory
+.Pa dir :
+.Pp
+.Dl $ ls dir | imv
+or
+.Dl $ ls dir | xargs imv
 .Sh LEGAL
 This program 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
-- 
cgit v1.2.3