diff --git a/cmd/utils/flags_legacy.go b/cmd/utils/flags_legacy.go
index d253adfa7f..90647bdb65 100644
--- a/cmd/utils/flags_legacy.go
+++ b/cmd/utils/flags_legacy.go
@@ -43,99 +43,99 @@ var ShowDeprecated = cli.Command{
 }
 
 var (
-	LegacyTestnetFlag = cli.BoolFlag{ // TODO(q9f): Remove after Ropsten is discontinued.
+	LegacyTestnetFlag = cli.BoolFlag{ // (Deprecated April 2020) TODO(q9f): Remove after Ropsten is discontinued.
 		Name:  "testnet",
 		Usage: "Pre-configured test network (Deprecated: Please choose one of --goerli, --rinkeby, or --ropsten.)",
 	}
-	LegacyLightServFlag = cli.IntFlag{ // Deprecated in favor of light.serve, remove in 2021
+	LegacyLightServFlag = cli.IntFlag{ // (Deprecated June 2019) Deprecated in favor of light.serve, remove in 2021
 		Name:  "lightserv",
 		Usage: "Maximum percentage of time allowed for serving LES requests (deprecated, use --light.serve)",
 		Value: eth.DefaultConfig.LightServ,
 	}
-	LegacyLightPeersFlag = cli.IntFlag{ // Deprecated in favor of light.maxpeers, remove in 2021
+	LegacyLightPeersFlag = cli.IntFlag{ // (Deprecated June 2019) Deprecated in favor of light.maxpeers, remove in 2021
 		Name:  "lightpeers",
 		Usage: "Maximum number of light clients to serve, or light servers to attach to  (deprecated, use --light.maxpeers)",
 		Value: eth.DefaultConfig.LightPeers,
 	}
-	LegacyMinerThreadsFlag = cli.IntFlag{
+	LegacyMinerThreadsFlag = cli.IntFlag{ // (Deprecated April 2018)
 		Name:  "minerthreads",
 		Usage: "Number of CPU threads to use for mining (deprecated, use --miner.threads)",
 		Value: 0,
 	}
-	LegacyMinerGasTargetFlag = cli.Uint64Flag{
+	LegacyMinerGasTargetFlag = cli.Uint64Flag{ // (Deprecated April 2018)
 		Name:  "targetgaslimit",
 		Usage: "Target gas floor for mined blocks (deprecated, use --miner.gastarget)",
 		Value: eth.DefaultConfig.Miner.GasFloor,
 	}
-	LegacyMinerGasPriceFlag = BigFlag{
+	LegacyMinerGasPriceFlag = BigFlag{ // (Deprecated April 2018)
 		Name:  "gasprice",
 		Usage: "Minimum gas price for mining a transaction (deprecated, use --miner.gasprice)",
 		Value: eth.DefaultConfig.Miner.GasPrice,
 	}
-	LegacyMinerEtherbaseFlag = cli.StringFlag{
+	LegacyMinerEtherbaseFlag = cli.StringFlag{ // (Deprecated April 2018)
 		Name:  "etherbase",
 		Usage: "Public address for block mining rewards (default = first account, deprecated, use --miner.etherbase)",
 		Value: "0",
 	}
-	LegacyMinerExtraDataFlag = cli.StringFlag{
+	LegacyMinerExtraDataFlag = cli.StringFlag{ // (Deprecated April 2018)
 		Name:  "extradata",
 		Usage: "Block extra data set by the miner (default = client version, deprecated, use --miner.extradata)",
 	}
-	LegacyRPCEnabledFlag = cli.BoolFlag{
+	LegacyRPCEnabledFlag = cli.BoolFlag{ // (Deprecated April 2020)
 		Name:  "rpc",
 		Usage: "Enable the HTTP-RPC server (deprecated, use --http)",
 	}
-	LegacyRPCListenAddrFlag = cli.StringFlag{
+	LegacyRPCListenAddrFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "rpcaddr",
 		Usage: "HTTP-RPC server listening interface (deprecated, use --http.addr)",
 		Value: node.DefaultHTTPHost,
 	}
-	LegacyRPCPortFlag = cli.IntFlag{
+	LegacyRPCPortFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "rpcport",
 		Usage: "HTTP-RPC server listening port (deprecated, use --http.port)",
 		Value: node.DefaultHTTPPort,
 	}
-	LegacyRPCCORSDomainFlag = cli.StringFlag{
+	LegacyRPCCORSDomainFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "rpccorsdomain",
 		Usage: "Comma separated list of domains from which to accept cross origin requests (browser enforced) (deprecated, use --http.corsdomain)",
 		Value: "",
 	}
-	LegacyRPCVirtualHostsFlag = cli.StringFlag{
+	LegacyRPCVirtualHostsFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "rpcvhosts",
 		Usage: "Comma separated list of virtual hostnames from which to accept requests (server enforced). Accepts '*' wildcard. (deprecated, use --http.vhosts)",
 		Value: strings.Join(node.DefaultConfig.HTTPVirtualHosts, ","),
 	}
-	LegacyRPCApiFlag = cli.StringFlag{
+	LegacyRPCApiFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "rpcapi",
 		Usage: "API's offered over the HTTP-RPC interface (deprecated, use --http.api)",
 		Value: "",
 	}
-	LegacyWSListenAddrFlag = cli.StringFlag{
+	LegacyWSListenAddrFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "wsaddr",
 		Usage: "WS-RPC server listening interface (deprecated, use --ws.addr)",
 		Value: node.DefaultWSHost,
 	}
-	LegacyWSPortFlag = cli.IntFlag{
+	LegacyWSPortFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "wsport",
 		Usage: "WS-RPC server listening port (deprecated, use --ws.port)",
 		Value: node.DefaultWSPort,
 	}
-	LegacyWSApiFlag = cli.StringFlag{
+	LegacyWSApiFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "wsapi",
 		Usage: "API's offered over the WS-RPC interface (deprecated, use --ws.api)",
 		Value: "",
 	}
-	LegacyWSAllowedOriginsFlag = cli.StringFlag{
+	LegacyWSAllowedOriginsFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "wsorigins",
 		Usage: "Origins from which to accept websockets requests (deprecated, use --ws.origins)",
 		Value: "",
 	}
-	LegacyGpoBlocksFlag = cli.IntFlag{
+	LegacyGpoBlocksFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "gpoblocks",
 		Usage: "Number of recent blocks to check for gas prices (deprecated, use --gpo.blocks)",
 		Value: eth.DefaultConfig.GPO.Blocks,
 	}
-	LegacyGpoPercentileFlag = cli.IntFlag{
+	LegacyGpoPercentileFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "gpopercentile",
 		Usage: "Suggested gas price is the given percentile of a set of recent transaction gas prices (deprecated, use --gpo.percentile)",
 		Value: eth.DefaultConfig.GPO.Percentile,
diff --git a/internal/debug/flags.go b/internal/debug/flags.go
index bffd5acb24..9e5f8d252f 100644
--- a/internal/debug/flags.go
+++ b/internal/debug/flags.go
@@ -86,26 +86,26 @@ var (
 		Name:  "trace",
 		Usage: "Write execution trace to the given file",
 	}
-	legacyPprofPortFlag = cli.IntFlag{
+	legacyPprofPortFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "pprofport",
 		Usage: "pprof HTTP server listening port (deprecated, use --pprof.port)",
 		Value: 6060,
 	}
-	legacyPprofAddrFlag = cli.StringFlag{
+	legacyPprofAddrFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "pprofaddr",
 		Usage: "pprof HTTP server listening interface (deprecated, use --pprof.addr)",
 		Value: "127.0.0.1",
 	}
-	legacyMemprofilerateFlag = cli.IntFlag{
+	legacyMemprofilerateFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "memprofilerate",
 		Usage: "Turn on memory profiling with the given rate (deprecated, use --pprof.memprofilerate)",
 		Value: runtime.MemProfileRate,
 	}
-	legacyBlockprofilerateFlag = cli.IntFlag{
+	legacyBlockprofilerateFlag = cli.IntFlag{ // (Deprecated April 2020)
 		Name:  "blockprofilerate",
 		Usage: "Turn on block profiling with the given rate (deprecated, use --pprof.blockprofilerate)",
 	}
-	legacyCpuprofileFlag = cli.StringFlag{
+	legacyCpuprofileFlag = cli.StringFlag{ // (Deprecated April 2020)
 		Name:  "cpuprofile",
 		Usage: "Write CPU profile to the given file (deprecated, use --pprof.cpuprofile)",
 	}