[GRASS-git] [OSGeo/grass] 39868e: g.copy: Report failed copy using an error message ...

[Vaclav Petras]

  Branch: refs/heads/master
  Home:   https://github.com/OSGeo/grass
  Commit: 39868ea5c6112047525cc2e3a80802ad6c0956be
      https://github.com/OSGeo/grass/commit/39868ea5c6112047525cc2e3a80802ad6c0956be
  Author: Vaclav Petras <wenzeslaus at gmail.com>
  Date:   2020-11-17 (Tue, 17 Nov 2020)

  Changed paths:
    M general/g.copy/g.copy.html
    M general/g.copy/main.c
    M lib/manage/do_copy.c

  Log Message:
  -----------
  g.copy: Report failed copy using an error message (#1086)

Changes in behavior:

1. Non-zero return code (EXIT_FAILURE) has now also a corresponding
   error message (ERROR:) not just warning messages (from
   do_copy.c).
2. Skipping an input as ineligible for copying may now result in
   an error (fatal error with EXIT_FAILURE). The error newly occurs when
   all inputs are skipped or, most importantly, when only one input
   was provided and it was skipped.

The skipping (in main.c) is now consistently reported as skipping.
The warning messages also contain more details and the new error
messages point to them.

The M_do_copy function (do_copy.c) now starts with 'Copying' because
it is at the begining of the process instead of 'Copy' which is misleading
(is the user supposed to copy).

The user manual has now a new intro and newly describes the behavior on
error discussing the much simpler single input case separately.

Documentation mentions g.mapset -p and g.mapsets -p instead of mentioning
outdated `$MAPSET` and assuming that it is clear what mapset search path is.

Co-authored-by: Stefan Blumentrath <stefan.blumentrath at gmx.de>