man page does not mention that -e is deprecated

[jimav]

gnome-terminal -e 'command...' emits a warning:

# Option “-e” is deprecated and might be removed in a later version of gnome-terminal.
# Use “-- ” to terminate the options and put the command line to execute after it.

However this is contrary to the man page, which says nothing about -e being deprecated, and does not mention anything about the new method being possible (-- followed by command and options).

Please update the documentation

STEPS TO REPRODUCE:

1. man gnome-terminal
2. gnome-terminal -e "sh -c 'ls -l; sleep 3'"

RESULTS: The documented method of specifying a command causes a deprecation warning.

EXPECTED RESULTS: Documentation should say how to do the right thing.

ProblemType: Bug
DistroRelease: Ubuntu 19.10
Package: gnome-terminal 3.34.0-1ubuntu2
ProcVersionSignature: Ubuntu 5.3.0-19.20-generic 5.3.1
Uname: Linux 5.3.0-19-generic x86_64
ApportVersion: 2.20.11-0ubuntu8
Architecture: amd64
CurrentDesktop: ubuntu:GNOME
Date: Wed Nov 6 10:20:44 2019
InstallationDate: Installed on 2019-02-06 (273 days ago)
InstallationMedia: Ubuntu 18.10 "Cosmic Cuttlefish" - Release amd64 (20181017.3)
SourcePackage: gnome-terminal
UpgradeStatus: Upgraded to eoan on 2019-10-25 (11 days ago)

[Launchpad Janitor (janitor)]

Status changed to 'Confirmed' because the bug affects multiple users.