neno: man page.

This commit is contained in:
Ole Tange 2017-03-31 15:13:50 +02:00
parent 6be767cbec
commit f16e209555

View file

@ -1,28 +1,67 @@
#!/bin/bash
# NAME
# neno - no error no output
#
# SYNOPSIS
# neno command1 [\; command2 ...]
#
# DESCRIPTION
# neno will print the output from both standard output and
# standard error if the composed command returns an error. If the
# composed command returns true, the output will be ignored.
#
# This is useful for cron jobs where you only want output if it
# failed.
#
# AUTHOR
# Ole Tange <tange@gnu.org>
#
# COPYRIGHT
# Copyright © 2012 Free Software Foundation, Inc. License
# GPLv3+: GNU GPL version 3 or later
# <http://gnu.org/licenses/gpl.html>. This is free software: you
# are free to change and redistribute it. There is NO WARRANTY,
# to the extent permitted by law.
: <<=cut
=pod
=head1 NAME
neno - no error no output
=head1 SYNOPSIS
B<neno> I<command1> [\; I<command2> ...]
=head1 DESCRIPTION
B<neno> will print the output from both standard output and standard
error if the composed command returns an error. If the composed
command returns true, the output will be ignored. This is useful for
cron jobs where you only want output if it failed.
=head1 EXAMPLE
Give output for missing file:
neno ls /missing-file
No output if file exists:
neno ls /bin/sh
=head1 AUTHOR
Copyright (C) 2017 Ole Tange,
http://ole.tange.dk and Free Software Foundation, Inc.
=head1 LICENSE
Copyright (C) 2012 Free Software Foundation, Inc.
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 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/>.
=head1 SEE ALSO
B<man>
=cut
print() {
cat $TMP/stdout >&3