Bug#946029: espeak: inform that --stdin flag reads multi-line text and then speaks it after EOF

[Usawashi]

Package: espeak
Version: 1.48.04+dfsg-7
Severity: minor


Hello maintainers..!

There's two ways to have espeak read from stdin: 
- running it with no arguments, which makes it speak every line; and
- running it with the --stdin flag, which makes it read a text file (viz.
multi-line text) from stdin until the EOF, and then speak it all at
once.

I found out the difference between the two because, I wanted to 
pipe edbrowse, an interactive program, to espeak 
to make it speak out every new line of output -
so I read the manpage of espeak for flags to use stdin,
since some other programs in Debian require a flag.

I figured out after a while to not use that flag but,
it'd be nice if the manpage added 
a sentence or two in the description for the --stdin flag
mentioning this different behaviour from no-argument espeak.

Thank you! And sorry for my bad writing..


-- System Information:
Debian Release: 10.1
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.19.0-6-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE= (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages espeak depends on:
ii  libc6       2.28-10
ii  libespeak1  1.48.04+dfsg-7
ii  libgcc1     1:8.3.0-6
ii  libstdc++6  8.3.0-6

espeak recommends no packages.

espeak suggests no packages.

-- no debconf information